INQUIRE EXTENDED EDGE REPRESENTATION(3P+) — MISC. REFERENCE MANUAL PAGES

NAME

INQUIRE EXTENDED EDGE REPRESENTATION − inquire an extended edge representation on a workstation

SYNOPSIS

C Syntax

void
pinqextedgerep ( wsid, index, type, error_ind, rep )
Pintwsid;workstation identifier
Pintindex;edge index
Pinqtypetype;type of returned value (PSET,PREALIZED)
Pint∗error_ind;OUT error indicator
Pextedgebundl∗rep;OUT extended edge representation

FORTRAN Syntax

SUBROUTINE pqeer ( WKID, INDEX, ITYPE, ERRIND, EFLAG, ETYPE, EWIDTH,
COLMOD, IECOLR, ECOLR )
INTEGERWKIDworkstation identifier
INTEGERINDEXedge bundle index
INTEGERITYPEtype of returned values (PSET,PREALI)
INTEGERERRINDOUT error indicator
INTEGEREFLAGOUT edge flag (PON/POFF)
INTEGERETYPEOUT edge type
REALEWIDTHOUT edge width scale factor
INTEGERCOLMODOUT colour model
INTEGERIECOLROUT indirect colour
REALECOLR(3)OUT array of colour

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE EXTENDED EDGE REPRESENTATION creates an extended edge representation on a workstation.

This is a SunPHIGS Extension function based on PHIGS+ and is not part of the PHIGS standard.

C Input Parameters

All of the following data types are predefined in phigs.h.

wsidThe workstation identifier.

indexThe edge index.

typeAn enumerated value specifying whether the values to be returned are those originally specified by the application (PSET), or those resulting after PHIGS mapped them to ones available on the workstation (PREALIZED). A Pinqtype structure is defined as:

typedef enum {
PSET,
PREALIZED
} Pinqtype;

C Output Parameters

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

repA pointer to a Pextedgebundl structure which returns the specified extended edge representation. Pextedgebundl is defined as:

typedef struct {
Pedgefflag;/∗ edge flag ∗/
Pinttype;/∗ edgetype ∗/
Pfloatscale;/∗ edgewidth scale factor ∗/
Pgcolrcolour;/∗ edge colour ∗/
} Pextedgebundl;

See SET EXTENDED EDGE REPRESENTATION(3P+) for a full description of the contents of this structure.

FORTRAN Input Parameters

All of the following data types are predefined in phigs77.h.

WKIDThe identifier of the workstation for which the extended edge representation is being inquired.

INDEX
The index into the specified workstation edge bundle table.

ITYPE
An enumerated value specifying whether the values to be returned are those originally specified by the application (Set), or those resulting after PHIGS mapped them to ones available on the workstation (Realized). Valid values are:

0PSETSet
1PREALIRealized

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

EFLAG
The edge flag.

ETYPE
The edge type.

EWIDTH
The edge width scale factor.

COLMOD
The colour model.

IECOLR
An integer containing the index into the workstation colour table for the edge colour.

ECOLR(3)
An array of reals containing the edge colour.

Execution

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

If the specified edge index is not present in the edge bundle table on the workstation and the specified type of returned value is Realized, the representation for edge index one is returned.

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 non-availability.

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

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

100Ignoring function, the bundle index value is less than one

101Ignoring function, the specified representation has not been defined

Museum