UserRect Class Reference

This class is used to represent a rectangular region. It uses a union to enable the client to access the rectangle as two UserCoords (lo and hi) or as four INT32s (lox, loy, hix, hiy). An anonymous union is used, which is a defined C++ feature and so portable. More...

#include <userrect.h>

List of all members.

Public Member Functions
	UserRect ()
	To construct an empty UserRect.
	UserRect (INT32 LowX, INT32 LowY, INT32 HighX, INT32 HighY)
	To construct a UserRect with an inclusive lower left hand corner position of (Left, Lower) and an exclusive upper right hand corner position of (Right, Upper).
	UserRect (const UserCoord &Low, UINT32 Width, UINT32 Height)
	To construct a rectangle with an inclusive lower left hand corner position of Low and a width and height as specified.
	UserRect (const UserCoord &Low, const UserCoord &High)
	To construct a rectangle with an inclusive lower left hand corner position of Low and an exclusive upper right hand corner position of High.
	UserRect (const UserRect &UserRect)
	Copy constructor.
UserRect &	operator= (const UserRect &UserRect)
	Equals operator.
INT32	Width () const
	To find the width of the UserRect.
INT32	Height () const
	To find the height of the UserRect.
UserCoord	LowCorner () const
	To find the lower left hand coordinates of the UserRect.
UserCoord	HighCorner () const
	To find the upper right hand coordinates of the UserRect.
UserCoord	Centre () const
	To find the centre of the UserRect It calculates UserCoord(lox+(width/2),loy+(height/2)).
BOOL	IsIntersectedWith (const UserRect &) const
	To check for rectangle intersection.
UserRect	Intersection (const UserRect &) const
	Compute intersection of two rectangles.
UserRect	Union (const UserRect &) const
	Compute union of two rectangles.
INT32	SplitRect (const UserRect &R, UserRect *SubRects)
	Splits a rectangle into sub-rectangles which all exclude the interecting rectangle R. The number of sub-rects generated depends on how the rectangles intersect. _______________________ ___________________ | | | | | *this A | | *this A | |_ _ _ ________ _ _ _ | |_ _ _ _ _ ________|__________ | | | | | | | | | B | R | C | | B | | | |_ _ _ |________| _ _ _ | |__________|________| R | | | | | | D Index=4 | | Index=2 | |_______________________| |___________________|.
BOOL	ContainsCoord (const UserCoord &) const
	To check for coordinate containment.
BOOL	ContainsRectCoord (const UserCoord &) const
	To check for coordinate containment. This will work for coordinates which have been extracted from other rectangles (i.e. the top right corner is considered inclusive for this operation, not exclusive).
BOOL	ContainsRect (const UserRect &) const
	To check for rectangle containment.
BOOL	IsAdjacent (const UserRect &, MILLIPOINT Fuzzy) const
	To check for adjacent rectangles.
void	MakeEmpty ()
	Make the rectangle an empty one (all coordinates are set to 0).
BOOL	IsEmpty () const
	To check for empty rectangle.
BOOL	IsValid () const
	To check for a valid rectangle.
void	Inflate (INT32 XInc, INT32 YInc)
	Inflate a rectangle by given amounts. Negative values will deflate the rectangle.
void	Inflate (INT32 XInc)
	Inflate a rectangle by given amount. Negative values will deflate the rectangle.
void	Translate (INT32 XOfs, INT32 YOfs)
	Translate a rectangle by given offset.
void	IncludePoint (const UserCoord &)
	Expand a rectangle so that it includes the given point.
INT32	operator== (const UserRect &) const
	Test for equality of two rectangles. As all invalid rectangles have the same results when used for Union/Intersection, any two invalid rectangles are considered equal.
INT32	operator!= (const UserRect &) const
	Test for inequality of two rectangles. As all invalid rectangles have the same results when used for Union/Intersection, any two invalid rectangles are considered equal.
DocRect	ToSpread (Spread *pSpread)
	Convert a UserRect to a SpreadRect (AKA DocRect).
