#include <GHOST_Rect.hh>

Public Member Functions
	GHOST_Rect (int32_t l=0, int32_t t=0, int32_t r=0, int32_t b=0)

virtual	~GHOST_Rect ()

virtual int32_t	getWidth () const

virtual int32_t	getHeight () const

virtual void	set (int32_t l, int32_t t, int32_t r, int32_t b)

virtual bool	isEmpty () const

virtual bool	isValid () const

virtual void	inset (int32_t i)

virtual void	unionRect (const GHOST_Rect &r)

virtual void	unionPoint (int32_t x, int32_t y)

virtual void	wrapPoint (int32_t &x, int32_t &y, int32_t ofs, GHOST_TAxisFlag axis)

virtual void	clampPoint (int32_t &x, int32_t &y)

virtual bool	isInside (int32_t x, int32_t y) const

virtual GHOST_TVisibility	getVisibility (GHOST_Rect &r) const

virtual void	setCenter (int32_t cx, int32_t cy)

virtual void	setCenter (int32_t cx, int32_t cy, int32_t w, int32_t h)

virtual bool	clip (GHOST_Rect &r) const

Public Attributes
int32_t	m_l

int32_t	m_t

int32_t	m_r

int32_t	m_b

Detailed Description

Implements rectangle functionality. The four extreme coordinates are stored as left, top, right and bottom. To be valid, a rectangle should have a left coordinate smaller than or equal to right. To be valid, a rectangle should have a top coordinate smaller than or equal to bottom.

Definition at line 20 of file GHOST_Rect.hh.

Constructor & Destructor Documentation

◆ GHOST_Rect()

GHOST_Rect::GHOST_Rect	(	int32_t	l = 0,
		int32_t	t = 0,
		int32_t	r = 0,
		int32_t	b = 0 )

inline

Constructs a rectangle with the given values.

Parameters

l	requested left coordinate of the rectangle.
t	requested top coordinate of the rectangle.
r	requested right coordinate of the rectangle.
b	requested bottom coordinate of the rectangle.

Definition at line 29 of file GHOST_Rect.hh.

◆ ~GHOST_Rect()

virtual GHOST_Rect::~GHOST_Rect ( )

inlinevirtual

Destructor.

Definition at line 37 of file GHOST_Rect.hh.

Member Function Documentation

◆ clampPoint()

void GHOST_Rect::clampPoint	(	int32_t &	x,
		int32_t &	y )

inlinevirtual

Confine x & y within the rectangle (inclusive).

Parameters

x	The x-coordinate of the point.
y	The y-coordinate of the point.

Definition at line 255 of file GHOST_Rect.hh.

References m_b, m_l, m_r, and m_t.

◆ clip()

bool GHOST_Rect::clip ( GHOST_Rect & r ) const

virtual

Clips a rectangle. Updates the rectangle given such that it will fit within this one. This can result in an empty rectangle.

Parameters

r	the rectangle to clip.

Returns: whether clipping has occurred

Definition at line 92 of file GHOST_Rect.cc.

References m_b, m_l, m_r, and m_t.

◆ getHeight()

int32_t GHOST_Rect::getHeight ( ) const

inlinevirtual

Access to rectangle height.

Returns: height of the rectangle.

Definition at line 172 of file GHOST_Rect.hh.

References m_b, and m_t.

Referenced by GHOST_WindowCocoa::clientToScreen(), inset(), isEmpty(), GHOST_WindowCocoa::screenToClient(), GHOST_WindowCocoa::setClientHeight(), GHOST_WindowWin32::setClientHeight(), GHOST_WindowCocoa::setClientSize(), GHOST_WindowWin32::setClientSize(), GHOST_WindowCocoa::setClientWidth(), GHOST_WindowWin32::setClientWidth(), View(), and wrapPoint().

◆ getVisibility()

GHOST_TVisibility GHOST_Rect::getVisibility ( GHOST_Rect & r ) const

virtual

Returns whether the rectangle is inside this rectangle.

Parameters

r	rectangle to test.

Returns: visibility (not, partially or fully visible).

Definition at line 42 of file GHOST_Rect.cc.

References GHOST_kFullyVisible, GHOST_kNotVisible, GHOST_kPartiallyVisible, isInside(), m_b, m_l, m_r, m_t, and v.

