NAME

SET PICK IDENTIFIER − create structure element to set the current pick identifier attribute

SYNOPSIS

C Syntax

void
pset_pick_id ( pick_id )
Pintpick_id;pick identifier

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET PICK IDENTIFIER creates a structure element containing a value for the current pick identifier attribute, which applies to all output primitives which follow in the structure network. 

If the current edit mode is INSERT, a SET PICK IDENTIFIER element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, the new SET PICK IDENTIFIER element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element. 

C Input Parameter

pick_id
The pick identifier value. 

Execution

When the conceptual traversal of a posted structure network (to determine what primitive is being picked) starts, the current pick identifier is 0.  When the SET PICK IDENTIFIER element is traversed, the current pick identifier is set to the element’s pick identifier value, and is associated with all output primitives that follow in the structure network. 

If a primitive is picked, the pick identifier at each level in the pick path is part of a PICK input device’s measure, and can provide the application auxiliary information about the picked primitive. 

The pick identifier is not used to determine which primitives are pickable; ADD NAMES TO SET, REMOVE NAMES FROM SET, and SET PICK FILTER perform this activity. 

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

SEE ALSO

INITIALIZE PICK (3P)
SET PICK FILTER (3P)
REQUEST PICK (3P)
GET PICK (3P)
SAMPLE PICK (3P)

September 02, 1992