.\" @(#)PEXSetParaSurfCharacteristics.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetParaSurfCharacteristics 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetParaSurfCharacteristics - Set Parametric Surface Characteristics
.SH SYNTAX
.HP
void PEXSetParaSurfCharacteristics\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, int \fIpsc_type\fP\^, PEXPSCData *\fIcharacteristics\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 \fIpsc_type\fP 1i
The parametric surface characteristic type (
.B PEXPSCNone,
.B PEXPSCImpDep,
.B PEXPSCIsoCurves,
.B PEXPSCMCLevelCurves,
.B PEXPSCWCLevelCurves
).
.IP \fIcharacteristics\fP 1i
A pointer to data defining the parametric surface characteristics.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetParaSurfCharacteristics
.LP
This function creates an output primitive attribute which
sets the parametric surface
.I characteristics.
If the specified parametric surface
.I characteristics
type is not supported,
.B PEXPSCNone
is used.
Supported values for parameteric surface characteristic types are inquirable
via
.BR PEXGetEnumTypeInfo (3) .
.SH DATA STRUCTURES
.LP
.nf
typedef union {
	PEXPSCIsoparametricCurves		iso_curves;
	PEXPSCLevelCurves			level_curves;
	PEXPSCImpDepData			imp_dep;
.br
} PEXPSCData;
.sp
typedef struct {
	unsigned short		placement_type;
	unsigned short		reserved;
	unsigned short		u_count;
	unsigned short		v_count;
.br
} PEXPSCIsoparametricCurves;
.sp
typedef struct {
	PEXCoord		origin;
	PEXVector		direction;
	unsigned short		count;		/* number of parameters */
	unsigned short		reserved;
	float			*parameters;
.br
} PEXPSCLevelCurves;
.sp
typedef struct {
	unsigned short		length;
	char			*data;
.br
} PEXPSCImpDepData;
.fi
.sp .5
See also
.B PEXlib.h.
.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.