Public Attributes
UserCoord	lo
UserCoord	hi

---

Detailed Description

This class is used to represent a rectangular region. It uses a union to enable the client to access the rectangle as two UserCoords (lo and hi) or as four INT32s (lox, loy, hix, hiy). An anonymous union is used, which is a defined C++ feature and so portable.

Author:

Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 11/5/93

The lo coordinates are inclusive, whilst the hi coordinates are exclusive. In the document space, lo.y <= hi.y and lo.x <= hi.x (the inequalities are not strict because rectangles can have zero width and/or height - such rectangles are considered perfectly valid).

The inclusivity can be explained as follows:

A point at (lo.x, lo.y) is inside the rectangle A point at (hi.x, hi.y) is outside the rectangle

Any rectangle that does not obey the inequalites lo.y <= hi.y and lo.x <= hi.x is deemed to be 'invalid'. Invalid rectangles have special properties. They will cause errors when used in some operations, but not in others. The general rule is that if the rectangle is used as an entity, then the operation will succeed (taking account of the 'invalidity' of the rectangle). If, however, the actual coordinates of the invalid rectangle must be used/changed in the operation, then an error (usually an assertion failure) will occur.

For example, using invalid rectangles in Unions and Intersections is ok, because the invalid rectangle is ignored, and the 'other' rectangle is returned as the result. This means that if both rectangles are invalid, then an invalid rectangle is returned.

Conversely, trying to use operations like Translate(), Inflate(), Width() or Height() on invalid rectangles is considered to be an error, and will cause an assertion failure.

See the individual function descriptions for more details.

Returns:

Errors: -

See also:

UserCoord

Rect

DocRect

WorkRect

OSRect

Definition at line 164 of file userrect.h.

---

Constructor & Destructor Documentation

UserRect::UserRect (   )  [inline]

