.\" @(#)PEXCreatePickMeasure.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCreatePickMeasure 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCreatePickMeasure \- Create Pick Measure
.SH SYNTAX
.LP
PEXPickMeasure PEXCreatePickMeasure\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, int \fIpick_device_type\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIworkstation\fP
The resource identifier of the workstation.
.TP
\fIpick_device_type\fP
The pick device type (
.B PEXPickDeviceDCHitBox
or
.B PEXPickDeviceNPCHitVolume
).
.SH RETURNS
The resource identifier of the newly-created pick measure.
.SH DESCRIPTION
.\" indexing
.IX PEXCreatePickMeasure
.IX "Pick Measure" PEXCreatePickMeasure
.LP
This function creates a pick measure resource of the type specified.  The
pick measure is initialized with the values contained in the appropriate
pick device descriptor stored in the specified
.I workstation.
The supported pick device types are inquirable via
.BR PEXGetEnumTypeInfo (3) .
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
typedef  XID	PEXPickMeasure;
.sp
.fi
.SH ERRORS
.TP
.SB BadAlloc
The server failed to allocate the resource.
.TP
.SB BadPEXWorkstation
The specified
.I workstation
resource identifier is invalid.
.TP
.SB BadValue
The specified pick device type is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXFreePickMeasure (3)
.BR PEXGetEnumTypeInfo (3)
.fi