NAME

WORKSTATION TYPE CREATE - create a new workstation type − SunPHIGS extension

SYNOPSIS

C Syntax

Pwstype
phigs_ws_type_create ( base_type, <attribute-value list> )
Pwstypebase_type;base workstation type
<attribute-value list>;

FORTRAN Syntax

SUBROUTINE phigswstcreate ( BASEWST, NEWWST )
INTEGERBASEWSTbase workstation type
INTEGERNEWWSTnew workstation type

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 and has the same characteristics.  This new type can be operated on by WORKSTATION TYPE SET to modify its workstation description table.  See OPEN WORKSTATION for a description of the predefined workstation types and their characteristics.  The workstation description table associated with the new type will be a copy of the one associated with the base type passed as the first argument to this function (unless changed by attributes specified in the C version of the call). 

A 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 WORKSTATION TYPE SET. 

The workstation type returned from this function can be used anywhere a workstation type is called for and is added to the list of available workstation types in the PHIGS description table. 

This is a SunPHIGS addition, and is not part of the PHIGS standard. 

C Parameters

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

base_type
An existing workstation type from which to build the new type.

<attribute-value list>
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. 

FORTRAN Parameters

BASEWST
An existing workstation type from which to build the new type.

NEWWST
The new workstation type.  WORKSTATION TYPE SET is used to change the workstation description table fields of this new type. 

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 SunPHIGS-specific data describing workstation characteristics.  The SunPHIGS-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. 

SunPHIGS supplies a number of predefined workstation types.  They are described in OPEN WORKSTATION.  These predefined types can not be operated on by WORKSTATION TYPE SET function, i.e., 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 argument of this function.  The new type can be repeatedly edited by WORKSTATION TYPE SET and passed to OPEN WORKSTATION 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

SEE ALSO

WORKSTATION TYPE DESTROY (3P)
WORKSTATION TYPE GET (3P)
WORKSTATION TYPE SET (3P)
OPEN WORKSTATION (3P)
INQUIRE LIST OF AVAILABLE WORKSTATION TYPES (3P)
INQUIRE WORKSTATION CONNECTION AND TYPE (3P)
PHIGS WORKSTATION DESCRIPTION TABLE(7)

Sun Release 4.0  —  Last change: 8 July 1989