◆ getWidth()

int32_t GHOST_Rect::getWidth ( ) const

inlinevirtual

Access to rectangle width.

Returns: width of the rectangle.

Definition at line 167 of file GHOST_Rect.hh.

References m_l, and m_r.

Referenced by inset(), isEmpty(), GHOST_WindowCocoa::setClientHeight(), GHOST_WindowWin32::setClientHeight(), GHOST_WindowCocoa::setClientSize(), GHOST_WindowWin32::setClientSize(), GHOST_WindowCocoa::setClientWidth(), GHOST_WindowWin32::setClientWidth(), GHOST_WindowCocoa::setNativePixelSize(), View(), and wrapPoint().

◆ inset()

void GHOST_Rect::inset ( int32_t i )

virtual

Grows (or shrinks the rectangle). The method avoids negative insets making the rectangle invalid

Parameters

i	The amount of offset given to each extreme (negative values shrink the rectangle).

Definition at line 11 of file GHOST_Rect.cc.

References getHeight(), getWidth(), m_b, m_l, m_r, and m_t.

◆ isEmpty()

bool GHOST_Rect::isEmpty ( ) const

inlinevirtual

Returns whether this rectangle is empty. Empty rectangles are rectangles that have width==0 and/or height==0.

Returns: boolean value (true==empty rectangle)

Definition at line 185 of file GHOST_Rect.hh.

References getHeight(), and getWidth().

◆ isInside()

bool GHOST_Rect::isInside	(	int32_t	x,
		int32_t	y ) const

inlinevirtual

Returns whether the point is inside this rectangle. Point on the boundary is considered inside.

Parameters

x	x-coordinate of point to test.
y	y-coordinate of point to test.

Returns: boolean value (true if point is inside).

Definition at line 272 of file GHOST_Rect.hh.

References m_b, m_l, m_r, and m_t.

Referenced by getVisibility(), and GHOST_WindowWin32::loadWintab().

◆ isValid()

bool GHOST_Rect::isValid ( ) const

inlinevirtual

Returns whether this rectangle is valid. Valid rectangles are rectangles that have m_l <= m_r and m_t <= m_b. Thus, empty rectangles are valid.

Returns: boolean value (true==valid rectangle)

Definition at line 190 of file GHOST_Rect.hh.

References m_b, m_l, m_r, and m_t.

◆ set()

void GHOST_Rect::set	(	int32_t	l,
		int32_t	t,
		int32_t	r,
		int32_t	b )

inlinevirtual

Sets all members of the rectangle.

Parameters

l	requested left coordinate of the rectangle.
t	requested top coordinate of the rectangle.
r	requested right coordinate of the rectangle.
b	requested bottom coordinate of the rectangle.

Definition at line 177 of file GHOST_Rect.hh.

References b, l, m_b, m_l, m_r, and m_t.

◆ setCenter() [1/2]

void GHOST_Rect::setCenter	(	int32_t	cx,
		int32_t	cy )

virtual

Sets rectangle members. Sets rectangle members such that it is centered at the given location.

Parameters

cx	requested center x-coordinate of the rectangle.
cy	requested center y-coordinate of the rectangle.

Definition at line 70 of file GHOST_Rect.cc.

References m_b, m_l, m_r, and m_t.

◆ setCenter() [2/2]

void GHOST_Rect::setCenter	(	int32_t	cx,
		int32_t	cy,
		int32_t	w,
		int32_t	h )

virtual

Sets rectangle members. Sets rectangle members such that it is centered at the given location, with the width requested.

Parameters

cx	requested center x-coordinate of the rectangle.
cy	requested center y-coordinate of the rectangle.
w	requested width of the rectangle.
h	requested height of the rectangle.

Definition at line 80 of file GHOST_Rect.cc.

References m_b, m_l, m_r, m_t, and w().

◆ unionPoint()

void GHOST_Rect::unionPoint	(	int32_t	x,
		int32_t	y )

inlinevirtual

Grows the rectangle to included a point.

Parameters

x	The x-coordinate of the point.
y	The y-coordinate of the point.

Definition at line 211 of file GHOST_Rect.hh.

References m_b, m_l, m_r, m_t, x, and y.

◆ unionRect()

