Class: TBoundsMaker

Declaration: BoundsMaker.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

None.

Inherited By:

None.

Purpose:

Computes an accurate, tight, 2-D bounding rectangle that encompasses all the geometries passed into its AccumulateBounds call, given a port to use as the parent port (from which it inherits attributes). This can take longer to compute than calling MGraphic::GetLooseFitBounds, but the resulting bounding rectangle is tighter and more accurate.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TBoundsMaker::TBoundsMaker

TBoundsMaker ()

Interface Category:

API.

Purpose:

Default constructor.

Calling Context:

Called by the stream-in operators when the default drawing port is used. Can also be called directly.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TBoundsMaker::~TBoundsMaker

virtual ~ TBoundsMaker ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TBoundsMaker::AccumulateBounds

virtual void AccumulateBounds (const MDrawable & drawable, TGrafPort * referenceDrawingPort =NIL)

Interface Category:

API.

Purpose:

Calls the Draw function of the MDrawable in order to determine the 2-D bounding rectangle of all the geometries that the MDrawable is comprised of. The bounding rectangle is accumulated across multiple calls to AccumulateBounds.

Calling Context:

Call this function directly.

Parameters:

const MDrawable & drawable -The graphic object.
TGrafPort * referenceDrawingPort =NIL -The drawing port to be used as the parent port from which attributes are inherited by the MDrawable when it is drawn.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TBoundsMaker::GetBounds

virtual TGRect GetBounds () const

Interface Category:

API.

Purpose:

Gets the current accumulated bounds for all of the drawables that have passed through this TBoundsMaker object.

Calling Context:

Call this function directly.

Parameters:

Takes no parameters.

Return Value:

The bounding rectangle that encapsulates all drawable geometries that have been rendered.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.