NAME

SET EDGEWIDTH SCALE FACTOR − create structure element to set the current edgewidth scale factor attribute

SYNOPSIS

C Syntax

void
pset_edgewidth ( scale )
Pfloatscale;edgewidth scale factor

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET EDGEWIDTH SCALE FACTOR creates a structure element containing a value for the current edgewidth scale factor attribute.  When the current edgewidth scale factor Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute defines the current edgewidth applied to the output primitives:

• FILL AREA SET

• FILL AREA SET 3

• FILL AREA SET 3 WITH DATA

• GENERALIZED DRAWING PRIMITIVE (Fill Area Primitives)

• GENERALIZED DRAWING PRIMITIVE 3 (Fill Area 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 Parameter

scaleA real value specifying the edgewidth scale factor. 

Execution

If the current edit mode is INSERT when SET EDGEWIDTH SCALE FACTOR is called, a SET EDGEWIDTH SCALE FACTOR 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 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 EDGEWIDTH SCALE FACTOR element is traversed, the current edgewidth scale factor entry in the traversal state list is set to edgewidth scale factor. 

When the edge flag is set to ON and the current edgewidth scale factor ASF is set to INDIVIDUAL, the edges of the fill area output primitives that follow in the structure network are drawn with the edgewidth specified. 

If the edge flag is OFF, these primitives are drawn without edges and only the interior fill is displayed.  When the edge flag is ON and the edgewidth scale factor ASF is set to BUNDLED, the edgewidth scale factor is taken from the workstation’s representation indicated by the current edge index.  In this case, the edgewidth value set with SET EDGEWIDTH SCALE FACTOR has no effect. 

The width of the edge drawn is determined by applying the current edgewidth scale factor to the nominal edgewidth, and this result is then mapped to the nearest edgewidth supported on the workstation. 

ERRORS

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

SEE ALSO

SET EDGE FLAG (3P)
SET INDIVIDUAL ASF (3P)
SET EDGE REPRESENTATION (3P)

September 02, 1992