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

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

Purpose

Use Sample Locator 3 to immediately retrieve the current measure of the specified locator device.

The measure consists of a locator position in World Coordinates (WC) and the index of the view table entry which has a matrix that the graPHIGS API used to convert the location from Device Coordinates (DC) to World Coordinates (WC).

This subroutine 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.

Language Bindings

C

psample_loc3 (ws_id, loc_num, view_ind, loc_pos)

Input Parameters

Pint ws_id
Workstation identifier.

Pint loc_num
Locator device number (>=1).

Output Parameters

Pint *view_ind
View index (>=0).

Ppoint3 *loc_pos
Locator position in WC.

FORTRAN

PSMLC3 (wkid, lcdnr, viewi, lpx, lpy, lpz)

Input Parameters

integer wkid
Workstation identifier.

integer lcdnr
Locator device number (>=1).

Output Parameters

integer viewi
View index (>=0).

real lpx
x coordinate of locator position in WC.

real lpy
y coordinate of locator position in WC.

real lpz
z coordinate of 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
252
Function Requires Input Device To Be In Sample Mode

Related Subroutines

  • Inquire Number Of Available Logical Input Devices

  • Set Locator Mode

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