void GHOST_Rect::unionRect ( const GHOST_Rect & r )

inlinevirtual

Does a union of the rectangle given and this rectangle. The result is stored in this rectangle.

Parameters

r	The rectangle that is input for the union operation.

Definition at line 195 of file GHOST_Rect.hh.

References m_b, m_l, m_r, and m_t.

◆ wrapPoint()

void GHOST_Rect::wrapPoint	(	int32_t &	x,
		int32_t &	y,
		int32_t	ofs,
		GHOST_TAxisFlag	axis )

inlinevirtual

Grows the rectangle to included a point.

Parameters

x	The x-coordinate of the point.
y	The y-coordinate of the point.

Definition at line 227 of file GHOST_Rect.hh.

References getHeight(), getWidth(), GHOST_kAxisX, GHOST_kAxisY, m_b, m_l, m_r, m_t, and w().

Referenced by getCursorPositionClientRelative_impl(), GHOST_SystemCocoa::handleMouseEvent(), and GHOST_SystemWayland::window_cursor_grab_set().

Member Data Documentation

◆ m_b

int32_t GHOST_Rect::m_b

Bottom coordinate of the rectangle

Definition at line 160 of file GHOST_Rect.hh.

Referenced by clampPoint(), clip(), getCursorPositionClientRelative_impl(), getHeight(), getVisibility(), GHOST_GetCursorGrabState(), GHOST_GetRectangle(), GHOST_SystemCocoa::handleMouseEvent(), inset(), isInside(), isValid(), set(), setCenter(), setCenter(), unionPoint(), unionRect(), GHOST_SystemWayland::window_cursor_grab_set(), and wrapPoint().

◆ m_l

int32_t GHOST_Rect::m_l

Left coordinate of the rectangle

Definition at line 154 of file GHOST_Rect.hh.

Referenced by clampPoint(), clip(), getCursorPositionClientRelative_impl(), getVisibility(), getWidth(), GHOST_GetCursorGrabState(), GHOST_GetRectangle(), GHOST_SystemCocoa::handleMouseEvent(), inset(), isInside(), isValid(), set(), setCenter(), setCenter(), GHOST_Window::setCursorGrab(), GHOST_WindowCocoa::setWindowCursorGrab(), GHOST_WindowX11::setWindowCursorGrab(), unionPoint(), unionRect(), GHOST_SystemWayland::window_cursor_grab_set(), and wrapPoint().

◆ m_r

int32_t GHOST_Rect::m_r

Right coordinate of the rectangle

Definition at line 158 of file GHOST_Rect.hh.

Referenced by clampPoint(), clip(), getCursorPositionClientRelative_impl(), getVisibility(), getWidth(), GHOST_GetCursorGrabState(), GHOST_GetRectangle(), GHOST_SystemCocoa::handleMouseEvent(), inset(), isInside(), isValid(), set(), setCenter(), setCenter(), GHOST_Window::setCursorGrab(), GHOST_WindowCocoa::setWindowCursorGrab(), GHOST_WindowX11::setWindowCursorGrab(), unionPoint(), unionRect(), GHOST_SystemWayland::window_cursor_grab_set(), and wrapPoint().

◆ m_t

int32_t GHOST_Rect::m_t

Top coordinate of the rectangle

Definition at line 156 of file GHOST_Rect.hh.

Referenced by clampPoint(), clip(), getCursorPositionClientRelative_impl(), getHeight(), getVisibility(), GHOST_GetCursorGrabState(), GHOST_GetRectangle(), GHOST_SystemCocoa::handleMouseEvent(), inset(), isInside(), isValid(), set(), setCenter(), setCenter(), unionPoint(), unionRect(), GHOST_SystemWayland::window_cursor_grab_set(), and wrapPoint().

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

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ GHOST_Rect()

◆ ~GHOST_Rect()

Member Function Documentation

◆ clampPoint()

◆ clip()

◆ getHeight()

◆ getVisibility()

◆ getWidth()

◆ inset()

◆ isEmpty()

◆ isInside()

◆ isValid()

◆ set()

◆ setCenter() [1/2]

◆ setCenter() [2/2]

◆ unionPoint()

◆ unionRect()

◆ wrapPoint()

Member Data Documentation

◆ m_b

◆ m_l

◆ m_r

◆ m_t