NAME

DdInqPickPathOrder − Return the pick path order of a device

SYNOPSIS

C:

DtPickPathOrder DdInqPickPathOrder(device)
DtObject device;

Fortran:

INTEGER∗4 DDQPPO(DEVICE)
INTEGER∗4 DEVICE

DESCRIPTION

DdInqPickPathOrder returns the pick path order on the device, device.  A device’s pick path order specifies the order in which elements in the pick paths are returned on a device, device, by DdPickObjs <DDPO>.  See DdSetPickCallback for a description of pick paths. 

The two possible values for a device’s pick path order are DcTopFirst <DCTOPF> and DcBottomFirst <DCBOTF>.  DcTopFirst <DCTOPF> means that the pick path starts with the largest group within the view containing the picked primitive object and ends with the picked primitive object itself.  DcBottomFirst <DCBOTF> is just the opposite. 

Note: the value of the pick path order affects only the order of pick path elements in paths returned from DdPickObjs <DDPO> and does NOT affect the order of elements as seen by the pick callback functions (see DdSetPickCallback). 

ERRORS

DdInqPickPathOrder will fail if passed an invalid device handle; the returned value is undefined. 

[WARNING - invalid device handle]

SEE ALSO

DdSetPickPathOrder(3D), DdPickObjs(3D), DdSetPickCallback(3D)

September 29, 2021