GPHIGS C FUNCTIONS - INQUIRE EDGE REPRESENTATION

INQUIRE EDGE REPRESENTATION

PINQ_EDGE_REP

CALL SEQUENCE

void pinq_edge_rep(

Pint	ws_id,	/* workstation identifier	*/
Pint	index,	/* edge index	*/
Pinq_type	return_type,	/* type of returned value	*/
Pint	*error_ind,	/* (out) error indicator	*/
Pedge_bundle	*edge_rep	/* (out) edge representation	*/

TYPES

typedef enum {
	PINQ_SET, 
	PINQ_REALIZED
} Pinq_type ;

typedef struct {
	Pedge_flag	flag;	/* edge flag	*/
	Pint	type;	/* edge type 	*/
	Pfloat	width;	/* edgewidth scale factor 	*/
	Pint	colr_ind;	/* edge colour index	*/
} Pedge_bundle;

typedef enum {
	PEDGE_OFF,
	PEDGE_ON
} Pedge_flag;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Returns the components contained in the edge representation of the edge table in workstation ws_id's workstation state list. If the data is available, error indicator is returned as 0.

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

If the specified edge index is not present in the edge bundle table, and the specified type of returned value is REALIZED, the representation for edge 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