INQUIRE VIEW REPRESENTATION(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE VIEW REPRESENTATION − inquire a view representation on a workstation

SYNOPSIS

C Syntax

void
pinq_view_rep ( ws, view_index, error_ind, update_state, cur_rep, req_rep )
Pintws;workstation identifier
Pintview_index;view index
Pint∗error_ind;OUT error indicator
Pupd_st∗update_state;OUT transformation update state
Pview_rep3∗cur_rep;OUT current view representation
Pview_rep3∗req_rep;OUT requested view representation

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE VIEW REPRESENTATION to obtain the current and requested view representation in an entry of the specified workstation’s view table.

C Input Parameters

wsThe workstation identifier of the workstation whose state list is queried.

view_index
The view index whose representation is desired from the workstation’s table of defined view representations.

C Output Parameters

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

update_state
A pointer to a location in which the system returns the view transformation update state. Pupd_st is an enumerated type defined in phigs.h as follows:

typedef enum {
PUPD_NOT_PEND,/∗ Not Pending ∗/
PUPD_PEND/∗ Pending ∗/
} Pupd_st;

cur_rep
A pointer to a Pview_rep3 structure in which the system returns the definition of the current view representation.

req_rep
A pointer to a Pview_rep3 structure in which the system returns the definition of the requested view representation.

Pview_rep3 is defined in phigs.h as follows:

typedef struct {
        Pmatrix3ori_matrix;/∗ view orientation matrix ∗/
        Pmatrix3map_matrix;/∗ mapping matrix ∗/
        Plimit3clip_limit;/∗ clipping limits ∗/
        Pclip_indxy_clip;/∗ X-Y clipping indicator ∗/
        Pclip_indback_clip;/∗ back clipping indicator ∗/
        Pclip_indfront_clip;/∗ front clipping indicator ∗/
} Pview_rep3;

The Pmatrix3 type definition is a 4x4 matrix, defined in phigs.h as: typedef Pfloat Pmatrix3[4][4]; The Plimit3 structure used to define the clipping limits is defined in phigs.h as follows:

typedef struct {
Pfloatx_min;/∗ x min ∗/
Pfloatx_max;/∗ x max ∗/
Pfloaty_min;/∗ y min ∗/
Pfloaty_max;/∗ y max ∗/
Pfloatz_min;/∗ z min ∗/
Pfloatz_max;/∗ z max ∗/
} Plimit3;

Pclip_ind is an enumerated type defined in phigs.h as follows:

typedef enum {
PIND_CLIP,/∗ Clipping ∗/
PIND_NO_CLIP /∗ Not Clipping ∗/
} Pclip_ind;

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

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

114Ignoring function, the view index value is less than zero

101Ignoring function, the specified representation has not been defined

Museum