PEXUpdatePickMeasure - Update Pick Measure

Synopsis 

 
   void PEXUpdatePickMeasure(
        Display *display,
        PEXPickMeasure pick_measure,
        int pick_device_type,
        PEXPickRecord *pick_record
   )

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

pick_measure
The resource identifier of the pick measure.

pick_device_type
The pick device type (PEXPickDeviceDCHitBox or PEXPickDeviceNPCHitVolume).

pick_record
A pointer to the pick data record.

Returns

None.

Description

Invoke PEXUpdatePickMeasure to update the specified pick measure resource.

If the update causes a primitive to be picked, then this function sets the pick measure's pick status to PEXPick and sets the pick path attribute to the path of the picked primitive. If no primitive was picked, then this function sets the pick status to PEXNoPick.

Use the pick path for echoing when the pick measure is created. However, it is not used as a start path from which to start picking.

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. PEXlib defines the following values for pick_device_type:

PEXPickDeviceDCHitBox -
point the input record to a data structure of type PEXPDDCHitBox.

PEXPickDeviceNPCHitVolume -
point the input record to a data structure of type PEXPDNPCHitVolume.

Errors

BadPEXPath
The specified path is invalid.

BadPEXPickMeasure
The specified pick measure resource identifier is invalid.

See Also

For a list of all PHIGS Workstation Picking functions and related topics, see PHIGS Workstation Picking.