To construct an empty UserRect. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: None  [INPUTS] -  [OUTPUTS] Returns: - Errors: Definition at line 408 of file userrect.h. { // An empty rectangle hi.x = hi.y = lo.x = lo.y = 0; }

UserRect::UserRect (  INT32  LowX, INT32  LowY, INT32  HighX, INT32  HighY )  [inline]

To construct a UserRect with an inclusive lower left hand corner position of (Left, Lower) and an exclusive upper right hand corner position of (Right, Upper). Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: LowX  : Lower X coord of rectangle (inclusive) [INPUTS] HighX: Higher X coord of rectangle (exclusive) LowY : Lower Y coord of rectangle (inclusive) HighY: Higher Y coord of rectangle (exclusive) -  [OUTPUTS] Returns: - Errors: An assertion failure will occur if the lower left hand coordinates are not lower than and to the left of the upper right coordinate. Definition at line 439 of file userrect.h. { // Defensive programming, detect an invalid rectangle ENSURE((LowX <= HighX) && (LowY <= HighY), "UserRect::UserRect(INT32, INT32, INT32, INT32) was\n passed invalid coordinates"); lo.x = LowX; lo.y = LowY; hi.x = HighX; hi.y = HighY; }

UserRect::UserRect (  const UserCoord &  Low, UINT32  Width, UINT32  Height )  [inline]

To construct a rectangle with an inclusive lower left hand corner position of Low and a width and height as specified. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: Low,:  UserCoordinates of the inclusive lower left hand corner. [INPUTS] Width, Height : Desired dimensions of the rectangle. -  [OUTPUTS] Returns: - Errors: None. Definition at line 504 of file userrect.h. { lo = Low; hi.x = lo.x + Width; hi.y = lo.y + Height; }

UserRect::UserRect (  const UserCoord &  Low, const UserCoord &  High )  [inline]

To construct a rectangle with an inclusive lower left hand corner position of Low and an exclusive upper right hand corner position of High. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: Low  : UserCoordinates of the lower left hand corner (inclusive) [INPUTS] High: UserCoordinates of the upper right hand corner (exclusive) -  [OUTPUTS] Returns: - Errors: An assertion failure will occur if the lower left hand coordinates are not lower than and to the left of the upper right coordinates. Definition at line 474 of file userrect.h. { // Defensive programming, detect an invalid rectangle ENSURE((Low.x <= High.x) && (Low.y <= High.y), "UserRect::UserRect(UserCoord, UserCoord) was\n passed invalid coordinates"); lo = Low; hi = High; }

UserRect::UserRect (  const UserRect &  R  )  [inline]

Copy constructor. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: R,:  The copy of the UserRect [INPUTS] -  [OUTPUTS] Returns: - Definition at line 529 of file userrect.h. { lo = R.lo; hi = R.hi; }

---

Member Function Documentation

UserCoord UserRect::Centre (   )  const [inline]

To find the centre of the UserRect It calculates UserCoord(lox+(width/2),loy+(height/2)). Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 19/5/99 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: The centre coord of this UserRect Errors: Assertion failure if the rectangle is invalid. Definition at line 677 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::Centre() was called on\nan invalid rectangle."); return UserCoord(lo.x + Width() / 2, lo.y + Height() / 2); }

BOOL UserRect::ContainsCoord (  const UserCoord &  Point  )  const [inline]

To check for coordinate containment. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the coordinate is within the rectangle, FALSE otherwise. Errors: Assertion failure if the rectangle is invalid. See also: ContainsRectCoord; ContainsRect Definition at line 735 of file userrect.h. { // Check for an an empty rectangle if (IsEmpty()) return FALSE; // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::ContainsCoord() was called on\nan invalid rectangle."); return ((Point.x >= lo.x) && (Point.x < hi.x) && (Point.y >= lo.y) && (Point.y < hi.y)); }

BOOL UserRect::ContainsRect (  const UserRect &  Rect  )  const [inline]

To check for rectangle containment. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the rectangle 'Rect' is within the rectangle, FALSE otherwise. Errors: Assertion failure if the rectangle is invalid. See also: ContainsRectCoord; ContainsCoord Definition at line 805 of file userrect.h. { // Check for an an empty rectangle if (IsEmpty()) return FALSE; // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::ContainsRect() was called on\nan invalid rectangle."); return ((Rect.lo.x >= lo.x) && (Rect.hi.x <= hi.x) && (Rect.lo.y >= lo.y) && (Rect.hi.y <= hi.y)); }

BOOL UserRect::ContainsRectCoord (  const UserCoord &  Point  )  const [inline]

To check for coordinate containment. This will work for coordinates which have been extracted from other rectangles (i.e. the top right corner is considered inclusive for this operation, not exclusive). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the coordinate is within the rectangle, FALSE otherwise. Errors: Assertion failure if the rectangle is invalid. See also: ContainsCoord; ContainsRect Definition at line 771 of file userrect.h. { // Check for an an empty rectangle if (IsEmpty()) return FALSE; // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::ContainsRectCoord() was called on\nan invalid rectangle."); return ((Point.x >= lo.x) && (Point.x <= hi.x) && (Point.y >= lo.y) && (Point.y <= hi.y)); }

INT32 UserRect::Height (   )  const [inline]

To find the height of the UserRect. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: The height of the UserRect Definition at line 599 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::Height() was called on\nan invalid rectangle."); return(hi.y - lo.y); }

UserCoord UserRect::HighCorner (   )  const [inline]

To find the upper right hand coordinates of the UserRect. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: The exclusive upper right hand coordinates of the UserRect Errors: Assertion failure if the rectangle is invalid. Definition at line 650 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::HighCorner() was called on\nan invalid rectangle."); return(hi); }

void UserRect::IncludePoint (  const UserCoord &  Point  )

Expand a rectangle so that it includes the given point. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 27/5/93 Parameters: Point  - coordinate to include into this rectangle. [INPUTS] -  [OUTPUTS] Returns: - Errors: An assertion failure if the rectangle is invalid. See also: - Definition at line 388 of file userrect.cpp. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::IncludePoint() was called on an \ninvalid rectangle."); // Extend lower corner to include point if necessary lo.x = min(lo.x, Point.x); lo.y = min(lo.y, Point.y); // Extend upper corner to include point if necessary // (remember upper corner is exclusive) hi.x = max(hi.x, (INT32)(Point.x + 1L)); hi.y = max(hi.y, (INT32)(Point.y + 1L)); }

void UserRect::Inflate (  INT32  Inc  )  [inline]

Inflate a rectangle by given amount. Negative values will deflate the rectangle. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: Inc  - the amount to inflate (or deflate) the rectangle by. [INPUTS] -  [OUTPUTS] Returns: N/A. Errors: An assertion failure if the rectangle is invalid. Definition at line 377 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::Inflate(INT32) was called on an \ninvalid rectangle."); lo.x -= Inc; lo.y -= Inc; hi.x += Inc; hi.y += Inc; }

void UserRect::Inflate (  INT32  XInc, INT32  YInc )  [inline]

Inflate a rectangle by given amounts. Negative values will deflate the rectangle. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: XInc,YInc  - the amount to inflate (or deflate) the rectangle by. [INPUTS] -  [OUTPUTS] Returns: N/A. Errors: An assertion failure if the rectangle is invalid. Definition at line 345 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::Inflate(INT32, INT32) was called on an \ninvalid rectangle."); lo.x -= XInc; lo.y -= YInc; hi.x += XInc; hi.y += YInc; }

UserRect UserRect::Intersection (  const UserRect &  R  )  const

Compute intersection of two rectangles. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: R  - the rectangle to intersect with. [INPUTS] -  [OUTPUTS] Returns: The intersection. If one of the rectangles involved is invalid, the other is returned as the result. In the case of both being invalid, one of the invalid rectangles is returned as the result. It is undefined which rectangle is returned in this case. Returns: Errors: None. Definition at line 293 of file userrect.cpp. { // Special cases for invalid rectangles... if (!IsValid()) return R; if (!R.IsValid()) return *this; // Special cases when empty rectangles if (IsEmpty()) return *this; if (R.IsEmpty()) return R; // Return the result UserRect I; I.lo.x = max(lo.x, R.lo.x); I.lo.y = max(lo.y, R.lo.y); I.hi.x = min(hi.x, R.hi.x); I.hi.y = min(hi.y, R.hi.y); return I; }

BOOL UserRect::IsAdjacent (  const UserRect &  Rect, MILLIPOINT  Fuzzy )  const

To check for adjacent rectangles. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 14/7/93 Parameters: The  Fuzzy limit in MILLIPOINTS. [INPUTS] -  [OUTPUTS] Returns: TRUE if the rectangles are adjacent within a Fuzzy limit. Errors: Definition at line 188 of file userrect.cpp. { // Check for an an empty rectangle if (IsEmpty()) return FALSE; // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::IsAdjacent() was called on\nan invalid rectangle."); #if 0 // This is the expansion of the rampant return statement below // Near top or bottom BOOL NearBot = (ABS(Rect.hi.y - lo.y)) <= Fuzzy; BOOL NearTop = (ABS(Rect.lo.y - hi.y)) <= Fuzzy; // Near left or right BOOL NearLeft = (ABS(Rect.hi.x - lo.x)) <= Fuzzy; BOOL NearRight = (ABS(Rect.lo.x - hi.x)) <= Fuzzy; // Overlaps BOOL OverLeft = (ABS(Rect.lo.x - lo.x)) <= Fuzzy; BOOL OverRight = (ABS(Rect.hi.x - hi.x)) <= Fuzzy; BOOL OverTop = (ABS(Rect.hi.y - hi.y)) <= Fuzzy; BOOL OverBot = (ABS(Rect.lo.y - lo.y)) <= Fuzzy; // Adjacent to the top or bottom? BOOL TopOrBot = (NearTop || NearBot) && OverLeft && OverRight; BOOL LeftOrRight = (NearLeft || NearRight) && OverTop && OverBot; return (TopOrBot || LeftOrRight); #endif // This is explained more carefully in the section above that is excluded from the build return (( ((ABS(Rect.lo.x - lo.x))<=Fuzzy) && ((ABS(Rect.hi.x - hi.x))<=Fuzzy) && (((ABS(Rect.hi.y - lo.y))<=Fuzzy) || ((ABS(Rect.lo.y - hi.y))<=Fuzzy)) ) || ( ((ABS(Rect.lo.y - lo.y))<=Fuzzy) && ((ABS(Rect.hi.y - hi.y))<=Fuzzy) && (((ABS(Rect.hi.x - lo.x))<=Fuzzy) || ((ABS(Rect.lo.x - hi.x))<=Fuzzy)) )); }

BOOL UserRect::IsEmpty (   )  const [inline]

To check for empty rectangle. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the rectangle is empty. Errors: Definition at line 855 of file userrect.h. { return ((lo.x == hi.x) || (lo.y == hi.y)); }

BOOL UserRect::IsIntersectedWith (  const UserRect &  R  )  const [inline]

To check for rectangle intersection. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the rectangles intersect, FALSE otherwise. Errors: Definition at line 704 of file userrect.h. { // Detect an invalid rectangle if ((!IsValid()) || (!R.IsValid())) return FALSE; return ((hi.x > R.lo.x) && (lo.x < R.hi.x) && (hi.y > R.lo.y) && (lo.y < R.hi.y)); }

BOOL UserRect::IsValid (   )  const [inline]

To check for a valid rectangle. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 9/6/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the rectangle is valid. Errors: Definition at line 879 of file userrect.h. { return ((lo.x <= hi.x) && (lo.y <= hi.y)); }

UserCoord UserRect::LowCorner (   )  const [inline]

To find the lower left hand coordinates of the UserRect. Returns: Errors: Assertion failure if the rectangle is invalid. Definition at line 624 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::LowCorner() was called on\nan invalid rectangle."); return(lo); }

void UserRect::MakeEmpty (   )  [inline]

Make the rectangle an empty one (all coordinates are set to 0). Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 03/03/94 See also: UserRect::MakeEmpty Definition at line 831 of file userrect.h. { lo.x = lo.y = hi.x = hi.y = 0; }

INT32 UserRect::operator!= (  const UserRect &  R  )  const [inline]

Test for inequality of two rectangles. As all invalid rectangles have the same results when used for Union/Intersection, any two invalid rectangles are considered equal. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: R  - the rectangle to compare against. [INPUTS] -  [OUTPUTS] Returns: TRUE if R does not describe the same rectangle as the object. Friend: UserRect Returns: Errors: None. Definition at line 315 of file userrect.h. { // Invalid rectangles are equal if ((!IsValid()) && (!R.IsValid())) return FALSE; return ((lo.x != R.lo.x) || (lo.y != R.lo.y) || (hi.x != R.hi.x) || (hi.y != R.hi.y)); }

UserRect & UserRect::operator= (  const UserRect &  UserRect  )  [inline]

Equals operator. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: UserRect,:  UserRect to copy [INPUTS] -  [OUTPUTS] Returns: Reference to this UserRect Definition at line 551 of file userrect.h. { lo = UserRect.lo; hi = UserRect.hi; return *this; }

INT32 UserRect::operator== (  const UserRect &  R  )  const [inline]

Test for equality of two rectangles. As all invalid rectangles have the same results when used for Union/Intersection, any two invalid rectangles are considered equal. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: R  - the rectangle to compare against. [INPUTS] -  [OUTPUTS] Returns: TRUE if R is describes the same rectangle as the object. Friend: UserRect Returns: Errors: None. Definition at line 280 of file userrect.h. { // Invalid rectangles are equal if ((!IsValid()) && (!R.IsValid())) return TRUE; // Could use structure compare? Would it be portable? Probably not... return ((lo.x == R.lo.x) && (lo.y == R.lo.y) && (hi.x == R.hi.x) && (hi.y == R.hi.y)); }

INT32 UserRect::SplitRect (  const UserRect &  R, UserRect *  SubRects )

Splits a rectangle into sub-rectangles which all exclude the interecting rectangle R. The number of sub-rects generated depends on how the rectangles intersect. _______________________ ___________________ | | | | | *this A | | *this A | |_ _ _ ________ _ _ _ | |_ _ _ _ _ ________|__________ | | | | | | | | | B | R | C | | B | | | |_ _ _ |________| _ _ _ | |__________|________| R | | | | | | D Index=4 | | Index=2 | |_______________________| |___________________|. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 14/7/93 Parameters: R  is the rectangle to intersect with, SubRects is an array of UserRect to fill. [INPUTS] Puts  any sub-rects into SubRects. [OUTPUTS] Returns: The number of subrectangles found. 0 for no intersection. Errors: Definition at line 346 of file userrect.cpp. { if (!this->IsIntersectedWith(R)) return 0; // No intersection INT32 Index = 0; if (R.hi.y < hi.y) SubRects[Index++] = UserRect(lo.x, R.hi.y, hi.x, hi.y); // Sub-Rect A if (R.lo.y > lo.y) SubRects[Index++] = UserRect(lo.x, lo.y, hi.x, R.lo.y); // Sub-Rect D INT32 Ry0 = max(R.lo.y, lo.y); INT32 Ry1 = min(R.hi.y, hi.y); if (R.lo.x > lo.x) SubRects[Index++] = UserRect(lo.x, Ry0, R.lo.x, Ry1); // Sub-Rect B if (R.hi.x < hi.x) SubRects[Index++] = UserRect(R.hi.x, Ry0, hi.x, Ry1); // Sub-Rect C return Index; }

DocRect UserRect::ToSpread (  Spread *  pSpread  )

Convert a UserRect to a SpreadRect (AKA DocRect). Author: Ed_Cornes (Xara Group Ltd) <camelotdev@xara.com> Date: 6/9/95 Parameters: pSpread  - [INPUTS] Returns: SpreadRect Definition at line 426 of file userrect.cpp. { return DocRect( this->lo.ToSpread(pSpread), this->hi.ToSpread(pSpread) ); }

void UserRect::Translate (  INT32  XOfs, INT32  YOfs )  [inline]

Translate a rectangle by given offset. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: (XOfs,YOfs)  - the offset to translate the rectangle by. [INPUTS] -  [OUTPUTS] Returns: N/A. Errors: An assertion failure if the rectangle is invalid. Definition at line 245 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::Translate() was called on an \ninvalid rectangle."); lo.x += XOfs; lo.y += YOfs; hi.x += XOfs; hi.y += YOfs; }

UserRect UserRect::Union (  const UserRect &  R  )  const

Compute union of two rectangles. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 17/5/93 Parameters: R  - the rectangle to join with the object. [INPUTS] -  [OUTPUTS] Returns: The simple union (bounding box). If one of the rectangles involved is invalid, the other is returned as the result. In the case of both being invalid, one of the invalid rectangles is returned as the result. It is undefined which rectangle is returned in this case. Returns: Errors: None. Definition at line 252 of file userrect.cpp. { // Special cases for invalid rectangles... if (!IsValid() || IsEmpty()) return R; if (!R.IsValid() || R.IsEmpty()) return *this; // Return the result UserRect U; U.lo.x = min(lo.x, R.lo.x); U.lo.y = min(lo.y, R.lo.y); U.hi.x = max(hi.x, R.hi.x); U.hi.y = max(hi.y, R.hi.y); return U; }

INT32 UserRect::Width (   )  const [inline]

To find the width of the UserRect. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 13/5/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: The width of the UserRect Definition at line 575 of file userrect.h. { // Detect an invalid rectangle ENSURE(IsValid(), "UserRect::Width() was called on\nan invalid rectangle."); return (hi.x - lo.x); }

---

Member Data Documentation

UserCoord UserRect::hi

Definition at line 168 of file userrect.h.

UserCoord UserRect::lo

Definition at line 168 of file userrect.h.

---

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

• Kernel/userrect.h (r1785/r751)
• Kernel/userrect.cpp (r1785/r1282)

---