.\" @(#)PEXSetLocalTransform.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetLocalTransform 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetLocalTransform - Set Local Transformation 3D
.SH SYNTAX
.HP
void PEXSetLocalTransform\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, int \fIcomposition\fP\^, PEXMatrix \fItransform\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIresource_id\fP 1i
The resource identifier of the renderer or structure.
.IP \fIreq_type\fP 1i
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.IP \fIcomposition\fP 1i
The composition rule for combining the new matrix with the current local
transform (
.B PEXPreConcatenate,
.B PEXPostConcatenate,
.B PEXReplace
).
.IP \fItransform\fP 1i
The new local transformation matrix.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetLocalTransform
.LP
This function creates an output primitive attribute which
modifies the local transformation matrix.
If the
.I composition
type is
.B PEXPreConcatenate,
the specified matrix is
pre-concatenated to the current local transformation matrix
( L' = L \(mu T ).
If the
.I composition
type is
.B PEXPostConcatenate,
the specified
matrix is post-concatenated to the current local
transformation matrix ( L' = T \(mu L ).  If the
.I composition
type is
.B PEXReplace,
the specified matrix replaces the current local
transformation matrix ( L' = T ).
.LP
The composite matrix is then recomputed using the current global transformation
and the new local transformation matrix ( C = G \(mu L' ).
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp .5
.SH ERRORS
.TP
.SB BadPEXOutputCommand
The output command contains an invalid value.
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXSetLocalTransform2D (3)
.fi