Main Page | Modules | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members | Related Pages | Search for 

DRECT2D Struct Reference

2D rectangle using 'double' precision coordinates. More...

#include <rect.h>

Inheritance diagram for DRECT2D:

Inheritance graph
[legend]
List of all members.

Public Member Functions

 DRECT2D ()
 DRECT2D (const FPOINT2D &pt)
 DRECT2D (const DPOINT2D &pt)
 DRECT2D (double xi, double yi, double xl, double yl)
 DRECT2D (const LRECT2D &rect)
DRECT2D & operator= (const DPOINT2D &pt)
DRECT2D & operator= (const LRECT2D &rhs)
void ClipTo (const DRECT2D &rect)
bool ComputeEdgePoint (const DPOINT2D &OutsidePt, DPOINT2D &EdgePt) const
bool Contains (double x, double y) const
bool Contains (const DPOINT2D &pt) const
bool Contains (const DRECT2D &rhs) const
void Expand (const double value)
void Expand (const double xval, const double yval)
void Extend (const double xval, const double yval)
void Extend (const DRECT2D &rect)
void Extend (const DPOINT2D &pt)
double GetArea () const
void GetBottomLeft (DPOINT2D &ret) const
void GetBottomRight (DPOINT2D &ret) const
DPOINT2D GetCenter () const
void GetCenter (DPOINT2D &ret) const
void GetCorners (DPOINT2D *corners, bool ClosePoly=false, bool OrientCCW=false) const
void GetCorners (DPOINT3D *corners, bool ClosePoly=false, bool OrientCCW=false) const
int GetDimension () const
double GetDistance (const DRECT2D &rect) const
double GetHeight () const
double GetMaxDistance (const DRECT2D &rect) const
double GetMaxDistanceSquared (const DRECT2D &rect) const
void GetRect (LRECT2D &rect) const
void GetSize (DPOINT2D &ret) const
void GetTopLeft (DPOINT2D &ret) const
void GetTopRight (DPOINT2D &ret) const
double GetWidth () const
bool IniRead (INIHANDLE IniHandle, const char *IniGroup, const char *IniName)
bool IniRead (INIHANDLE IniHandle, const char *IniGroup, const char *IniName, const DRECT2D &dft)
void IniWrite (INIHANDLE IniHandle, const char *IniGroup, const char *IniName) const
void Intersect (const DRECT2D &rect)
bool IsEquivalentTo (const DRECT2D &rhs, double threshold=0.0) const
bool IsValid () const
void Limit (DPOINT2D &point) const
bool Overlaps (const DRECT2D &rhs) const
void Set (double x1, double y1, double x2, double y2)
void SetInvalid ()
void SwapBytes ()
 CHECKSIZE (32)

Public Attributes

double xinit
double yinit
double xlast
double ylast

Detailed Description

2D rectangle using 'double' precision coordinates.

Definition at line 423 of file rect.h.

Constructor & Destructor Documentation

DRECT2D::DRECT2D (   )  [inline]
 

Default constructor, initialize to "invalid" area.

Definition at line 431 of file rect.h.

DRECT2D::DRECT2D (  const FPOINT2D &  pt  )  [inline]
 

Construct from FPOINT2D (or FPOINT3D).

Definition at line 436 of file rect.h.

DRECT2D::DRECT2D (  const DPOINT2D &  pt  )  [inline]
 

Construct from DPOINT2D (or DPOINT3D).

Definition at line 441 of file rect.h.

DRECT2D::DRECT2D (  double  xi,
double  yi,
double  xl,
double  yl
)  [inline]
 

Definition at line 445 of file rect.h.

DRECT2D::DRECT2D (  const LRECT2D &  rect  )  [inline]
 

Implicit conversion from LRECT2D.

Definition at line 453 of file rect.h.

Member Function Documentation

DRECT2D::CHECKSIZE (  32   ) 
 

Make compiler validate structure size.

void DRECT2D::ClipTo (  const DRECT2D &  rect  )  [inline]
 

Clip this rectangle to specified rectangle.

Definition at line 468 of file rect.h.

bool DRECT2D::ComputeEdgePoint (  const DPOINT2D &  OutsidePt,
DPOINT2D &  EdgePt
)  const
 

Given the center point of the DRECT2D and the 'TestPt' which is outside the box, compute the point on the edge of the box which falls between the center point and the 'TestPt'.

