WORKSTATION TYPE CREATE(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

WORKSTATION TYPE CREATE − create a new workstation type — PEX-SI extension

SYNOPSIS

C Syntax

Pint
phigs_ws_type_create ( base, attributes)
Pintbase;base workstation type
Phigs_ws_type_attrattributes;

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

WORKSTATION TYPE CREATE creates a new workstation type. The new type is a copy of an existing type, possibly changed by any attribute-value pairs specified by the second parameter.

A new workstation type is created by an application to obtain a type with different workstation description table values from those of an existing workstation type. The workstation description table values can be changed by specifying the desired values to this function or by a subsequent call to WORKSTATION TYPE SET, passing it the workstation type created by WORKSTATION TYPE CREATE.

The workstation type returned from this function can be used anywhere a workstation type parameter is specified. When created, it is added to the list of available workstation types in the PHIGS description table.

This is a PEX-SI addition, and is not part of the PHIGS standard.

C Input Parameters

baseAn existing workstation type from which to build the new type.

attributes
A 0 terminated list of workstation type attributes and corresponding values. As described in WORKSTATION TYPE SET, the workstation description table fields of the new workstation type are modified according to the contents of this list.

C Output Parameters

If this function is successful, the new workstation type is returned as the value of this function.

Execution

The third argument to OPEN WORKSTATION is a workstation type. Each workstation type has a workstation description table associated with it, which contains both the PHIGS-specified data describing workstation capabilities and some PEX-SI-specific data describing workstation characteristics. The PEX-SI-specific data, as well as some of the PHIGS data, can be changed by the application prior to opening a workstation. WORKSTATION TYPE SET describes the data that can be changed and how to change it.

PEX-SI supplies a number of predefined workstation types. These are described in OPEN WORKSTATION. The predefined types cannot be operated on by WORKSTATION TYPE SET, their description table values can not be changed. Instead, it is necessary to create a new workstation type, based on one of the predefined types, which can be modified by WORKSTATION TYPE SET. Once created, the new workstation type can be used anywhere that PHIGS calls for a workstation type, including the base type parameter of this function. The new type can be repeatedly edited by WORKSTATION TYPE SET and passed to OPEN WORKSTATION This could be done, for instance, to open workstations with only slightly different description table values. When the type is no longer needed it should be destroyed with WORKSTATION TYPE DESTROY.

If a call to this function is successful the new workstation type will be added to the list of available workstation types in the PHIGS description table.

ERRORS

No Error

Museum