NAME

SET EDGE FLAG − create a structure element to set the current edge flag attribute

SYNOPSIS

C Syntax

void
pset_edge_flag ( edge_flag )
Pedge_flagedge_flag;edge flag

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET EDGE FLAG creates a structure element containing a value for the current edge flag attribute.  When the current edge flag Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute defines whether or not edges are drawn on the following output primitives:

• FILL AREA SET

• FILL AREA SET 3

• FILL AREA SET 3 WITH DATA

• GENERALIZED DRAWING PRIMITIVE (Fill Area Set Primitives)

• GENERALIZED DRAWING PRIMITIVE 3 (Fill Area Set Primitives)

• SET OF FILL AREA SET 3 WITH DATA

• NON-UNIFORM B-SPLINE SURFACE

• QUADRILATERAL MESH 3 WITH DATA

• TRIANGLE STRIP 3 WITH DATA

C Input Parameter

edge_flag
The edge flag is an enumerated type defined in phigs.h to have the following values:

PEDGE_OFFOff
PEDGE_ONOn

Execution

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

When the SET EDGE FLAG element is traversed, the current edge flag entry in the PHIGS traversal state list is set to edge flag.  When the edge flag ASF is set to INDIVIDUAL the edges of the fill area set output primitives that follow in the structure network are drawn when edge flag is On, and are not drawn (the default) when edge flag is Off. 

When the current edge flag ASF is set to BUNDLED, the edge flag setting is taken from the workstation’s representation indicated by the current edge index.  In this case, the edge flag set with SET EDGE FLAG has no effect. 

ERRORS

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

SEE ALSO

SET INDIVIDUAL ASF (3P)
SET EDGE REPRESENTATION (3P)
FILL AREA SET (3P)
FILL AREA SET 3 (3P)
FILL AREA SET 3 WITH DATA (3P+)
SET OF FILL AREA SET 3 WITH DATA (3P+)
NON-UNIFORM B-SPLINE SURFACE (3P+)
QUADRILATERAL MESH 3 WITH DATA (3P+)
TRIANGLE STRIP 3 WITH DATA (3P+)

September 02, 1992