POLYLINE

PPL

CALL SEQUENCE

CALL PPL (N, PXA, PYA)

INPUT PARAMETERS

INTEGER N

Number of points.

REAL PXA(N), PYA(N)

Point coordinates (MC).

PHIGS STATE

EFFECT

This function limits the 3D polyline function to 2D (x, y). The Z coordinate is set to 0.

The POLYLINE element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on the edit mode value. Element pointer is updated and points to the POLYLINE structure element. The values specified in the function are associated with the element.

When an element of this type is interpreted, a series of adjacent straight line segments is generated from the first to the last point in the list. The current polyline attributes defined in the PHIGS traversal state list are applied to the polyline. A polyline with less than two points is placed in the open structure, but has no visual effect when interpreted.

Attributes associated with Polyline:

LINETYPE

LINEWIDTH SCALE FACTOR

POLYLINE COLOUR

EXTENSION TO THE PHIGS STANDARD

If used in NRS mode, the effect of this function is different from the effect described in the standard.

In NRS mode, (see OPEN PIPE), the element is not stored in a structure. It is sent to the workstation on which the pipe is opened.

ERRORS

5

Ignoring function, function requires state (PHOP,*, STOP,*)

SEE ALSO

open structure, open pipe (ext), set polyline index, set linetype, set linewidth scale factor, set polyline colour, set polyline colour index, polyline 3, inquire current element content, inquire current element type and size