PEXOCCSetPickID - Set Pick Identifier (5.0)


Synopsis

 
   void PEXOCCSetPickID(
        PEXOCC context,
        unsigned long pick_id
   )
 

 
   void PEXSetPickID(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        unsigned long pick_id
   )
 

Arguments

context
An OC context returned by a successful PEXCreateOCC call.

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

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

pick_id
The pick identifier.

Returns

None.

Description

Invoke PEXOCCSetPickID to create an attribute output command which sets the current pick identifier attribute in the renderer's pipeline state according to the value specified by pick_id.

The pick identifier is returned as part of the path when you pick a primitive. When you are structure editing, you can use the pick identifier for navigation purposes.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview and for a list of output attribute functions, see Output Attribute Functions.