Name

PPL − Draws the 2D form of a straight line. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

Syntax

PPL (N, PXA, PYA)

Argument        Data Type      Access    Description
-------------------------------------------------------------------------
N               Integer        Read      Number of points specified for
                                         the line
PXA(N), PYA(N)  Array of       Read      Array of points, in modeling
                reals                    coordinates
-------------------------------------------------------------------------

Description

PPL draws the two-dimensional form of a straight line by connecting the modeling coordinate points in the list of points.  Its z-coordinate value is 0. 

Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new polyline element. 

By default, the function generates a solid line of nominal width and in the foreground color dictated by the workstation.  You use the polyline attribute functions to change these default attributes. 

The PPL function specifies the two-dimensional (x and y) form of the polyline primitive.  A call to the function has the following effects during structure traversal:

•Digital PHIGS generates a straight line by connecting the specified points, starting with the first point and ending with the last point in the list. 

•Digital PHIGS binds the current values of the polyline attributes, as defined in the PHIGS traversal state list, to the polyline primitive. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

PADS
PQPLF
PPL3
PPLS3C
PRES
PSDCI
PSHRID
PSIASF
PSLN
PSLWSC
PSPKID
PSPLC
PSPLCI
PSPLI
PSPLSM
PSVWI