NAME

INQUIRE DYNAMICS OF WORKSTATION ATTRIBUTES PLUS - inquire for the dynamics of PHIGS PLUS workstation attributes for a workstation type

SYNOPSIS

C Syntax

void

pinq_dyns_ws_attrs_plus ( type, error_ind, attr )

Pint                    type;         workstation type
Pint                    * error_ind;  OUT error indicator
Pdyns_ws_attrs_plus     * attr;       OUT attribute dynamics

FORTRAN Syntax

SUBROUTINE pqdwap ( WTYPE, ERRIND, LIGHTR, DCUER, CMAPR )

INTEGER      WTYPE       workstation type
INTEGER      ERRIND      OUT error indicator
INTEGER      LIGHTR      OUT light source representation changeable
INTEGER      DCUER       OUT depth cue representation changeable
INTEGER      CMAPR       OUT colour mapping representation changeable

Required PHIGS Operating States

(PHOP, * ,* ,* )

DESCRIPTION

Purpose

INQUIRE DYNAMICS OF WORKSTATION ATTRIBUTES PLUS determines the dynamics of PHIGS PLUS workstation attributes for a specified workstation type.

C Input Parameter

type

The workstation type whose capabilities are inquired.

C Output Parameters

error_ind

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

attr

A pointer to a structure in which the system returns the dynamic modification accepted values for various workstation attributes. Pdyns_ws_attrs_plus is defined in phigs.h as follows:

typedef struct {

Pdyn_mod        light_src_rep;      /* light source representation * /
Pdyn_mod        depth_cue_rep;      /* depth cue representation * /
Pdyn_mod        colr_map_rep;       /* colour mapping

representation * /

} Pdyns_ws_attrs_plus;

The Pdyn_mod is an enumeration defined in phigs.h as follows:

typedef enum {

PDYN_IRG,

/* modification leads to an Implicit Regeneration * /

PDYN_IMM,

/* modification is performed Immediately, without an

implicit regeneration * /

PDYN_CBS

/* modification Can Be Simulated before an implicit

regeneration is permitted * /

} Pdyn_mod;

FORTRAN Input Parameter

WTYPE The workstation type whose capabilities are being inquired.

FORTRAN Output Parameters

ERRIND

The error number of any error detected by this function.

LIGHTR

The dynamic modification accepted value for light source representation changes. This argument can return any of the following values defined in phigs77.h:

PIRG

modification leads to Implicit Regeneration.

PIMM

modification is performed Immediately, without implicit

regeneration.

PCBS

modification Can Be Simulated before an implicit regeneration is permitted.

DCUER

The dynamic modification accepted value for depth cue representation changes. The value returned may be any of PIRG, PIMM, or PCBS, defined above.

CMAPR

The dynamic modification accepted value for colour mapping representation changes. The value returned can be any of PIRG, PIMM, or PCBS, defined above.

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 following 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

002

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

051

Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

052

Ignoring function, workstation type not recognized by the implementation

059

Ignoring function, the specified workstation does not have output capability (that is, the workstation category is not OUTPUT or OUTIN)

062

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

SEE ALSO

INQUIRE DYNAMICS OF WORKSTATION ATTRIBUTES (3P)

PHIGS WORKSTATION DESCRIPTION TABLE (7P)