Name

PEXSetLocalTransform - Set Local Transformation 3D

Synopsis

void PEXSetLocalTransform(Display ∗display, XID resource_id, PEXOCRequestType req_type, int composition, PEXMatrix transform)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call. 

resource_idThe resource identifier of the renderer or structure. 

req_typeThe request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

compositionThe composition rule for combining the new matrix with the current local transform (PEXPreConcatenate, PEXPostConcatenate, PEXReplace).

transformThe new local transformation matrix. 

Returns

None

Description

This function creates an output primitive attribute which modifies the local transformation matrix.  If the composition type is PEXPreConcatenate, the specified matrix is pre-concatenated to the current local transformation matrix ( L’ = L × T ). If the composition type is PEXPostConcatenate, the specified matrix is post-concatenated to the current local transformation matrix ( L’ = T × L ).  If the composition type is PEXReplace, the specified matrix replaces the current local transformation matrix ( L’ = T ).

The composite matrix is then recomputed using the current global transformation and the new local transformation matrix ( C = G × L’ ). 

Data Structures

See the PEXStructuresman page.

Errors

BadPEXOutputCommand
The output command contains an invalid value.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

PEXSetLocalTransform2D