.\" @(#)PEXSetModelClipVolume.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetModelClipVolume 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetModelClipVolume - Set Model Clip Volume 3D
.SH SYNTAX
.HP
void PEXSetModelClipVolume\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, int \fIop\fP\^, unsigned int \fIcount\fP\^, PEXHalfSpace *\fIhalf_spaces\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 \fIop\fP 1i
The model clipping volume operator (
.B PEXModelClipReplace
or
.B PEXModelClipIntersection
).
.IP \fIcount\fP 1i
The number of halfspaces.
.IP \fIhalf_spaces\fP 1i
An array of points and normal vectors defining the model clipping volume.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetModelClipVolume
.LP
This function creates an output primitive attribute which
sets the model clip volume attribute.
The operator will be used to combine the specified list of half-spaces with
the current model clipping volume to form a new model clipping volume.
Values for the operator are
.B PEXModelClipReplace
(replace current volume)
and
.B PEXModelClipIntersection
(intersect specified volume with current volume).
Each half-space is defined by a point and a normal in model coordinates.
The normal points in the direction of the half-space, and the point
is considered to be on the plane.
See
.BR PEXGetImpDepConstants (3)
for the maximum allowable number of model clip planes.
.LP
Each half-space is transformed by the current composite modeling transformation
and combined with the current model clipping volume.  The resulting model
clipping volume is not affected by subsequent changes to the composite modeling
transformation.
.SH DATA STRUCTURES
.LP
.nf
typedef struct {
	PEXCoord	point;
	PEXVector	vector;
.br
} PEXHalfSpace;
.fi
.sp .5
See also
.B PEXlib.h.
.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 PEXSetModelClipFlag (3)
.BR PEXSetModelClipVolume2D (3)
.BR PEXRestoreModelClipVolume (3)
.BR PEXGetImpDepConstants (3)
.fi