SET EDGE REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

SET EDGE REPRESENTATION − define an edge attribute bundle on the workstation.

SYNOPSIS

C Syntax

void
psetedgerep ( ws, index, rep )
Pintws;workstation identifier
Pintindex;edge bundle index
Pedgebundl∗rep;edge representation pointer

FORTRAN Syntax

SUBROUTINE psedr ( WKID, EDI, EDFLAG, EDTYPE, EWIDTH, COLI )
INTEGERWKIDworkstation identifier
INTEGEREDIedge index
INTEGEREDFLAGedge flag (POFF, PON)
INTEGEREDTYPEedgetype
REALEWIDTHedgewidth scale factor
INTEGERCOLIcolour index

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

SET EDGE REPRESENTATION defines a bundle of edge attributes for a specified entry in the workstation’s edge bundle table. Depending on the ASF for each of the edge attributes, the bundled attributes may apply to the following primitives:

• FILL AREA SET

• FILL AREA SET 3

• GENERALIZED DRAWING PRIMITIVE (Fill Area Primitives)

• GENERALIZED DRAWING PRIMITIVE 3 (Fill Area Primitives)

C Input Parameters

wsThe identifier of the workstation for which the edge representation is being defined.

indexThe edge index of the entry being defined.

repA pointer to a structure containing the attribute values defining the edge representation, defined as follows:

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

rep->flag is an enumerated value, specifying whether edges are to be displayed or not. Valid values are:

PEDGE_OFFOff
PEDGE_ONOn

rep->type is an edgetype value, specifying one of the following:

1PLN_SOLIDSolid
2PLN_DASHDashed
3PLN_DOTDotted
4PLN_DOTDASHDot-dashed
0PLN_LONGDASHLong-dashed
-1PLN_DOTDASHDOTDot-dashed-dot-dotted
-2PLN_CENTERCenter (long-short dashed)
-3PLN_PHANTOMPhantom (long-short-short dashed)

Support for edgetypes is workstation dependent. See SET EDGETYPE (3P) for caveats regarding the Center and Phantom edgetypes.

rep->scale is an edgewidth scale factor value.

rep->colour is the edge colour index, which selects a colour value from the workstation’s colour table.

FORTRAN Input Parameters

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

EDIThe edge index of the entry being defined.

EDFLAG
The edge flag is an enumerated value, specifying whether edges are to be displayed or not. Valid values are:

POFFOff
PONOn

EDTYPE
The edgetype specifies one of the following:

1PLSOLISolid
2PLDASHDashed
3PLDOTDotted
4PLDASDDot-dashed
0PLNLONGDASHLong-dashed
-1PLNDOTDASHDOTDot-dashed-dot-dotted
-2PLNCENTERCenter (long-short dashed)
-3PLNPHANTOMPhantom (long-short-short dashed)

Support for edgetypes is workstation dependent. See SET EDGETYPE (3P) for caveats regarding the Center and Phantom edgetypes.

EWIDTH
The edgewidth scale factor value.

COLIThe edge colour index, which selects a colour value from the workstation’s colour table.

Execution

When SET EDGE REPRESENTATION is called, the edge index entry in the table of defined edge representations on the workstation is set to the edge flag, edgetype, edgewidth scale factor, and edge colour index values.

When area-defining output primitives are displayed, the edge representation specified by the ‘current edge index’ entry in the PHIGS traversal state list provides the edge attributes for which the Aspect Source Flag (ASF) is BUNDLED. For example, when the ‘current edgetype ASF’ is set to BUNDLED, the “effective” edgetype is the edgetype attribute in the edge representation selected by the ‘current edge index’. The ‘current edge index’ is set by SET EDGE INDEX elements.

The edge bundle table is numbered from 1.

See GENERALIZED DRAWING PRIMITIVE (3P) and GENERALIZED DRAWING PRIMITIVE 3 (3P) to determine which of the generalized primitives use the fill area set attributes.

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

103Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation bundle table

113Ignoring function, the colour index value is less than zero

107Ignoring function, the specified edge type is not available on the specified workstation

Museum