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

GPINVL - Initialize Valuator

GPINVL (wsid, device, ivalue, echo, area, lovalue, hivalue, datalen, data)

Purpose

Use GPINVL to initialize the specified valuator device.

The Initialize Valuator subroutine stores the initial value, prompt/echo type, echo area, and valuator data record in the WSL entry for the specified workstation.

For all valuator prompt/echo types a low value and a high value specify the range for input from that valuator. The values from the physical device are scaled linearly to the specified range.

Note:

The valuator device must be in Request mode.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier of the device to be initialized.

device -- specified by user, fullword integer

Valuator device number to be initialized (>=1)

ivalue -- specified by user, short floating-point number

Initial value.

echo -- specified by user, fullword integer

Prompt/echo type (>=1)

area -- specified by user, 6 short floating-point numbers (DC)

Echo area (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax)

lovalue -- specified by user, short floating-point number

Low end of range for valuator.

hivalue -- specified by user, short floating-point number

High end of range for valuator.

datalen -- specified by user, fullword integer

Data record length, in bytes (>=0)

Note:

The data record length parameter must equal zero (datalen=0) if no data record is required for the given prompt/echo type. For prompt/echo types which require a data record, the specified data record length must be greater than, or equal to, 12.

data -- specified by user, variable data

Valuator data record.

Prompt/echo Types

  • Type One designates the current valuator value using a workstation-dependent technique.

  • Type Three displays a digital representation of the current valuator value within the echo area.

  • Type Four passes a data record containing the number of turns of the dial to be mapped onto the specified valuator range. The current valuator value is designated using a workstation-dependent technique.

    Valuator echo Type Four requires the following data record:

                       ----------------------------
                0  |            1             | Number of integers
                   |--------------------------|
                4  |            0             | Number of reals
                   |--------------------------|
                8  |            0             | Number of strings
                   |--------------------------|
    integer 12 --> |    number of turns       |
                   ----------------------------

    Note: For emulation purposes, one turn of the dial equals one unit of physical motion.

    • Error Codes

    25
    SPECIFIED WORKSTATION DOES NOT EXIST
    140
    DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
    141
    INPUT DEVICE NOT IN CORRECT MODE
    144
    PROMPT/ECHO TYPE NOT AVAILABLE ON WORKSTATION
    145
    ECHO AREA BOUNDARY VALUE IN ERROR
    146
    FIELD IN INPUT DEVICE DATA RECORD IN ERROR
    324
    PROMPT/ECHO TYPE < ONE
    501
    DATA RECORD WAS NOT SPECIFIED BUT IS REQUIRED
    502
    FIELD IN DATA RECORD NOT SUPPORTED ON WORKSTATION
    509
    DATA LENGTH VALUE < ZERO OR REQUIRED LENGTH
    511
    INVALID VALUATOR RANGE
    515
    INITIAL VALUATOR VALUE NOT WITHIN RANGE

    Related Subroutines

    GPQDVL
    Inquire Default Valuator Device Data
    GPQVL
    Inquire Valuator Device State
    GPVLMO
    Set Valuator Mode

    RCP code

    201335299 (X'0C002203')

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