.\" @(#)PEXSetGlobalTransform2D.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetGlobalTransform2D 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetGlobalTransform2D - Set Global Transformation 2D
.SH SYNTAX
.HP
void PEXSetGlobalTransform2D\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\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 \fItransform\fP 1i
The new global transformation matrix.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetGlobalTransform2D
.LP
This function creates an output primitive attribute which
replaces the current global transformation matrix with the specified matrix.
This output command is similar to
.BR PEXSetGlobalTransform (3)
except that the global transformation matrix is specified as a 3 \(mu 3 matrix.
Before replacement of the global 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
.xx
.fi
.\"@
.\" 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 BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXSetGlobalTransform (3)
.fi