'\" t
.\" @(#)PEXEscapeWithReply-PEXSunEscIdGetExtRendAttr.3 1.4 95/04/06 SMI;
.so man3/pex.macs
.TH PEXEscapeWithReply-PEXSunEscIdGetExtRendAttr 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXEscapeWithReply-PEXSunEscIdGetExtRendAttr - PEX Get Extended Renderer Attributes
.SH SYNTAX
.HP
char *PEXEscapeWithReply\^(\^Display *\fIdisplay\fP\^, unsigned long \fIescape_id\fP\^, int \fIlength\fP\^, char *\fIescape_data\fP\^, unsigned long *\fIreply_length_return\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIescape_id\fP 1i
The escape identifier.
.IP \fIlength\fP 1i
The length, in bytes, of data for the escape request.
.IP \fIescape_data\fP 1i
A pointer to data for the escape request.
.IP \fIreply_length_return\fP 1i
Returns the length, in bytes, of the reply data.
.SH RETURNS
A pointer to the escape reply data; a null pointer if unsuccessful.
.SH DESCRIPTION
.\" indexing
.IX PEXEscapeWithReply-PEXSunEscIdGetExtRendAttr
.IX "Escapes" "PEXEscapeWithReply-PEXSunEscIdGetExtRendAttr"
.LP
To use the Sun GetExtendedRendererAttributes escape, the
.I escape_id
parameter should be set to
.B PEXSunEscIdGetExtRendAttr,
the
.I escape_data
parameter should be set to point to structure type
.I pexSunEscGetExtRendAttr,
and the
.I length
parameter should be set to the total length of
.I escape_data.
.LP
This escape allows inquiry of one or more of the extended renderer attributes.
The semantics of this escape are the same as those of
.BR PEXGetRendererAttributes (3) .
.LP
This escape returns a pointer to reply data in the following format:
.\"@
.\" start equation_nroff_version
.if t .ig xx
.bp
.xx
.\"@
.\" start equation_troff_version
.if n .ig yy
.LP
.yy
.TS
center, box;
l.
unused[20 bytes]
_
value(1) [4 bytes]
_
\(.....
_
value(n) [4 bytes]
.TE
.LP
where value(i) corresponds to the i-th bit of the renderer attribute
set in the
.I itemMask.
.SH DATA STRUCTURES
.nf
typedef struct {
.br
        pexEnumTypeIndex      fpFormat B16;
        CARD16                      ununsed B16;
        XID                            id B32;            /* renderer id */
        CARD32                      itemMask;
.br
} pexSunEscGetExtRendAttr;
.fi
.LP
Values for
.I itemMask
are defined in
.B SunPEX.h
as listed below:
.LP
.TS
box;
lf3 cf3 lf3
l c l.
Symbol	Value	Explanation
_
PEXRDSunAAliasMode	0x00000001	Anti-aliasing mode attribute
PEXRDSunTranspMode	0x00000002	Transparency mode attribute
PEXRDSunStereoMode	0x00000004	Stereo mode attribute
PEXRDSunSilhouetteEdgeMode	0x00000008	Silhouette edge mode attribute
.TE
.SH SEE ALSO
.LP
.nf
.BR PEXEscape (3)
.BR PEXEscapeWithReply (3)
.BR PEXGetRendererAttributes (3)
.fi