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

SET LOCATOR MODE (PHOP,WSOP,*,*)

Purpose

Use Set Locator Mode to set the operating mode of the specified locator device.

After the Locator Mode is set, the graPHIGS API sets the echoing state to ECHO or NOECHO. Depending on the specified operating mode--Request, Sample, or Event--an interaction with the given device may begin or end.

Note:

The graPHIGS API resets the input device with the initialization values when your application calls the Description subroutine with the operating mode parameter set to SAMPLE or EVENT.

Language Bindings

C

pset_loc_mode (ws_id, loc_num, op_mode, echo_switch)

Input Parameters

Pint ws_id
Workstation identifier.

Pint loc_num
Locator device number (>=1).

Pop_mode op_mode
Operating mode (0=POP_REQ, 1=POP_SAMPLE, 2=POP_EVENT).

Pecho_switch echo_switch
Echo switch (0=PSWITCH_NO_ECHO, 1=PSWITCH_ECHO).

FORTRAN

PSLCM (wkid, lcdnr, mode, esw)

Input Parameters

integer wkid
Workstation identifier.

integer lcdnr
Locator device number (>=1).

integer mode
Operating mode (0=PREQU, 1=PSAMPL, 2=PEVENT).

integer esw
Echo switch (0=PNECHO, 1=PECHO).

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

Related Subroutines

  • Await Event

  • Initialize Locator

  • Initialize Locator 3

  • Inquire Number Of Available Logical Input Devices

  • Request Locator

  • Request Locator 3

  • Sample Locator

  • Sample Locator 3

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