.\" @(#)PEXSetLocalTransform2D.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetLocalTransform2D 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetLocalTransform2D - Set Local Transformation 2D
.SH SYNTAX
.HP
void PEXSetLocalTransform2D\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, int \fIcomposition\fP\^, PEXMatrix3x3 \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 PEXSetLocalTransform2D
.LP
This function creates an output primitive attribute which
modifies the local transformation matrix.
This output command is similar to
.BR PEXSetLocalTransform (3)
except
that the local transformation matrix is specified as a 3 \(mu 3 matrix.
Before modification of the local transformation matrix,
the 3 \(mu 3 matrix represented by
.\"@
.\" start equation_nroff_version
.if t .ig xx
.sp
.nf
        [ a b c ]
        [ d e f ]
        [ g h j ]
.sp
.fi
is expanded to a 4 \(mu 4 matrix as follows:
.sp
.nf
        [ a b c ]     [ a b 0 c ]
        [ d e f ]  -> [ d e 0 f ]
        [ g h j ]     [ 0 0 1 0 ]
                      [ g h 0 j ]
.sp
.fi
.xx
.\"@
.\" start equation_troff_version
.if n .ig yy
.sp
.IP
.EQ
left [
    {
    ~~~ pile { a above d above g }
    ~~~ pile { b above e above h }
    ~~~ pile { c above f above j }
    }
    ~~~ right ]
.EN  
.sp .5
.LP
is expanded to a 4 \(mu 4 matrix as follows:
.sp .5
.IP
.EQ
left [
    {
    ~~~ pile { a above d above g }
    ~~~ pile { b above e above h }
    ~~~ pile { c above f above j }
    }
    ~~~ right ] ->
left [
    {
    ~~~ pile { a above d above 0 above g }
    ~~~ pile { b above e above 0 above h }
    ~~~ pile { 0 above 0 above 1 above 0 }
    ~~~ pile { c above f above 0 above j }
    }
    ~~~ right ]
.EN  
.yy
.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 PEXSetLocalTransform (3)
.fi