All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
GfRange3f Class Reference

Basic type: 3-dimensional floating point range. More...

Public Types

typedef GfVec3f MinMaxType
 Helper typedef. More...
 
typedef GfVec3f::ScalarType ScalarType
 

Public Member Functions

void SetEmpty ()
 Sets the range to an empty interval. More...
 
 GfRange3f ()
 The default constructor creates an empty range. More...
 
 GfRange3f (const GfVec3f &min, const GfVec3f &max)
 This constructor initializes the minimum and maximum points. More...
 
const GfVec3fGetMin () const
 Returns the minimum value of the range. More...
 
const GfVec3fGetMax () const
 Returns the maximum value of the range. More...
 
GfVec3f GetSize () const
 Returns the size of the range. More...
 
GfVec3f GetMidpoint () const
 Returns the midpoint of the range, that is, 0.5*(min+max). More...
 
void SetMin (const GfVec3f &min)
 Sets the minimum value of the range. More...
 
void SetMax (const GfVec3f &max)
 Sets the maximum value of the range. More...
 
bool IsEmpty () const
 Returns whether the range is empty (max < min). More...
 
void ExtendBy (const GfVec3f &point)
 Modifies the range if necessary to surround the given value. More...
 
void ExtendBy (const GfRange3f &range)
 Modifies the range if necessary to surround the given range. More...
 
bool Contains (const GfVec3f &point) const
 Returns true if the point is located inside the range. More...
 
bool Contains (const GfRange3f &range) const
 Returns true if the range is located entirely inside the range. More...
 
bool IsInside (const GfVec3f &point) const
 Returns true if the point is located inside the range. More...
 
bool IsInside (const GfRange3f &range) const
 Returns true if the range is located entirely inside the range. More...
 
bool IsOutside (const GfRange3f &range) const
 Returns true if the range is located entirely outside the range. More...
 
const GfRange3fUnionWith (const GfRange3f &b)
 Extend this to include b. More...
 
const GfRange3fUnionWith (const GfVec3f &b)
 Extend this to include b. More...
 
const GfRange3fUnion (const GfRange3f &b)
 Extend this to include b. More...
 
const GfRange3fUnion (const GfVec3f &b)
 Extend this to include b. More...
 
const GfRange3fIntersectWith (const GfRange3f &b)
 Modifies this range to hold its intersection with b and returns the result. More...
 
const GfRange3fIntersection (const GfRange3f &b)
 Modifies this range to hold its intersection with b and returns the result. More...
 
GfRange3f operator+= (const GfRange3f &b)
 unary sum. More...
 
GfRange3f operator-= (const GfRange3f &b)
 unary difference. More...
 
GfRange3f operator*= (double m)
 unary multiply. More...
 
GfRange3f operator/= (double m)
 unary division. More...
 
GfRange3f operator+ (const GfRange3f &b) const
 binary sum. More...
 
GfRange3f operator- (const GfRange3f &b) const
 binary difference. More...
 
bool operator== (const GfRange3f &b) const
 The min and max points must match exactly for equality. More...
 
bool operator!= (const GfRange3f &b) const
 
GF_API bool operator== (const GfRange3d &other) const
 Compare this range to a GfRange3d. More...
 
GF_API bool operator!= (const GfRange3d &other) const
 
GF_API double GetDistanceSquared (const GfVec3f &p) const
 Compute the squared distance from a point to the range. More...
 
GF_API GfVec3f GetCorner (size_t i) const
 Returns the ith corner of the range, in the following order: LDB, RDB, LUB, RUB, LDF, RDF, LUF, RUF. More...
 
GF_API GfRange3f GetOctant (size_t i) const
 Returns the ith octant of the range, in the following order: LDB, RDB, LUB, RUB, LDF, RDF, LUF, RUF. More...
 

Static Public Member Functions

static GfRange3f GetUnion (const GfRange3f &a, const GfRange3f &b)
 Returns the smallest GfRange3f which contains both a and b. More...
 
static GfRange3f Union (const GfRange3f &a, const GfRange3f &b)
 Returns the smallest GfRange3f which contains both a and b. More...
 
