[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPRQLC - Request Locator

GPRQLC (wsid, device, status, view, pos)

Purpose

Use GPRQLC to have the graPHIGS API execute a request to the specified locator device.

The locator position and the index of the view whose matrix was used to convert the location to World Coordinates (WC) are returned.

Locator input is returned from the view active for input with the highest input priority under the cursor. View 0 is the highest priority view, unless modified by your application.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Locator device number (>=1)

status -- returned by the graPHIGS API, fullword integer

Status (1=NONE, 2=OK )

view -- returned by the graPHIGS API, fullword integer

View index.

pos -- returned by the graPHIGS API, 3 short floating-point numbers (WC)

Locator position.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
140
DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
141
INPUT DEVICE NOT IN CORRECT MODE
168
INPUT DEVICE IS CURRENTLY OWNED BY ANOTHER CONNECTION

Related Subroutines

GPINLC
Initialize Locator
GPLCMO
Set Locator Mode
GPQLI
Inquire List of Logical Input Devices

RCP code

201335559 (X'0C002307')


[ Previous | Next | Contents | Glossary | Home | Search ]