rect2i.h

Go to the documentation of this file.

//
// Copyright 2016 Pixar
//
// Licensed under the Apache License, Version 2.0 (the "Apache License")
// with the following modification; you may not use this file except in
// compliance with the Apache License and the following modification to it:
// Section 6. Trademarks. is deleted and replaced with:
//
// 6. Trademarks. This License does not grant permission to use the trade
//    names, trademarks, service marks, or product names of the Licensor
//    and its affiliates, except as required to comply with Section 4(c) of
//    the License and to reproduce the content of the NOTICE file.
//
// You may obtain a copy of the Apache License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the Apache License with the above modification is
// distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the Apache License for the specific
// language governing permissions and limitations under the Apache License.
//
#ifndef GF_RECT2I_H
#define GF_RECT2I_H


#include "pxr/pxr.h"
#include "pxr/base/gf/math.h"
#include "pxr/base/gf/vec2i.h"
#include "pxr/base/gf/api.h"

#include <boost/functional/hash.hpp>

#include <iosfwd>

PXR_NAMESPACE_OPEN_SCOPE

class GfRect2i {
public:
    GfRect2i(): _lower(0,0), _higher(-1,-1)
    {
    }

    GfRect2i(const GfVec2i& topLeft, const GfVec2i& bottomRight)
        : _lower(topLeft), _higher(bottomRight)
    {
    }

    GfRect2i(const GfVec2i& topLeft, int width, int height)
        : _lower(topLeft), _higher(topLeft + GfVec2i(width-1, height-1))
    {
    }

    bool IsNull() const {
        return GetWidth() == 0 && GetHeight() == 0;
    }

    bool IsEmpty() const {
        return GetWidth() <= 0 || GetHeight() <= 0;
    }

    bool IsValid() const {
        return !IsEmpty();
    }

    GF_API
    GfRect2i GetNormalized() const;

    const GfVec2i& GetLower() const {
        return _lower;
    }

    const GfVec2i& GetHigher() const {
        return _higher;
    }

    int GetLeft() const {
        return _lower[0];
    }

    void SetLeft(int x) {
        _lower[0] = x;
    }

    int GetRight() const {
        return _higher[0];
    }

    void SetRight(int x) {
        _higher[0] = x;
    }

    int GetTop() const {
        return _lower[1];
    }

    void SetTop(int y) {
        _lower[1] = y;
    }

    int GetBottom() const {
        return _higher[1];
    }

    void SetBottom(int y) {
        _higher[1] = y;
    }

    void SetLower(const GfVec2i& lower) {
        _lower = lower;
    }

    void SetHigher(const GfVec2i& higher) {
        _higher = higher;
    }

    GfVec2i GetCenter() const {
        return (_lower + _higher) / 2;
    }

    void Translate(const GfVec2i& displacement) {
        _lower += displacement;
        _higher += displacement;
    }

    unsigned long GetArea() const {
        return (unsigned long)GetWidth() * (unsigned long)GetHeight();
    }

    GfVec2i GetSize() const {
        return GfVec2i(GetWidth(), GetHeight());
    }

    int GetWidth() const {
        return (_higher[0] - _lower[0]) + 1;
    }

    int GetHeight() const {
        return (_higher[1] - _lower[1]) + 1;
    }

    GfRect2i GetIntersection(const GfRect2i& that) const {
        if(IsEmpty())
            return *this;
        else if(that.IsEmpty())
            return that;
        else
            return GfRect2i(GfVec2i(GfMax(_lower[0], that._lower[0]),
                                    GfMax(_lower[1], that._lower[1])),
                            GfVec2i(GfMin(_higher[0], that._higher[0]),
                                    GfMin(_higher[1], that._higher[1])));
    }

    GfRect2i Intersect(const GfRect2i& that) const {
        return GetIntersection(that);
    }

    GfRect2i GetUnion(const GfRect2i& that) const {
        if(IsEmpty())
            return that;
        else if(that.IsEmpty())
            return *this;
        else
            return GfRect2i(GfVec2i(GfMin(_lower[0], that._lower[0]),
                                    GfMin(_lower[1], that._lower[1])),
                            GfVec2i(GfMax(_higher[0], that._higher[0]),
                                    GfMax(_higher[1], that._higher[1])));
    }

    GfRect2i Union(const GfRect2i& that) const {
        return GetUnion(that);
    }

    bool Contains(const GfVec2i& p) const {
        return ((p[0] >= _lower[0]) && (p[0] <= _higher[0]) &&
                (p[1] >= _lower[1]) && (p[1] <= _higher[1]));
    }

    friend inline size_t hash_value(const GfRect2i &r) {
        size_t h = 0;
        boost::hash_combine(h, r._lower);
        boost::hash_combine(h, r._higher);
        return h;
    }        

    friend bool operator==(const GfRect2i& r1, const GfRect2i& r2) {
        return r1._lower == r2._lower && r1._higher == r2._higher;
    }

    friend bool operator!=(const GfRect2i& r1, const GfRect2i& r2) {
        return !(r1 == r2);
    }

    GfRect2i operator += (const GfRect2i& that) {
        *this = GetUnion(that);
        return *this;
    }

    friend GfRect2i operator + (const GfRect2i r1, const GfRect2i& r2) {
        GfRect2i tmp(r1);
        tmp += r2;
        return tmp;
    }

private:
    GfVec2i _lower, _higher;
};

GF_API std::ostream& operator<<(std::ostream&, const GfRect2i&);

PXR_NAMESPACE_CLOSE_SCOPE

#endif