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

REQUEST VALUATOR (PHOP,WSOP,*,*)

Purpose

Use Request Valuator to have the graPHIGS API execute a request to the specified valuator device.

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 valuator device. The value returned is in the range specified by your application through the Initialize Valuator subroutine.

Language Bindings

C

preq_val (ws_id, val_num, in_status, value)

Input Parameters

Pint ws_id
Workstation identifier.

Pint val_num
Valuator device number (>=1).

Output Parameters

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

Pfloat *value
Requested valuator value.

FORTRAN

PRQVL (wkid, vldnr, stat, val)

Input Parameters

integer wkid
Workstation identifier.

integer vldnr
Valuator device number (>=1).

Output Parameters

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

real val
Valuator value.

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 Valuator

  • Inquire Number Of Available Logical Input Devices

  • Set Valuator Mode

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