static GfRange3f GetIntersection (const GfRange3f &a, const GfRange3f &b)
 Returns a GfRange3f that describes the intersection of a and b. More...
 
static GfRange3f Intersection (const GfRange3f &a, const GfRange3f &b)
 Returns a GfRange3f that describes the intersection of a and b. More...
 

Static Public Attributes

static const size_t dimension = GfVec3f::dimension
 
static GF_API const GfRange3f UnitCube
 The unit cube. More...
 

Friends

GfRange3f operator* (double m, const GfRange3f &r)
 scalar multiply. More...
 
GfRange3f operator* (const GfRange3f &r, double m)
 scalar multiply. More...
 
GfRange3f operator/ (const GfRange3f &r, double m)
 scalar divide. More...
 
size_t hash_value (const GfRange3f &r)
 hash. More...
 

Detailed Description

Basic type: 3-dimensional floating point range.

This class represents a 3-dimensional range (or interval) All operations are component-wise and conform to interval mathematics. An empty range is one where max < min. The default empty is [FLT_MAX,-FLT_MAX]

Definition at line 64 of file range3f.h.

Member Typedef Documentation

Helper typedef.

Definition at line 69 of file range3f.h.

Constructor & Destructor Documentation

GfRange3f ( )
inline

The default constructor creates an empty range.

Definition at line 82 of file range3f.h.

GfRange3f ( const GfVec3f min,
const GfVec3f max 
)
inline

This constructor initializes the minimum and maximum points.

Definition at line 87 of file range3f.h.

Member Function Documentation

bool Contains ( const GfVec3f point) const
inline

Returns true if the point is located inside the range.

As with all operations of this type, the range is assumed to include its extrema.

Definition at line 130 of file range3f.h.

bool Contains ( const GfRange3f range) const
inline

Returns true if the range is located entirely inside the range.

As with all operations of this type, the ranges are assumed to include their extrema.

Definition at line 139 of file range3f.h.

void ExtendBy ( const GfVec3f point)
inline

Modifies the range if necessary to surround the given value.

Deprecated:
Use UnionWith() instead.

Definition at line 122 of file range3f.h.

void ExtendBy ( const GfRange3f range)
inline

Modifies the range if necessary to surround the given range.

Deprecated:
Use UnionWith() instead.

Definition at line 126 of file range3f.h.

GF_API GfVec3f GetCorner ( size_t  i) const

Returns the ith corner of the range, in the following order: LDB, RDB, LUB, RUB, LDF, RDF, LUF, RUF.

Where L/R is left/right, D/U is down/up, and B/F is back/front.

GF_API double GetDistanceSquared ( const GfVec3f p) const

Compute the squared distance from a point to the range.

static GfRange3f GetIntersection ( const GfRange3f a,
const GfRange3f b 
)
inlinestatic

Returns a GfRange3f that describes the intersection of a and b.

Definition at line 208 of file range3f.h.

const GfVec3f& GetMax ( ) const
inline

Returns the maximum value of the range.

Definition at line 96 of file range3f.h.

GfVec3f GetMidpoint ( ) const
inline

Returns the midpoint of the range, that is, 0.5*(min+max).

Note: this returns zero in the case of default-constructed ranges, or ranges set via SetEmpty().

Definition at line 104 of file range3f.h.

const GfVec3f& GetMin ( ) const
inline

Returns the minimum value of the range.

Definition at line 93 of file range3f.h.

GF_API GfRange3f GetOctant ( size_t  i) const

Returns the ith octant of the range, in the following order: LDB, RDB, LUB, RUB, LDF, RDF, LUF, RUF.

Where L/R is left/right, D/U is down/up, and B/F is back/front.

GfVec3f GetSize ( ) const
inline

Returns the size of the range.

Definition at line 99 of file range3f.h.

static GfRange3f GetUnion ( const GfRange3f a,
const GfRange3f b 
)
inlinestatic

Returns the smallest GfRange3f which contains both a and b.

Definition at line 168 of file range3f.h.

static GfRange3f Intersection ( const GfRange3f a,
const GfRange3f b 
)
inlinestatic

Returns a GfRange3f that describes the intersection of a and b.

Deprecated:
Use GetIntersection() instead.

Definition at line 217 of file range3f.h.

