SAMPLE VALUATOR(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

SAMPLE VALUATOR − sample current measure of a valuator device

SYNOPSIS

C Syntax

void
psample_val ( ws, dev, value )
Pintws;workstation identifier
Pintdev;valuator device number
Pfloat∗value;OUT 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 input from the operator. 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.

C Output Parameter

valueA pointer to a Pfloat 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 further input from the operator.

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