INQUIRE EXTENDED WORKSTATION STATE TABLE LENGTHS(3P+) — MISC. REFERENCE MANUAL PAGES

NAME

INQUIRE EXTENDED WORKSTATION STATE TABLE LENGTHS − inquire the lengths of the extended workstation state tables for a specified workstation type

SYNOPSIS

C Syntax

void
pinqextwssttable ( wstype, error_ind, lengths )
Pwstypewstype;workstation type
Pint∗error_ind;OUT error indicator
Pextwstables∗lengths;OUT lengths of the workstation’s tables

FORTRAN Syntax

SUBROUTINE pqewtl ( WKTYPE, ERRIND, PLINE, PMARK, TEXT, INTER, EDGE, PAT, COLR,
VIEW, GENINT, DCUE, LTSRC, CLRMAP, CULL )
INTEGERWKTYPEworkstation type
INTEGERERRINDOUT error indicator
INTEGERPLINEOUT polyline tables
INTEGERPMARKOUT polymarker tables
INTEGERTEXTOUT text tables
INTEGERINTEROUT interior tables
INTEGEREDGEOUT edge tables
INTEGERPATOUT pattern tables
INTEGERCOLROUT colour tables
INTEGERVIEWOUT view tables
INTEGERGENINTOUT general interior tables
INTEGERDCUEOUT depth cue tables
INTEGERLTSRCOUT light source tables
INTEGERCLRMAPOUT colour mapping tables
INTEGERCULLOUT cull size tables

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE EXTENDED WORKSTATION STATE TABLE LENGTHS inquires the lengths of the extended workstation state tables for a specified workstation type.

This is a SunPHIGS Extension function based on PHIGS+ and is not part of the PHIGS standard.

C Input Parameters

All of the following data types are predefined in phigs.h.

wstypeThe workstation type in question.

C Output Parameters

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

lengths
A pointer to a Pextwstables structure which returns the lengths of the workstation’s tables. Pextwstables is defined as:

typedef struct {
Pintline;/∗ polyline table length ∗/
Pintmark;/∗ polymarker table length ∗/
Pinttext;/∗ text table length ∗/
Pintinterior;/∗ interior table length ∗/
Pintedge;/∗ edge table length ∗/
Pintpat;/∗ pattern table length ∗/
Pintcolour;/∗ colour table length ∗/
Pintview;/∗ view table length ∗/
Pintgeninterior;/∗ general interior table length ∗/
Pintdcue;/∗ depth cue table length ∗/
Pintlightsrc;/∗ light source table length ∗/
Pintcolourmap;/∗ colour mapping table length ∗/
Pintcull;/∗ cull size table length ∗/
} Pextwstables;

FORTRAN Input Parameters

WKTYPE
The workstation type.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

PLINE
The number of extended polyline bundle table entries.

PMARK
The number of extended polymarker bundle table entries.

TEXTThe number of extended text bundle table entries.

INTER
The number of extended interior bundle table entries.

EDGEThe number of extended edge bundle table entries.

PATThe number of extended pattern bundle table entries.

COLRThe number of colour table entries.

VIEWThe number of view table entries.

GENINT
The number of general interior table entries.

DCUEThe number of depth cue table entries.

LTSRC
The number of light source table entries.

CLRMAP
The number of colour mapping table entries.

CULLThe number of cull size table entries.

Execution

If the inquired information is available, the error indicator is returned as zero and values are returned in the output parameters.

If the inquired information is not available, the values returned in the output parameters are undefined and the error indicator is set to one of the below error numbers to indicate the reason for nonavailability.

Since this is an inquiry function, ERROR HANDLING is not invoked when an error is detected by this function.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

051Ignoring function, this information unavailable for this workstation type

052Ignoring function, workstation type not recognized by the implementation

062Ignoring function, this information is not available for this MO workstation type

Museum