NAME

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

SYNOPSIS

C Syntax

void

pinq_ws_st_table_plus ( type, error_ind, lengths )

Pint               type;         workstation type
Pint               * error_ind;  OUT error indicator
Pws_tables_plus    * lengths;    OUT lengths of the workstation tables

FORTRAN Syntax

SUBROUTINE pqewtl ( WKTYPE, ERRIND, PLINE, PMARK, TEXT, INTER, EDGE, PAT, COLR, VIEW, GENINT, DCUE, LTSRC, CLRMAP, CULL )

INTEGER      WKTYPE       workstation type
INTEGER      ERRIND       OUT error indicator
INTEGER      PLINE        OUT polyline tables
INTEGER      PMARK        OUT polymarker tables
INTEGER      TEXT         OUT text tables
INTEGER      INTER        OUT interior tables
INTEGER      EDGE         OUT edge tables
INTEGER      PAT          OUT pattern tables
INTEGER      COLR         OUT colour tables
INTEGER      VIEW         OUT view tables
INTEGER      GENINT       OUT general interior tables
INTEGER      DCUE         OUT depth cue tables
INTEGER      LTSRC        OUT light source tables
INTEGER      CLRMAP       OUT colour mapping tables
INTEGER      CULL         OUT cull size tables

Required PHIGS Operating States

(PHOP, * ,* ,* )

DESCRIPTION

Purpose

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

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

C Input Parameter

type

The workstation type in question.

C Output Parameters

error_ind

A pointer to the location to store the error number of any error that this function detects.

lengths A pointer to a Pws_tables_plus structure, which returns the lengths of the

workstation's tables. Pws_tables_plus is defined in phigs.h as follows:

typedef struct {

Pint    line_bundles;   /* polyline tables * /
Pint    mark_bundles; /* polymarker tables * /
Pint    text_bundles;   /* text tables * /
Pint    int_bundles;    /* interior tables * /
Pint    edge_bundles; /* edge tables * /
Pint    pat_reps;       /* pattern tables * /
Pint    colr_reps;      /* colour tables * /
Pint    view_reps;      /* view tables * /
Pint    dcue_rep;       /* depth cue tables * /
Pint    light_src_rep;  /* light source tables * /
Pint    colr_map_rep; /* colour mapping tables * /

} Pws_tables_plus;

FORTRAN Input Parameter

WKTYPE

The workstation type.

FORTRAN Output Parameters

ERRIND

The error number of any error that this function detects.

PLINE

The number of extended polyline bundle table entries.

PMARK

The number of extended polymarker bundle table entries.

TEXT

The number of extended text bundle table entries.

INTER

The number of extended interior bundle table entries.

EDGE

The number of extended edge bundle table entries.

PAT

The number of extended pattern bundle table entries.

COLR

The number of colour table entries.

VIEW

The number of view table entries.

GENINT

The number of general interior table entries.

DCUE

The number of depth cue table entries.

LTSRC The number of light source table entries.

CLRMAP

The number of colour mapping table entries.

CULL

The number of cull size table entries.

Execution

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

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

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

ERRORS

002

Ignoring function, function requires state (PHOP, * ,* ,* )

051

Ignoring function, this information unavailable for this workstation type

052

Ignoring function, workstation type not recognized by the implementation

062

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

SEE ALSO

INQUIRE WORKSTATION STATE TABLE LENGTHS (3P)

PHIGS WORKSTATION DESCRIPTION TABLE (7P)