Class: TTessellationControl

Declaration: GrafAttribute.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TGrafAttribute

Inherited By:

None.

Purpose:

TTessellationControl is a concrete class derived from TGrafAttribute. It represents an attribute that tells the tessellator how finely to tessellate (divide into shards) a 3-D surface. The TTessellationControl attribute is needed only when the surface is rendered in fill mode--in other words, when the draw type is kFill or kFillAndFrame. (In frame mode, the surface is drawn with isolines instead of being tessellated.) The main use of this attribute is to specify the resolution of tessellation--how large the shards should be. A larger number for the resolution means coarser resolution--in other words, larger shards. The attribute also includes two other controls (C1 tolerance and minimum steps), for which the default values usually suffice.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Member Function: TTessellationControl::GetName

virtual TToken GetName () const

Interface Category:

API.

Purpose:

Gets the name of this TTessellationControl as a TToken. This is used to place and retrieve the attribute as its key.

Calling Context:

Call this function directly.

Parameters:

Return Value:

Returns the name as a TToken.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::TTessellationControl

  1. TTessellationControl ()
  2. TTessellationControl (const TTessellationControl &)
  3. TTessellationControl (GCoordinate Resolution)

Interface Category:

API.

Purpose:

  1. Default constructor.
  2. Copy constructor.
  3. Constructs the TTessellationControl object.

Calling Context:

  1. Called by the stream-in operators . You can also call this function directly.
  2. Called to copy an object. You can also call this function directly.
  3. Call this function directly.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::~TTessellationControl

virtual ~ TTessellationControl ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object. You can also call this function directly.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::GetResolution

virtual GCoordinate GetResolution () const

Interface Category:

API.

Purpose:

Gets the resolution of this TTessellationControl.

Calling Context:

Call this function directly.

Parameters:

Return Value:

Returns the resolution for the tessellation control.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::SetResolution

virtual void SetResolution (GCoordinate numLines)

Interface Category:

API.

Purpose:

Sets the resolution of this TTessellationControl.

Calling Context:

Call this function directly.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::GetC1Tolerence

virtual GCoordinate GetC1Tolerence () const

Interface Category:

API.

Purpose:

Gets the C1 tolerance for this TTessellationControl.

Calling Context:

Call this function directly.

Parameters:

Return Value:

Returns the C1 tolerance for the tessellation control.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::SetC1Tolerence

virtual void SetC1Tolerence (GCoordinate c1tol)

Interface Category:

API.

Purpose:

Sets the C1 tolerance of this TTessellationControl.

Calling Context:

Call this function directly.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::GetMinSteps

virtual long GetMinSteps () const

Interface Category:

API.

Purpose:

Gets this TTessellationControl's minimum steps.

Calling Context:

Call this function directly.

Parameters:

Return Value:

Returns the minimum steps for the tessellation control.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::SetMinSteps

virtual void SetMinSteps (long numSteps =0)

Interface Category:

API.

Purpose:

Sets the minimum steps for this TTessellationControl.

Calling Context:

Call this function directly.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::operator=

TTessellationControl & operator =(const TTessellationControl & source)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object. You can also call this function directly.

Parameters:

Return Value:

A non-const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::operator>>=

virtual TStream & operator >>=(TStream & towhere) const

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data. You can also call this function directly.

Parameters:

Return Value:

Returns a reference to the stream the object streams itself out to.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TTessellationControl::operator<<=

virtual TStream & operator <<= (TStream & fromwhere)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream out data. You can also call this function directly.

Parameters:

Return Value:

Returns a reference to the stream the object streams itself in from.

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.
Copyright©1995 Taligent,Inc. All rights reserved.