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

REQUEST LOCATOR 3 (PHOP,WSOP,*,*)

Purpose

Use Request Locator 3 to have the graPHIGS API execute a request to the specified locator device.

The graPHIGS API returns the locator position and the index of the view which the graPHIGS API used to convert the location from Device Coordinates (DC) to World Coordinates (WC).

The graPHIGS API returns the locator input from the view with the highest input priority under the cursor. View zero is the highest priority view unless modified by your application.

A status of NONE means that a break action occurred. Otherwise, the graPHIGS API returns a status of OK together with the logical input value which is the current measure of the locator device.

Language Bindings

C

preq_loc3 (ws_id, loc_num, in_status, view_ind, loc_pos)

Input Parameters

Pint ws_id
Workstation identifier.

Pint loc_num
Locator device number (>=1).

Output Parameters

Pin_status *in_status
Input status (0=PIN_STATUS_NONE, 1=PIN_STATUS_OK).

Pint *view_ind
View index (>=0).

Ppoint3 *loc_pos
Locator position in WC.

FORTRAN

PRQLC3 (wkid, lcdnr, stat, viewi, px, py, pz)

Input Parameters

integer wkid
Workstation identifier.

integer lcdnr
Locator device number (>=1).

Output Parameters

integer stat
Input status (0=PNONE, 1=POK).

integer viewi
View index (>=0).

real px
x coordinate of the locator position in WC.

real py
y coordinate of the locator position in WC.

real pz
z coordinate of the locator position in WC.

Errors

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
61
Specified Workstation Is Not Of Category Input Or Outin
250
Specified Device Not Available On Workstation
251
Function Requires Input Device To Be In Request Mode

Related Subroutines

  • Initialize Locator 3

  • Inquire Number Of Available Logical Input Devices

  • Set Locator Mode

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