GPHIGS C FUNCTIONS - INQUIRE INTERIOR REPRESENTATION

INQUIRE INTERIOR REPRESENTATION

PINQ_INT_REP

CALL SEQUENCE

void pinq_int_rep(

Pint	ws_id,	/* workstation identifier	*/
Pint	index,	/* interior index	*/
Pinq_type	return_type,	/* type of returned value	*/
Pint	*error_ind,	/* (out) error indicator	*/
Pint_bundle	*int_rep	/* (out) interior representation	*/

TYPES

typedef enum {
	PINQ_SET, 
	PINQ_REALIZED
} Pinq_type ;

typedef struct {
	Pint_style	style;	/* interior style 	*/
	Pint	style_ind;	/* interior style index 	*/
	Pint	colr_ind;	/* interior colour index 	*/
} Pint_bundle;

typedef enum {
	PSTYLE_HOLLOW,
	PSTYLE_SOLID,
	PSTYLE_PAT,
	PSTYLE_HATCH,
	PSTYLE_EMPTY
} Pint_style;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Returns the components contained in the specified interior representation of the interior table in workstation ws_id's workstation state list. If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters.

If the specified interior index is not present in the interior bundle table, and the specified type of returned value is REALIZED, the representation for interior index 1 is returned.

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability:

ERRORS

3: Ignoring function, function requires state (PHOP, WSOP,*,*)
54: Ignoring function, the specified workstation is not open
59: Ignoring function, the specified workstation does not have output capability (i.e. the workstation category is neither OUTPUT, OUTIN, nor MO)
100: Ignoring function, the bundle index value is less than one
101: Ignoring function, the specified representation has not been defined