PEXChangePickDevice - Change Pick Device Attributes

Synopsis 

 
   void PEXChangePickDevice(
        Display *display,
        PEXWorkstation workstation,
        int pick_device_type,
        unsigned long value_mask,
        PEXPDAttributes *values
   )

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).

value_mask
A mask indicating which attributes to return.

values
A pointer to the pick device attribute values.

Returns

None.

Description

Invoke PEXChangePickDevice to modify the attributes of a pick descriptor for the PHIGS workstation resource specified.

This function modifies the descriptor which is the currently-defined descriptor for the pick device of the pick device type specified. Inquire the supported pick device types by invoking the PEXGetEnumTypeInfo function.

Use the value mask to indicate which attributes are to be changed. The value mask is constructed by or'ing together the following constants:

Errors

BadPEXNameSet
The specified name set resource identifier is invalid.

BadPEXPath
The specified path is invalid.

BadPEXWorkstation
The specified workstation resource identifier is invalid.

BadValue
The specified pick device type is invalid, a specified value is invalid, or an invalid bit set in the value mask.

See Also

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