SAMPLE VALUATOR(3P) — SUNPHIGS LIBRARY

NAME

SAMPLE VALUATOR − sample current measure of a valuator device

SYNOPSIS

C Syntax

void
psampleval ( ws, dev, valuator )
Pintws;workstation identifier
Pintdev;valuator device number
Pfloat∗valuator;OUT valuator value

FORTRAN Syntax

SUBROUTINE psmvl ( WKID, VLDNR, VAL )
INTEGERWKIDworkstation identifier
INTEGERVLDNRvaluator device number
REALVALOUT value

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use SAMPLE VALUATOR to sample the current measure of the specified valuator device without waiting for the device trigger to fire. The device must be in SAMPLE mode. See SET VALUATOR MODE and INITIALIZE VALUATOR for more information.

C Input Parameters

wsWorkstation identifier. An integer specifying the workstation with which the specified valuator device is associated.

devThe device number of the valuator device to be sampled. See the Available Devices section of INITIALIZE VALUATOR for a description of the available devices.

valuator
A pointer to a Pfloat variable in which to store the VALUATOR measure.

FORTRAN Input Parameters

WKIDThe workstation identifier of the workstation associated with the device.

VLDNR
The device number of the VALUATOR device. See the Available Devices section of INITIALIZE VALUATOR for a description of the available devices.

VALA variable in which to store the VALUATOR measure.

Execution

SAMPLE VALUATOR samples the specified valuator device. The device must be in SAMPLE mode. See SET VALUATOR MODE and INITIALIZE VALUATOR for more information.

When a device is set to SAMPLE mode, a measure process is created for the device and the device is activated. When SAMPLE VALUATOR is called, the current value of the measure process for the specified device is retrieved without waiting for the device’s trigger to fire.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

061Ignoring function, specified workstation is neither of category INPUT nor of category OUTIN

250Ignoring function, the specified device is not available on the specified workstation

252Ignoring function, the function requires the input device to be in SAMPLE Mode

Museum