void PEXBeginPickOne(
Display *display,
Drawable drawable,
PEXRenderer renderer,
long structure_id,
int method,
int pick_device_type,
PEXPickRecord *pick_record
)
None.
Invoke PEXBeginPickOne to start an immediate-mode pick, setting the renderer's renderer state to PEXPicking.
When the renderer state is PEXPicking, primitives are hit tested instead of converted to pixels. For pick one, a hierarchical path to the picked primitive is maintained.
PEXlib defines the following pick one methods:
To determine the supported pick device types, invoke the PEXGetEnumTypeInfo function.
The specified structure identifier is inserted as the first structure component in the returned pick path.
If the specified drawable does not have the same root and depth as the drawable that was used to create the renderer, or, if the implementation does not support the specified drawable, then the implementation issues a BadMatch error. To determine the supported drawables, invoke the PEXMatchRenderingTargets function. If the renderer state is set to PEXRendering or PEXPicking when you invoke this function, then the operation in progress is aborted, the PEXBeginPickOne function is completed, and the implementation issues a BadPEXRendererState error.
When the renderer state is PEXPicking, you can invoke any function which processes output commands or manipulates attributes (e.g., all output command functions, PEXBeginStructure, PEXEndStructure, PEXRenderElements, and PEXAccumulateState). These functions have the same semantics except that primitives are hit tested instead of converted to pixels.
For a list of all Renderer Pick functions and related topics, see Renderer Picking.