.\" @(#)PEXUpdatePickMeasure.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXUpdatePickMeasure 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXUpdatePickMeasure - Update Pick Measure
.SH SYNTAX
.HP
void PEXUpdatePickMeasure\^(\^Display *\fIdisplay\fP\^, PEXPickMeasure \fIpick_measure\fP\^, int \fIpick_device_type\fP\^, PEXPickRecord *\fIpick_record\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIpick_measure\fP 1i
The resource identifier of the pick measure.
.IP \fIpick_device_type\fP 1i
The pick device type (
.B PEXPickDeviceDCHitBox
or
.B PEXPickDeviceNPCHitVolume
).
.IP \fIpick_record\fP 1i
A pointer to the pick data record.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXUpdatePickMeasure
.LP
This function updates the specified pick measure resource.
If the update causes a primitive to be picked, the pick measure's pick status
will be set to
.B PEXPick
and the pick path attribute will be set to the path of the picked
primitive.  If no primitive was picked, the pick status will be set to
.B PEXNoPick.
.LP
The pick path can be used for echoing when the pick measure is created.
However, it is not used as a start path from which to start picking.
.LP
The input record is a pointer to data used to update the pick measure and
depends on the pick device type specified when the pick measure was
created.
If the pick device type is
.B PEXPickDeviceDCHitBox,
the input record should point to a data structure of type
.B PEXPDDCHitBox.
If the pick device type is
.B PEXPickDeviceNPCHitVolume,
the input record should point to a data structure of type
.B PEXPDNPCHitVolume.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXPickMeasure;
.sp
typedef union {
	PEXPDNPCHitVolume		volume;
	PEXPDDCHitBox		box;
	PEXPickDataRecord		data;
.br
} PEXPickRecord;
.sp
typedef  PEXNPCSubVolume	PEXPDNPCHitVolume;
.sp
typedef struct {
	PEXCoord	min;
	PEXCoord	max;
.br
} PEXNPCSubVolume;
.bp
typedef struct {
	float	x;
	float	y;
	float	z;
.br
} PEXCoord;
.sp
typedef struct {
	PEXDeviceCoord2D	position;
	float			distance;
.br
} PEXPDDCHitBox;
.sp
typedef struct {
	short	x;
	short	y;
.br
} PEXDeviceCoord2D;
.sp
typedef struct {
	unsigned short		length;		/* number of bytes in record */
	char			*record;
.br
} PEXPickDataRecord;
.fi
.SH ERRORS
.TP
.SB BadPEXPath
The specified path is invalid.
.TP
.SB BadPEXPickMeasure
The specified pick measure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXFreePickMeasure (3)
.fi