Class: TLinkedViewMatrixPort

Declaration: GrafPort.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TLinkedGrafPort

Inherited By:

None.

Purpose:

TLinkedViewMatrixPort is a concrete class, derived from TLinkedGrafPort, that concatenates a 2-D view matrix with a parent port. The view matrix is specified by an argument to the TLinkedViewMatrixPort constructors. This view matrix is concatenated to both the view matrix and the model matrix of the parent. More precisely, the child's view matrix is the concatenation of the parent port's view matrix with the view matrix specified by the constructor argument; and the child's model matrix is the concatenation of the parent port's model matrix with this same specified view matrix. This ensures the correct behavior when view and model matrices are used alternatively in a graphic hierarchy. (As with all linked ports, the concatenations do not modify the parent. They only affect the child's view matrix and model matrix.)

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

The parent port must exist as long as the child port exists.

Member Function: TLinkedViewMatrixPort::TLinkedViewMatrixPort

TLinkedViewMatrixPort (TGrafPort * referencedParentPort, const TGrafMatrix & viewMatrix)
TLinkedViewMatrixPort (TGrafPort * referencedParentPort, TLinkableMatrixState * referencedMatrixState)

Interface Category:

API.

Purpose:

Constructs a new TLinkedViewMatrixPort with the specified TGrafPort as its parent, concatenating the view matrix specified by the TGrafMatrix argument with the parent port's state.
Constructs a new TLinkedViewMatrixPort with the specified TGrafPort as its parent, concatenating the view matrix specified by the TLinkableMatrixState argument with the parent port's state.

Calling Context:

Call this function directly.
Call this function directly.

Parameters:

TGrafPort * referencedParentPort -The graph port to use as the parent.
const TGrafMatrix & viewMatrix -The view matrix to concatenate with the parent port's state.
TGrafPort * referencedParentPort -The graph port to use as the parent.
TLinkableMatrixState * referencedMatrixState -The matrix state object to concatenate with the parent port's state.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TLinkedViewMatrixPort::~TLinkedViewMatrixPort

virtual ~ TLinkedViewMatrixPort ()

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: TLinkedViewMatrixPort::GetState

virtual const TGrafState * GetState () const

Interface Category:

API.

Purpose:

Returns a pointer to a TGrafState object that represents the concatenated graphic state of this object.

Calling Context:

Do not call this function directly. This function is designed to be called by internal classes of the Graphics system (most notably, TGrafStateAccessor).

Parameters:

Takes no parameters.

Return Value:

Returns a constant pointer to the concatenated graphic state.

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.