urho3d/Source/Engine/Math/Rect.h

//
// Copyright (c) 2008-2014 the Urho3D project.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.
//

#pragma once

#include "Vector4.h"

namespace Urho3D
{

/// Two-dimensional bounding rectangle.
class URHO3D_API Rect
{
public:
    /// Construct an undefined rect.
    Rect() :
        min_(Vector2::ZERO),
        max_(Vector2::ZERO),
        defined_(false)
    {
    }
    
    /// Construct from minimum and maximum vectors.
    Rect(const Vector2& min, const Vector2& max) :
        min_(min),
        max_(max),
        defined_(true)
    {
    }
    
    /// Construct from coordinates.
    Rect(float left, float top, float right, float bottom) :
        min_(left, top),
        max_(right, bottom),
        defined_(true)
    {
    }
    
    /// Construct from a Vector4.
    Rect(const Vector4& vector) :
        min_(vector.x_, vector.y_),
        max_(vector.z_, vector.w_),
        defined_(true)
    {
    }

    /// Construct from a float array.
    Rect(const float* data) :
        min_(data[0], data[1]),
        max_(data[2], data[3]),
        defined_(true)
    {
    }
    
    /// Copy-construct from another rect.
    Rect(const Rect& rect) :
        min_(rect.min_),
        max_(rect.max_),
        defined_(rect.defined_)
    {
    }
    
    /// Assign from another rect.
    Rect& operator = (const Rect& rhs)
    {
        min_ = rhs.min_;
        max_ = rhs.max_;
        defined_ = rhs.defined_;
        return *this;
    }
    
    /// Test for equality with another rect.
    bool operator == (const Rect& rhs) const { return min_ == rhs.min_ && max_ == rhs.max_; }
    /// Test for inequality with another rect.
    bool operator != (const Rect& rhs) const { return min_ != rhs.min_ || max_ != rhs.max_; }
    
    /// Define from another rect.
    void Define(const Rect& rect)
    {
        min_ = rect.min_;
        max_ = rect.max_;
        defined_ = true;
    }
    
    /// Define from minimum and maximum vectors.
    void Define(const Vector2& min, const Vector2& max)
    {
        min_ = min;
        max_ = max;
        defined_ = true;
    }
    
    /// Define from a point.
    void Define(const Vector2& point)
    {
        min_ = max_ = point;
        defined_ = true;
    }
    
    /// Merge a point.
    void Merge(const Vector2& point)
    {
        if (!defined_)
        {
            min_ = max_ = point;
            defined_ = true;
        }
        
        if (point.x_ < min_.x_)
            min_.x_ = point.x_;
        if (point.x_ > max_.x_)
            max_.x_ = point.x_;
        if (point.y_ < min_.y_)
            min_.y_ = point.y_;
        if (point.y_ > max_.y_)
            max_.y_ = point.y_;
    }
    
    /// Merge a rect.
    void Merge(const Rect& rect)
    {
        if (!defined_)
        {
            min_ = rect.min_;
            max_ = rect.max_;
            defined_ = true;
        }
        
        if (rect.min_.x_ < min_.x_)
            min_.x_ = rect.min_.x_;
        if (rect.min_.y_ < min_.y_)
            min_.y_ = rect.min_.y_;
        if (rect.max_.x_ > max_.x_)
            max_.x_ = rect.max_.x_;
        if (rect.max_.y_ > max_.y_)
            max_.y_ = rect.max_.y_;
    }
    
    /// Clear to undefined state.
    void Clear()
    {
        min_ = Vector2::ZERO;
        max_ = Vector2::ZERO;
        defined_ = false;
    }
    
    /// Clip with another rect.
    void Clip(const Rect& rect);
    
    /// Return center.
    Vector2 Center() const { return (max_ + min_) * 0.5f; }
    /// Return size.
    Vector2 Size() const { return max_ - min_; }
    /// Return half-size.
    Vector2 HalfSize() const { return (max_ - min_) * 0.5f; }
    /// Test for equality with another rect with epsilon.
    bool Equals(const Rect& rhs) const { return min_.Equals(rhs.min_) && max_.Equals(rhs.max_); }
    
    /// Test whether a point is inside.
    Intersection IsInside(const Vector2& point) const
    {
        if (point.x_ < min_.x_ || point.y_ < min_.y_ || point.x_ > max_.x_ || point.y_ > max_.y_)
            return OUTSIDE;
        else
            return INSIDE;
    }
    
    /// Return float data.
    const void* Data() const { return &min_.x_; }
    /// Return as a vector.
    Vector4 ToVector4() const { return Vector4(min_.x_, min_.y_, max_.x_, max_.y_); }
    /// Return as string.
    String ToString() const;
    
    /// Minimum vector.
    Vector2 min_;
    /// Maximum vector.
    Vector2 max_;
    /// Defined flag.
    bool defined_;
    
    /// Rect in the range (-1, -1) - (1, 1)
    static const Rect FULL;
    /// Rect in the range (0, 0) - (1, 1)
    static const Rect POSITIVE;
    /// Zero-sized rect.
    static const Rect ZERO;
};

/// Two-dimensional bounding rectangle with integer values.
class URHO3D_API IntRect
{
public:
    /// Construct a zero rect.
    IntRect() :
        left_(0),
        top_(0),
        right_(0),
        bottom_(0)
    {
    }
    
    /// Construct from coordinates.
    IntRect(int left, int top, int right, int bottom) :
        left_(left),
        top_(top),
        right_(right),
        bottom_(bottom)
    {
    }
    
    /// Construct from an int array.
    IntRect(const int* data) :
        left_(data[0]),
        top_(data[1]),
        right_(data[2]),
        bottom_(data[3])
    {
    }

    /// Test for equality with another rect.
    bool operator == (const IntRect& rhs) const { return left_ == rhs.left_ && top_ == rhs.top_ && right_ == rhs.right_ && bottom_ == rhs.bottom_; }
    /// Test for inequality with another rect.
    bool operator != (const IntRect& rhs) const { return left_ != rhs.left_ || top_ != rhs.top_ || right_ != rhs.right_ || bottom_ != rhs.bottom_; }
    
    /// Return size.
    IntVector2 Size() const { return IntVector2(Width(), Height()); }
    /// Return width.
    int Width() const { return right_ - left_; }
    /// Return height.
    int Height() const { return bottom_ - top_; }
    
    /// Test whether a point is inside.
    Intersection IsInside(const IntVector2& point) const
    {
        if (point.x_ < left_ || point.y_ < top_ || point.x_ >= right_ || point.y_ >= bottom_)
            return OUTSIDE;
        else
            return INSIDE;
    }
    
    /// Return integer data.
    const int* Data() const { return &left_; }
    /// Return as string.
    String ToString() const;
    
    /// Left coordinate.
    int left_;
    /// Top coordinate.
    int top_;
    /// Right coordinate.
    int right_;
    /// Bottom coordinate.
    int bottom_;
    
    /// Zero-sized rect.
    static const IntRect ZERO;
};

}