SET PICK IDENTIFIER(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
psetpickid ( pick_id )
Pintpick_id;pick identifier

FORTRAN Syntax

SUBROUTINE pspkid ( PKID )
INTEGERPKIDpick 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.

FORTRAN Input Parameter

PKIDThe 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 which 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 and SET PICK FILTER do so.

ERRORS

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

Museum