INQUIRE VALUATOR DEVICE STATE 3(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE VALUATOR DEVICE STATE 3 − inquire state of a valuator device

SYNOPSIS

C Syntax

void
pinq_val_st3 ( ws, dev, store, err, op_mode, echo_switch, init_value, prompt_echo,
echo_vol, val_data)
Pintws;workstation identifier
Pintdev;valuator device number
Pstorestore;handle to store object
Pint∗err;OUT error indicator
Pop_mode∗op_mode;OUT operating mode
Pecho_switch∗echo_switch;OUT echo switch
Pfloat∗init_value;OUT initial value
Pint∗prompt_echo;OUT prompt/echo type
Plimit3∗echo_vol;OUT echo area
Pval_data3∗∗val_data;OUT data record

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE VALUATOR DEVICE STATE 3 to retrieve the current state of the specified valuator device.

C Input Parameters

Applications using the C binding must create a buffer to be used by this function as memory space for storing data associated with the device state. This buffer is passed as the store argument.

The store buffer is a data area managed by the PHIGS. While the application is responsible for creating the initial buffer through a call to CREATE STORE, PHIGS manages this area such that there is sufficient memory for the specific inquiry. The valuator device data record within the store buffer is accessed via the pointer pointed to by val_data.

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

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

storeThe memory buffer PHIGS is to use for storing the information returned. This buffer must exist prior to calling this function (see CREATE STORE (3P)).

C Output Parameters

errA pointer to the location to store the error number of any error detected by this function.

op_mode
The operating mode. Pop_mode is an enumerated type defined in phigs.h with the following values:

typedef enum {
POP_REQ,
POP_SAMPLE,
POP_EVENT
} Pop_mode;

echo_switch
The echo state. Pecho_switch is an enumerated type defined in phigs.h with the following values:

typedef enum {
PSWITCH_NO_ECHO,
PSWITCH_ECHO
} Pecho_switch;

init_value
Initial value.

prompt_echo
The prompt/echo type desired. See the Available Devices Section of INITIALIZE VALUATOR for a description of the available types.

echo_vol
A pointer to a Plimit3 structure defining the x, y, and z components of the echo volume, in Device Coordinates. Plimit3 is defined in phigs.h as follows:

typedef struct {
Pfloatx_min;/∗ minimum x coordinate value ∗/
Pfloatx_max;/∗ maximum x coordinate value ∗/
Pfloaty_min;/∗ minimum y coordinate value ∗/
Pfloaty_max;/∗ maximum y coordinate value ∗/
Pfloatz_min;/∗ minimum z coordinate value ∗/
Pfloatz_max;/∗ maximum z coordinate value ∗/
} Plimit3;

val_data
Pointer to a pointer that points to the pick device state within store. Pval_data3 is defined in phigs.h as follows:

typedef struct {
Pfloatlow;/∗ low range limit ∗/
Pfloathigh;/∗ high range limit ∗/
union {
struct {
Pintunused;
} pet_r1;
struct {
char∗label;
char∗format;
char∗low_label;
char∗high_label;
} pet_u1;
} pets;
} Pval_data3;

Execution

INQUIRE VALUATOR DEVICE STATE 3 returns the current state of the specified valuator device, which is stored in the workstation state list of the workstation associated with the device. The current state includes the operating mode, echo switch, initial value, prompt/echo type, echo volume, and data record. See SET VALUATOR MODE for a description of the operating mode and the echo switch, and how to set these values. See INITIALIZE VALUATOR 3 for a description of the initial valuator, prompt/echo type, echo volume, and data record contents, and how to set these values.

In the event of an error, the error indicator indicates the error number of the error detected, and no other output data is returned. If no error is detected, the error indicator is set to zero, and the inquired information will be available in the output parameters. Since this is an inquiry function, ERROR HANDLING is not invoked when an error is detected by this function.

ERRORS

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

054Ignoring function, the specified workstation is not open

061Ignoring function, specified workstation is not of category INPUT or OUTIN

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

Museum