cpp3ds::Rect< T > Class Template Reference

Utility class for manipulating 2D axis aligned rectangles. More...

#include <Rect.hpp>

Public Member Functions
	Rect ()
	Default constructor. More...
	Rect (T rectLeft, T rectTop, T rectWidth, T rectHeight)
	Construct the rectangle from its coordinates. More...
	Rect (const Vector2< T > &position, const Vector2< T > &size)
	Construct the rectangle from position and size. More...
template<typename U >
	Rect (const Rect< U > &rectangle)
	Construct the rectangle from another type of rectangle. More...
bool	contains (T x, T y) const
	Check if a point is inside the rectangle's area. More...
bool	contains (const Vector2< T > &point) const
	Check if a point is inside the rectangle's area. More...
bool	intersects (const Rect< T > &rectangle) const
	Check the intersection between two rectangles. More...
bool	intersects (const Rect< T > &rectangle, Rect< T > &intersection) const
	Check the intersection between two rectangles. More...

Public Attributes
T	left
	Left coordinate of the rectangle. More...
T	top
	Top coordinate of the rectangle. More...
T	width
	Width of the rectangle. More...
T	height
	Height of the rectangle. More...

Related Functions
(Note that these are not member functions.)
template<typename T >
bool	operator== (const Rect< T > &left, const Rect< T > &right)
	Overload of binary operator ==. More...
template<typename T >
bool	operator!= (const Rect< T > &left, const Rect< T > &right)
	Overload of binary operator !=. More...

Detailed Description

template<typename T>
class cpp3ds::Rect< T >

Utility class for manipulating 2D axis aligned rectangles.

A rectangle is defined by its top-left corner and its size.

It is a very simple class defined for convenience, so its member variables (left, top, width and height) are public and can be accessed directly, just like the vector classes (Vector2 and Vector3).

To keep things simple, cpp3ds::Rect doesn't define functions to emulate the properties that are not directly members (such as right, bottom, center, etc.), it rather only provides intersection functions.

cpp3ds::Rect uses the usual rules for its boundaries:

• The left and top edges are included in the rectangle's area
• The right (left + width) and bottom (top + height) edges are excluded from the rectangle's area

This means that cpp3ds::IntRect(0, 0, 1, 1) and cpp3ds::IntRect(1, 1, 1, 1) don't intersect.

cpp3ds::Rect is a template and may be used with any numeric type, but for simplicity the instanciations used by SFML are typedefed:

• cpp3ds::Rect<int> is cpp3ds::IntRect
• cpp3ds::Rect<float> is cpp3ds::FloatRect

So that you don't have to care about the template syntax.

Usage example:

// Define a rectangle, located at (0, 0) with a size of 20x5
cpp3ds::IntRect r1(0, 0, 20, 5);

// Define another rectangle, located at (4, 2) with a size of 18x10
cpp3ds::Vector2i position(4, 2);
cpp3ds::Vector2i size(18, 10);
cpp3ds::IntRect r2(position, size);

// Test intersections with the point (3, 1)
bool b1 = r1.contains(3, 1); // true
bool b2 = r2.contains(3, 1); // false

// Test the intersection between r1 and r2
cpp3ds::IntRect result;
bool b3 = r1.intersects(r2, result); // true
// result == (4, 2, 16, 3)

Definition at line 42 of file Rect.hpp.

Constructor & Destructor Documentation

template<typename T>

cpp3ds::Rect< T >::Rect

(

)

Default constructor.

Creates an empty rectangle (it is equivalent to calling Rect(0, 0, 0, 0)).

template<typename T>

cpp3ds::Rect< T >::Rect	(	T	rectLeft,
		T	rectTop,
		T	rectWidth,
		T	rectHeight
	)

Construct the rectangle from its coordinates.

Be careful, the last two parameters are the width and height, not the right and bottom coordinates!

Parameters

rectLeft	Left coordinate of the rectangle
rectTop	Top coordinate of the rectangle
rectWidth	Width of the rectangle
rectHeight	Height of the rectangle

template<typename T>

cpp3ds::Rect< T >::Rect	(	const Vector2< T > &	position,
		const Vector2< T > &	size
	)

Construct the rectangle from position and size.

Be careful, the last parameter is the size, not the bottom-right corner!

Parameters

position	Position of the top-left corner of the rectangle
size	Size of the rectangle

template<typename T>

template<typename U >

cpp3ds::Rect< T >::Rect ( const Rect< U > &  rectangle )

explicit

Construct the rectangle from another type of rectangle.

This constructor doesn't replace the copy constructor, it's called only when U != T. A call to this constructor will fail to compile if U is not convertible to T.

Parameters

rectangle

Rectangle to convert

Member Function Documentation

template<typename T>

bool cpp3ds::Rect< T >::contains	(	T	x,
		T	y
	)		const

Check if a point is inside the rectangle's area.

Parameters

x	X coordinate of the point to test
y	Y coordinate of the point to test

Returns

True if the point is inside, false otherwise

See also

intersects

template<typename T>

bool cpp3ds::Rect< T >::contains

(

const Vector2< T > &

point

)

const

Check if a point is inside the rectangle's area.

Parameters

point

Point to test

Returns

True if the point is inside, false otherwise

See also

intersects

template<typename T>

bool cpp3ds::Rect< T >::intersects

(

const Rect< T > &

rectangle

)

const

Check the intersection between two rectangles.

Parameters

rectangle

Rectangle to test

Returns

True if rectangles overlap, false otherwise

See also

contains

template<typename T>

bool cpp3ds::Rect< T >::intersects	(	const Rect< T > &	rectangle,
		Rect< T > &	intersection
	)		const

Check the intersection between two rectangles.

This overload returns the overlapped rectangle in the intersection parameter.

Parameters

rectangle	Rectangle to test
intersection	Rectangle to be filled with the intersection

Returns

True if rectangles overlap, false otherwise

See also

contains

Friends And Related Function Documentation

template<typename T >

bool operator!= ( const Rect< T > &  left, const Rect< T > &  right  )

related

Overload of binary operator !=.

This operator compares strict difference between two rectangles.

Parameters

left	Left operand (a rectangle)
right	Right operand (a rectangle)

Returns

True if left is not equal to right

template<typename T >

bool operator== ( const Rect< T > &  left, const Rect< T > &  right  )

related

Overload of binary operator ==.

This operator compares strict equality between two rectangles.

Parameters

left	Left operand (a rectangle)
right	Right operand (a rectangle)

Returns

True if left is equal to right

Member Data Documentation

template<typename T>

T cpp3ds::Rect< T >::height

Height of the rectangle.

Definition at line 154 of file Rect.hpp.

template<typename T>

T cpp3ds::Rect< T >::left

Left coordinate of the rectangle.

Definition at line 151 of file Rect.hpp.

template<typename T>

T cpp3ds::Rect< T >::top

Top coordinate of the rectangle.

Definition at line 152 of file Rect.hpp.

template<typename T>

T cpp3ds::Rect< T >::width

Width of the rectangle.

Definition at line 153 of file Rect.hpp.

---

The documentation for this class was generated from the following file:

• Rect.hpp