NAME

SET POLYLINE INDEX − create structure element containing polyline index attribute

SYNOPSIS

C Syntax

void
pset_line_ind ( index )
Pintindex;polyline index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET POLYLINE INDEX creates a structure element containing a polyline index number, which selects an entry from the workstation’s polyline bundle table.  This attribute applies to the output primitives:

• POLYLINE

• POLYLINE 3

• POLYLINE SET 3 WITH DATA

• NON-UNIFORM B-SPLINE CURVE

• ANNOTATION TEXT RELATIVE (when “connected” style is in use)

• ANNOTATION TEXT RELATIVE 3 (when “connected” style is in use)

• CELL ARRAY (when minimal simulation is performed)

• CELL ARRAY 3 (when minimal simulation is performed)

C Input Parameter

indexA polyline index for a polyline representation on the workstation. 

Execution

If the current edit mode is INSERT, a SET POLYLINE 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, the new SET POLYLINE 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. 

When the SET POLYLINE INDEX element is traversed, the current polyline index value is set to the polyline index, which specifies an entry from the workstation’s polyline bundle table.  The default polyline index is 1, and if the polyline index specified is not available on the workstation, 1 will be used. 

A polyline representation contains values for the following attributes:

•  linetype
•  linewidth scale factor
•  polyline colour

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

Polyline representations are defined with SET POLYLINE REPRESENTATION. 

ERRORS

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

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

SEE ALSO

SET INDIVIDUAL ASF (3P)
SET POLYLINE REPRESENTATION (3P)
SET POLYLINE REPRESENTATION PLUS (3P+)

September 02, 1992