INQUIRE PREDEFINED EDGE REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE PREDEFINED EDGE REPRESENTATION − inquire a predefined edge representation for a workstation type

SYNOPSIS

C Syntax

void
pinqprededgerep ( type, index, error_ind, bundle )
Pwstypetype;workstation type
Pintindex;predefined index
Pint∗error_ind;OUT error indicator
Pedgebundl∗bundle;OUT predefined edge rep

FORTRAN Syntax

SUBROUTINE pqpedr ( WTYPE, PEDI, ERRIND, EDFLAG, EDTYPE, EWIDTH, COLI )
INTEGERWTYPEworkstation type
INTEGERPEDIpredefined edge index
INTEGERERRINDOUT error indicator
INTEGEREDFLAGOUT edge flag (POFF, PON)
INTEGEREDTYPEOUT edgetype
REALEWIDTHOUT edgewidth scale factor
INTEGERCOLIOUT edge colour index

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE PREDEFINED EDGE REPRESENTATION to determine the predefined edge representation for a specified workstation type at a given edge index.

C Input Parameters

type
Type of workstation.

index
Entry to be returned from the workstation table of predefined edge representations.

C Output Parameters

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

bundleA pointer to a Pedgebundl structure in which the system returns the edge representation at index in the workstation table of predefined edge representations. Pedgebundl is defined in phigs.h as:

typedef struct {
Pedgefflag;/∗ edge flag ∗/
Pinttype;/∗ edge type ∗/
Pfloatscale;/∗ edge width scale factor ∗/
Pintcolour;/∗ edge colour index ∗/
} Pedgebundl;

Valid values for the Pedgef enumerated type are defined in phigs.h as:

PEDGE_OFF
PEDGE_ON

FORTRAN Input Parameters

WTYPE
Type of workstation.

PEDI
Entry to be returned from the workstation table of predefined edge representations.

FORTRAN Output Parameters

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

EDFLAG
The edge flag value at index PEDI in the workstation table of predefined edge representations. Valid values for the edge flag are defined in phigs77.h as:

POFF
PON

EDTYPE
The edge type at index PEDI in the workstation table of predefined edge representations.

EWIDTH
The edge width scale factor at index PEDI in the workstation table of predefined edge representations.

COLIThe edge colour index at index PEDI in the workstation table of predefined edge representations.

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 (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

062Ignoring function, this information is not available for this MO workstation type

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

102Ignoring function, the specified representation has not be predefined on this workstation

Museum