SET EDGE REPRESENTATION(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

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

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 Set Primitives)

• GENERALIZED DRAWING PRIMITIVE 3 (Fill Area Set Primitives)

• NON-UNIFORM B-SPLINE SURFACE

• SET OF FILL AREA SET 3 WITH DATA

• QUADRILATERAL MESH 3 WITH DATA

• TRIANGLE STRIP 3 WITH DATA

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 {
Pedge_flagflag;/∗ edge flag ∗/
Pinttype;/∗ edgetype ∗/
Pfloatwidth;/∗ edgewidth scale factor ∗/
Pintcolr_ind;/∗ edge colour index ∗/
} Pedge_bundle;

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 enumerated value, specifying one of the following:

1PLINE_SOLIDSolid
2PLINE_DASHDashed
3PLINE_DOTDotted
4PLINE_DOT_DASHDot-dashed

Support for edgetypes is workstation-dependent.

rep→width is an edgewidth scale factor value.

rep→colr_ind is the 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 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 (in other words, 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