Returns:
'true' if the point is found, false if the 'TestPt' is inside the box or the box is invalid
Parameters:
OutsidePt  Point outside of 'this'
EdgePt  Point on the rectangle edge RETURNED if 'true' returned, center of the box if 'false' is returned

bool DRECT2D::Contains (  const DRECT2D &  rhs  )  const [inline]
 

Check if contains specified point.

Definition at line 499 of file rect.h.

bool DRECT2D::Contains (  const DPOINT2D &  pt  )  const [inline]
 

Check if contains specified point.

Definition at line 494 of file rect.h.

bool DRECT2D::Contains (  double  x,
double  y
)  const [inline]
 

Check if contains specified point.

Definition at line 488 of file rect.h.

void DRECT2D::Expand (  const double  xval,
const double  yval
)  [inline]
 

Expand the rectangle by 'value' amount.

Reimplemented in DRECT3D.

Definition at line 509 of file rect.h.

void DRECT2D::Expand (  const double  value  )  [inline]
 

Expand the rectangle by 'value' amount.

Reimplemented in DRECT3D.

Definition at line 504 of file rect.h.

void DRECT2D::Extend (  const DPOINT2D &  pt  )  [inline]
 

Extend rectangle to include specified DPOINT2D point.

Reimplemented in DRECT3D.

Definition at line 538 of file rect.h.

void DRECT2D::Extend (  const DRECT2D &  rect  )  [inline]
 

Extend rectangle to encompass both rectangles.

Definition at line 527 of file rect.h.

void DRECT2D::Extend (  const double  xval,
const double  yval
)  [inline]
 

Extend rectangle to include specified X,Y point.

Reimplemented in DRECT3D.

Definition at line 515 of file rect.h.

double DRECT2D::GetArea (   )  const [inline]
 

Compute area of rectangle.

Definition at line 549 of file rect.h.

void DRECT2D::GetBottomLeft (  DPOINT2D &  ret  )  const [inline]
 

Return bottom left point of rectangle.

Definition at line 553 of file rect.h.

void DRECT2D::GetBottomRight (  DPOINT2D &  ret  )  const [inline]
 

Return bottom right point of rectangle.

Definition at line 558 of file rect.h.

void DRECT2D::GetCenter (  DPOINT2D &  ret  )  const [inline]
 

Return center point of rectangle.

Definition at line 567 of file rect.h.

DPOINT2D DRECT2D::GetCenter (   )  const [inline]
 

Return center point of rectangle.

Reimplemented in DRECT3D.

Definition at line 563 of file rect.h.

void DRECT2D::GetCorners (  DPOINT3D *  corners,
bool  ClosePoly = false,
bool  OrientCCW = false
)  const
 

Get corners as array.

Parameters:
corners  Array of points to fill in
ClosePoly  Return "closed" polygon, corners[4] = corners[0]
OrientCCW  Orient points in counterclockwise order for right-hand cartesian

void DRECT2D::GetCorners (  DPOINT2D *  corners,
bool  ClosePoly = false,
bool  OrientCCW = false
)  const
 

Get corners as array.

Parameters:
corners  Array of points to fill in
ClosePoly  Return "closed" polygon, corners[4] = corners[0]
OrientCCW  Orient points in counterclockwise order for right-hand cartesian

int DRECT2D::GetDimension (   )  const [inline]
 

Compute number of non zero dimensions (0, 1, or 2).

Reimplemented in DRECT3D.

Definition at line 586 of file rect.h.

double DRECT2D::GetDistance (  const DRECT2D &  rect  )  const
 

Compute the distance between two disjoint rectangles.

Returns:
Distance between two disjoint rectangles, 0.0 if they overlap.

double DRECT2D::GetHeight (   )  const [inline]
 

Return height of rectangle.

Definition at line 601 of file rect.h.

double DRECT2D::GetMaxDistance (  const DRECT2D &  rect  )  const
 

Compute the maximum distance between two rectangles Uses Extend() and then computes the diagonal distance.

Returns:
Max distance between two rectangles

double DRECT2D::GetMaxDistanceSquared (  const DRECT2D &  rect  )  const
 

Compute the maximum distance between two rectangles Uses Extend() and then computes the diagonal distance.

Returns:
Max distance between two rectangles

void DRECT2D::GetRect (  LRECT2D &  rect  )  const [inline]
 

Get the rectangle as an LRECT2D (with rounding).

