graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPRQXP - Request Extended Pick

GPRQXP (wsid, device, maxdepth, status, view, point, modelling, depth, pickpath)

Purpose

Use GPRQXP to have graPHIGS API execute a request to the specified pick device. This subroutine can be used only for a pick device which provides the extended pick information. For a pick device which does not return the extended information, the Request Pick (GPRQPK) subroutine should be used. The Inquire Pick Measure Type (GPQPKT) subroutine can be used to determine if the pick device provides the extended pick information.

The pick path information is returned in the order specified in the Initialize Pick (GPINPK) subroutine that is, 1=TOP_FIRST or 2=BOTTOM_FIRST If GPINPK has not been called, the default value is 1=TOP_FIRST

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Pick device number (>=1)

maxdepth -- specified by user, fullword integer

Length of pick path array provided by the application in which the graPHIGS API returns the pick information (>=0)

This value is specified as the size of the pick path array in terms of pick path entries.

status -- returned by the graPHIGS API, fullword integer

Status (1=NONE, 2=OK )

view -- returned by the graPHIGS API, fullword integer

Index of the view which was used to render the instance of the primitive that was picked.

point -- returned by the graPHIGS API, 3 short floating-point numbers

Position of the center of the pick aperture in NPC when the pick was detected. For the typical physical input device that is used to drive the logical pick device (for example, tablet), only thex and y values are meaningful. The z value always contains a constant (0)

modelling -- returned by the graPHIGS API, 16 short floating-point numbers

Composite modelling transformation that was used to transform the instance of the primitive that was picked.

depth -- returned by the graPHIGS API, fullword integer

Depth of the pick path returned in the pickpath parameter.

pickpath -- returned by the graPHIGS API, array of fullword integers

Pick path for picked primitive. List of pick path quadruples. Each quadruple represents a structure identifier, pick identifier, label and element number of the picked primitive or an execute structure element of the pickpath Pick path data is returned in the order (1=TOP_FIRST, 2=BOTTOM_FIRST ) that was last set through an Initialize Pick (GPINPK) subroutine.

If the actual pick information is longer than the pickpath array provided by the application, the overage is truncated. Pick path data is returned in the pickpath parameter in the following order: Entry 1, Entry 2, ...Entry N.

          --------------------------------------------------------------------
 Entry 1  |  Structure ID 1  |  Pick ID 1    |    Label #1    |  Element #1  |
          |                  |               |                |              |
 Entry 2  |  Structure ID 2  |  Pick ID 2    |    Label #2    |  Element #2  |
          |                  |               |                |              |
   .      |        .         |      .        |       .        |       .      |
   .      |        .         |      .        |       .        |       .      |
   .      |        .         |      .        |       .        |       .      |
          |                  |               |                |              |
 Entry N  |  Structure ID N  |  Pick ID N    |    Label #N    |  Element #N  |
          --------------------------------------------------------------------

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
140: DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
141: INPUT DEVICE NOT IN CORRECT MODE
164: PICK DEVICE DOES NOT PROVIDE EXTENDED INFORMATION
168: INPUT DEVICE IS CURRENTLY OWNED BY ANOTHER CONNECTION
505: LENGTH OF RETURN ARRAY < ZERO

Related Subroutines

GPADCN: Add Class Name to Set
GPINPK: Initialize Pick
GPPKF: Set Pick Filter
GPPKID: Set Pick Identifier
GPPKMO: Set Pick Mode
GPQPKT: Inquire Pick Measure Type
GPRCN: Remove Class Name from Set

RCP code

201335566 (X'0C00230E')