Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ psmpk(3g) — PHIGS 5.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

PSMPK(3g)  —  Subroutines

Name

PSMPK − Returns pick path information from the pick-class logical input device specified. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

PSMPK (WKID, PKDNR, IPPD, STAT, PPD, PP)

Argument        Data Type      Access   Description
---------------------------------------------------------------------------
WKID            Integer        Read     Workstation identifier
PKDNR           Integer        Read     Pick device number
IPPD            Integer        Read     Depth of the pick path to return
STAT            Integer        Write    Status
PPD             Integer        Write    Depth of the actual pick path
PP(3, IPPD)     Array of       Write    Pick path (struct_id1, pick_id1,
                integers                element_number1, struct_idIPPD,
                                        pick_idIPPD, element_numberIPPD
---------------------------------------------------------------------------

Constants

Defined Argument     Constant       Description
---------------------------------------------------------------------------
STAT                 POK            Measure contains a choice.
                     PNPICK         Measure does not contain a pick path.
---------------------------------------------------------------------------

Description

PSMPK takes the current measure of the pick-class logical input device specified by the device number and the workstation identifier.  If the input status is POK, this function returns the pick path. 

The pick path is a list Digital PHIGS uses to trace the traversal of the structure hierarchy and to uniquely identify the picked primitive. The individual components of the list contain the following integer values:

•Structure identifier

•Pick identifier of the element

•Offset (by element) into the structure

Digital PHIGS returns the  pick path in the order specified by the pick path order entry (TOPFIRST or BOTTOMFIRST) in the workstation state list.  To set the pick path order, use the PINPK function. 

Digital PHIGS determines the pickability of primitives by the name set of the primitive and the current pick filter for the logical input device. 

See Also

PGTPK
PINPK
PQPKS
PRQPK
PSPKFT
DSPHI
PSPKID
PSPKM

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026