Name

PPL3 − Draws the 3D form of a straight line. 

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

Syntax

PPL3 (N, PXA, PYA, PZA)

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

Description

PPL3 draws the three-dimensional form of a straight line by connecting the modeling coordinate points in the list of points. 

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 3 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 3 functions to change these default attributes. 

The PPL3 function specifies the three-dimensional (x, y, and z) 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 3 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
PPL
PPLS3C
PRES
PSDCI
PSHRID
PSIASF
PSLN
PSLWSC
PSPKID
PSPLC
PSPLCI
PSPLI
PSPLSM
PSVWI