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

NAME

SET EDGE INDEX − create a structure element containing an edge representation index attribute

SYNOPSIS

C Syntax

void
pset_edge_ind ( index )
Pintindex;edge index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET EDGE INDEX creates a structure element containing an edge index number that selects an entry from the workstation’s edge bundle table. This attribute applies to the output 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

• QUADRILATERAL MESH 3 WITH DATA

• TRIANGLE STRIP 3 WITH DATA

If the current edit mode is INSERT, a SET EDGE INDEX element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, then the new SET EDGE INDEX element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

C Input Parameter

indexAn edge index for edge representation on the workstation.

Execution

When the SET EDGE INDEX element is traversed, the current edge index value is set to the edge index that specifies an entry from the workstation’s edge bundle table. The default edge index is 1, and if the edge index specified is not available on the workstation, then 1 is used.

An edge representation contains values for the following attributes:

• edge flag

• edgetype

• edgewidth scale factor

• edge colour index

FILL AREA output primitives, which follow in the structure network, use the values from the specified representation for those edge attributes whose Aspect Source Flag (ASF) is set to BUNDLED. When the ASFs are INDIVIDUAL, the attributes come from the appropriate SET attribute elements.

Edge representations are defined with SET EDGE REPRESENTATION.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

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

Museum