const GfRange3f& Intersection ( const GfRange3f b)
inline

Modifies this range to hold its intersection with b and returns the result.

Deprecated:
Use IntersectWith() instead.

Definition at line 232 of file range3f.h.

const GfRange3f& IntersectWith ( const GfRange3f b)
inline

Modifies this range to hold its intersection with b and returns the result.

Definition at line 223 of file range3f.h.

bool IsEmpty ( ) const
inline

Returns whether the range is empty (max < min).

Definition at line 116 of file range3f.h.

bool IsInside ( const GfVec3f point) const
inline

Returns true if the point is located inside the range.

As with all operations of this type, the range is assumed to include its extrema.

Deprecated:
Use Contains() instead.

Definition at line 146 of file range3f.h.

bool IsInside ( const GfRange3f range) const
inline

Returns true if the range is located entirely inside the range.

As with all operations of this type, the ranges are assumed to include their extrema.

Deprecated:
Use Contains() instead.

Definition at line 154 of file range3f.h.

bool IsOutside ( const GfRange3f range) const
inline

Returns true if the range is located entirely outside the range.

As with all operations of this type, the ranges are assumed to include their extrema.

Definition at line 161 of file range3f.h.

GfRange3f operator*= ( double  m)
inline

unary multiply.

Definition at line 251 of file range3f.h.

GfRange3f operator+ ( const GfRange3f b) const
inline

binary sum.

Definition at line 269 of file range3f.h.

GfRange3f operator+= ( const GfRange3f b)
inline

unary sum.

Definition at line 237 of file range3f.h.

GfRange3f operator- ( const GfRange3f b) const
inline

binary difference.

Definition at line 275 of file range3f.h.

GfRange3f operator-= ( const GfRange3f b)
inline

unary difference.

Definition at line 244 of file range3f.h.

GfRange3f operator/= ( double  m)
inline

unary division.

Definition at line 264 of file range3f.h.

bool operator== ( const GfRange3f b) const
inline

The min and max points must match exactly for equality.

Definition at line 307 of file range3f.h.

bool operator== ( const GfRange3d other) const
inline

Compare this range to a GfRange3d.

The values must match exactly and it does exactly what you might expect when comparing float and double values.

Definition at line 370 of file range3f.h.

void SetEmpty ( )
inline

Sets the range to an empty interval.

Definition at line 76 of file range3f.h.

void SetMax ( const GfVec3f max)
inline

Sets the maximum value of the range.

Definition at line 113 of file range3f.h.

void SetMin ( const GfVec3f min)
inline

Sets the minimum value of the range.

Definition at line 110 of file range3f.h.

static GfRange3f Union ( const GfRange3f a,
const GfRange3f b 
)
inlinestatic

Returns the smallest GfRange3f which contains both a and b.

Deprecated:
Use GetUnion() instead.

Definition at line 191 of file range3f.h.

const GfRange3f& Union ( const GfRange3f b)
inline

Extend this to include b.

Deprecated:
Use UnionWith() instead.

Definition at line 197 of file range3f.h.

const GfRange3f& Union ( const GfVec3f b)
inline

Extend this to include b.

Deprecated:
Use UnionWith() instead.

Definition at line 203 of file range3f.h.

const GfRange3f& UnionWith ( const GfRange3f b)
inline

Extend this to include b.

Definition at line 176 of file range3f.h.

const GfRange3f& UnionWith ( const GfVec3f b)
inline

Extend this to include b.

Definition at line 183 of file range3f.h.

Friends And Related Function Documentation

size_t hash_value ( const GfRange3f r)
friend

hash.

Definition at line 299 of file range3f.h.

GfRange3f operator* ( double  m,
const GfRange3f r 
)
friend

scalar multiply.

Definition at line 280 of file range3f.h.

GfRange3f operator* ( const GfRange3f r,
double  m 
)
friend

scalar multiply.

Definition at line 287 of file range3f.h.

GfRange3f operator/ ( const GfRange3f r,
double  m 
)
friend

scalar divide.

Definition at line 294 of file range3f.h.

Member Data Documentation

GF_API const GfRange3f UnitCube
static

The unit cube.

Definition at line 340 of file range3f.h.


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