.\" @(#)PEXGDP.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGDP 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGDP - 3D Generalized Drawing Primitive
.SH SYNTAX
.HP
void PEXGDP\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, long \fIgdp_id\fP\^, unsigned int \fIcount\fP\^, PEXCoord
*\fIpoints\fP\^, unsigned long \fIlength\fP\^, char *\fIdata\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
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 \fIgdp_id\fP 1i
The identifier of the \s-1GDP\s0.
.IP \fIcount\fP 1i
The number of points.
.IP \fIpoints\fP 1i
The points used by the \s-1GDP\s0.
.IP \fIlength\fP 1i
The length, in bytes, of the data.
.IP \fIdata\fP 1i
Additional data used by the \s-1GDP\s0.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXGDP
.IX "GDP" "PEXGDP"
.LP
This function creates a generalized drawing primitive.
.LP
The complete interface and behavior for each GDP identifier
should be available with the individual PEX server implementations.
There are no standard PEX GDPs.
If the specified GDP identifier is not supported,
then the output command is ignored.
The table below lists the supported GDP identifier.
.\"@
.\" start equation_nroff_version
.if t .ig xx
.sp
.nf
GDP Identifier                          Description

PEXSunGDP3DIdCircle                     Circle
PEXSunGDP3DIdCircArc                    Circular arc
PEXSunGDP3DIdCircArcClose               Circular arc close
PEXSunGDP3DIdAnnotCircle                Annotation circle
PEXSunGDP3DIdAnnotCircArc               Annotation circle arc
PEXSunGDP3DIdAnnotCircArcClose          Annotation circle arc close
PEXSunGDP3DIdEllipse                    Ellipse
PEXSunGDP3DIdEllpArc                    Elliptical arc
PEXSunGDP3DIdEllpArcClose               Elliptical arc close 
PEXSunGDP3DIdAnnotEllipse               Annotation ellipse
PEXSunGDP3DIdAnnotEllpArc               Annotation elliptical arc
PEXSunGDP3DIdAnnotEllpArcClose          Annotation elliptical arc close
PEXSunGDP3DIdRectGrid                   Rectangular grid 
PEXSunGDP3DIdRadialGrid                 Radial grid
PEXSunGDP3DIdTriangleList               Triangle list
ESGdpSphere                             Sphere
ESGdpSphereRadius                       Sphere with radius
ESGdpSphereColour                       Sphere with colour
ESGdpSphereRadiusColour                 Sphere with radius and colour
ESGdpCylinder                           Cylinder
ESGdpCylinderRadius                     Cylinder with radius
ESGdpCylinderColour                     Cylinder with colour
ESGdpCylinderRadiusColour               Cylinder with radius and colour
.sp
.fi
.xx
.\"@
.\" start equation_troff_version
.if n .ig yy
.LP
.TS H
center, box;
lfB lfB
l l.
GDP Identifier	Description
_
.TH
PEXSunGDP3DIdCircle	Circle
PEXSunGDP3DIdCircArc	Circular arc
PEXSunGDP3DIdCircArcClose	Circular arc close
PEXSunGDP3DIdAnnotCircle	Annotation circle
PEXSunGDP3DIdAnnotCircArc	Annotation circle arc
PEXSunGDP3DIdAnnotCircArcClose	Annotation circle arc close
PEXSunGDP3DIdEllipse	Ellipse
PEXSunGDP3DIdEllpArc	Elliptical arc
PEXSunGDP3DIdEllpArcClose	Elliptical arc close
PEXSunGDP3DIdAnnotEllipse	Annotation ellipse
PEXSunGDP3DIdAnnotEllpArc	Annotation elliptical arc
PEXSunGDP3DIdAnnotEllpArcClose	Annotation elliptical arc close
PEXSunGDP3DIdRectGrid	Rectangular grid
PEXSunGDP3DIdRadialGrid	Radial grid
PEXSunGDP3DIdTriangleList	Triangle list
ESGdpSphere	Sphere
ESGdpSphereRadius	Sphere with radius
ESGdpSphereColour	Sphere with colour
ESGdpSphereRadiusColour	Sphere with radius and colour
ESGdpCylinder	Cylinder
ESGdpCylinderRadius	Cylinder with radius
ESGdpCylinderColour	Cylinder with colour
ESGdpCylinderRadiusColour	Cylinder with radius and colour
.TE
.yy
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp
.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.