INQUIRE DYNAMICS OF WORKSTATION PLUS(3P+) — Kubota Pacfic Computer Inc. (29 February 1991)
NAME
INQUIRE DYNAMICS OF WORKSTATION PLUS − inquire the dynamics of PHIGS PLUS workstation attributes for a workstation type
SYNOPSIS
C Syntax
void
pinq_dyns_ws_attrs_plus ( type, error_ind, attr )
Pinttype;workstation type
Pint∗error_ind;OUT error indicator
Pdyns_ws_attrs_plus∗attr; OUT attribute dynamics
Required PHIGS Operating States
(PHOP, ∗, ∗, ∗)
DESCRIPTION
Purpose
Use INQUIRE DYNAMICS OF WORKSTATION PLUS to determine dynamics of PHIGS PLUS workstation attributes for a specified workstation type.
C Input Parameters
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 detected by this function.
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_modlight_src_rep; /∗ light source representation ∗/
Pdyn_moddepth_cue_rep; /∗ depth cue representation ∗/
Pdyn_modcolr_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;
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
002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)
051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type
052Ignoring function, workstation type not recognized by the implementation
059Ignoring function, the specified workstation does not have output capability (that is, the workstation category is not OUTPUT or OUTIN)
062Ignoring function, this information is not available for this MO workstation type
SEE ALSO
INQUIRE DYNAMICS OF WORKSTATION ATTRIBUTES (3P)
PHIGS WORKSTATION DESCRIPTION TABLE (7P)
September 02, 1992