PEXCreatePickMeasure - Create Pick Measure

Synopsis 

 
  PEXPickMeasure PEXCreatePickMeasure(
      Display *display,
      PEXWorkstation workstation,
      int pick_device_type
  )

Arguments

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

workstation
The resource identifier of the workstation.

pick_device_type
The pick device type (PEXPickDeviceDCHitBox or PEXPickDeviceNPCHitVolume).

Returns

The resource identifier of the newly-created pick measure.

Description

Invoke PEXCreatePickMeasure to create a pick measure resource of the type specified.

This function initializes the pick measure with the values contained in the appropriate pick device descriptor stored in the specified workstation. Inquire the supported pick device types by invoking the PEXGetEnumTypeInfo function.

Errors

BadAlloc
The implementation failed to allocate the resource.

BadPEXWorkstation
The specified workstation resource identifier is invalid.

BadValue
The specified pick device type is invalid.

See Also

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