Definition at line 619 of file rect.h.

void DRECT2D::GetSize (  DPOINT2D &  ret  )  const [inline]
 

Get size of rectangle.

Definition at line 630 of file rect.h.

void DRECT2D::GetTopLeft (  DPOINT2D &  ret  )  const [inline]
 

Return top left point of rectangle.

Definition at line 635 of file rect.h.

void DRECT2D::GetTopRight (  DPOINT2D &  ret  )  const [inline]
 

Return top right point of rectangle.

Definition at line 640 of file rect.h.

double DRECT2D::GetWidth (   )  const [inline]
 

Return width of rectangle.

Definition at line 645 of file rect.h.

bool DRECT2D::IniRead (  INIHANDLE  IniHandle,
const char *  IniGroup,
const char *  IniName,
const DRECT2D &  dft
)  [inline]
 

Read rectangle from INI file with default.

Definition at line 656 of file rect.h.

bool DRECT2D::IniRead (  INIHANDLE  IniHandle,
const char *  IniGroup,
const char *  IniName
)  [inline]
 

Read rectangle from INI file.

Reimplemented in DRECT3D.

Definition at line 649 of file rect.h.

void DRECT2D::IniWrite (  INIHANDLE  IniHandle,
const char *  IniGroup,
const char *  IniName
)  const [inline]
 

Read rectangle from INI file.

Reimplemented in DRECT3D.

Definition at line 664 of file rect.h.

void DRECT2D::Intersect (  const DRECT2D &  rect  )  [inline]
 

Intersect two DRECT2D's, may result in an invalid rectangle.

Definition at line 671 of file rect.h.

bool DRECT2D::IsEquivalentTo (  const DRECT2D &  rhs,
double  threshold = 0.0
)  const
 

Determine if the two rectangles are equivalent This method uses "Fuzzy" edge comparisons Specify a different threshold to allow greater distances.

Returns:
'True' if they are, 'False' if not
Parameters:
threshold  Default threshold is max absolute value of rectangle coordinate * 1.0E-13

bool DRECT2D::IsValid (   )  const [inline]
 

Check if rectangle is valid.

Reimplemented in DRECT3D.

Definition at line 696 of file rect.h.

void DRECT2D::Limit (  DPOINT2D &  point  )  const [inline]
 

Limit point to extents specified by rectangle.

Definition at line 700 of file rect.h.

DRECT2D& DRECT2D::operator= (  const LRECT2D &  rhs  )  [inline]
 

Assignment from LRECT2D.

Definition at line 463 of file rect.h.

DRECT2D& DRECT2D::operator= (  const DPOINT2D &  pt  )  [inline]
 

Assignment from DPOINT2D.

Definition at line 458 of file rect.h.

bool DRECT2D::Overlaps (  const DRECT2D &  rhs  )  const [inline]
 

Check if rectangle overlaps.

Definition at line 709 of file rect.h.

void DRECT2D::Set (  double  x1,
double  y1,
double  x2,
double  y2
)  [inline]
 

Set given (x1,y1), (x2,y2).

Reimplemented in DRECT3D.

Definition at line 714 of file rect.h.

void DRECT2D::SetInvalid (   )  [inline]
 

Sets the initial values to the maximum possible and the final values to the minimum possible, thus making the rectangle "invalid".

Setting a rectangle to invalid means that no point will be in it. It also makes it easy to compute the min/max of a bunch of points. You just iterate through all the points and Extend() the rectangle. Normally, you'd have to handle the first point specially.

Reimplemented in DRECT3D.

Definition at line 725 of file rect.h.

void DRECT2D::SwapBytes (   )  [inline]
 

Perform byte-order swapping.

Reimplemented in DRECT3D.

Definition at line 729 of file rect.h.

Member Data Documentation

double DRECT2D::xinit
 

Minimum X coordinate (inclusive).

Definition at line 425 of file rect.h.

double DRECT2D::xlast
 

Maximum X coordinate (inclusive).

Definition at line 427 of file rect.h.

double DRECT2D::yinit
 

Minimum Y coordinate (inclusive).

Definition at line 426 of file rect.h.

double DRECT2D::ylast
 

Maximum Y coordinate (inclusive).

Definition at line 428 of file rect.h.

The documentation for this struct was generated from the following file:
Generated on Thu Aug 12 06:26:17 2004 for TNTsdk by doxygen 1.3.4-20031026