NAME

DdInqPickAperture − Return the pick aperture of a device

SYNOPSIS

C:

void DdInqPickAperture(device, aperture)
DtObject device;
DtSize3 ∗aperture;

Fortran:

CALL DDQPA(DEVICE, APRTUR)
INTEGER∗4 DEVICE
REAL∗8 APRTUR(3)

DESCRIPTION

DdInqPickAperture returns the pick aperture of a specified device, device, into the width, height, and depth fields of the supplied argument aperture <in Fortran, the aperture is returned in an array>. 

When a pick is initiated on a device (via DdPickObjs <DDPO>), a volume of space centered around the pick point is searched for drawable objects.  The dimensions of that volume are defined by the device’s pick aperture as specified by a width, a height, and a depth in device coordinates.  The pick aperture is set by DdSetPickAperture <DDSPA>. 

ERRORS

DdInqPickAperture will fail if passed an invalid device handle. 

[WARNING - invalid device handle]

SEE ALSO

DdPickObjs(3D), DdSetPickAperture(3D)

September 29, 2021