PPLS3C(3g) — Subroutines

Name

PPLS3C − Generates a set of unconnected 3D polylines, where color information can be specified for each vertex.

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

Old Syntax

DPLSD3 (VTXFLG, CLRTYP, NLINES, NPTS, PXA, PYA, PZA, IVCOL, VCOL)

Argument        Data Type      Access      Description
-------------------------------------------------------------------------
VTXFLG          Integer        Read        Data per vertex flag
CLRTYP          Integer        Read        Type of color data
NLINES          Integer        Read        Number of polyline sets
NPTS(NLINES)    Array of       Read        Array of end indexes for the
                integers                   vertex lists
PXA(∗),
PYA(∗),
PZA(∗)          Array of       Read        Vertex list
                reals
IVCOL(∗)        Array of       Read        Vertex indexed color list
                integers
VCOL(∗)         Array of       Read        Vertex direct color list
                reals                      (r,g,b,r,g,b)
-------------------------------------------------------------------------

New Syntax

PPLS3C (VFLAG, CTYPE, NCC, NPL, IXA, PXA, PYA, PZA, VCOLI, VCOLR)

Argument        Data Type      Access    Description
-------------------------------------------------------------------------
VFLAG           Integer        Read      Data per vertex flag
CTYPE           Integer        Read      Type of color data
NCC             Integer        Read      Number of color value components
NPL             Integer        Read      Number of point lists
IXA(NPL)        Array of       Read      Array of end indexes for the
                integers                 point lists
PXA(IXA(NPL)), Array of       Read      Coordinates of the points, in
PYA(IXA(NPL)), reals                    modeling coordinates
PZA(IXA(NPL))
VCOLI(IPX       Array of       Read      List of vertex color indexes
(NPL))          integers
VCOLR(NCC∗      Array of       Read      Vertex color values
IXA(NPL))       reals
-------------------------------------------------------------------------

Constants

Defined Argument     Constant      Description
-------------------------------------------------------------------------
VFLAG                PCD           Coordinates only
                     PCDC          Color per vertex

CTYPE                PINDIR        Indirect (indexed) color
                     PRGB          Direct specification of red, green,
                                   and blue
                     PCIE          Direct specification in the format of
                                   the Commission Internationale de
                                   l’Eclairage
                     PHSV          Direct specification of hue, saturation,
                                   and value
                     PHLS          Direct specification of hue, lightness,
                                   and saturation
-------------------------------------------------------------------------

Description

PPLS3C generates a set of unconnected polylines, where color information can be specified for each vertex.

Depending on the 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 set 3 with color element.

If the data per vertex flag indicates that you have specified a color per vertex, you must also have specified a color type for this primitive.

A point sequence with less than two points is considered degenerate and is treated in an implementation-dependent manner.

During structure traversal, Digital PHIGS generates an unconnected set of sequences of connected straight lines, starting from the first vertex coordinate point of each sequence and ending at the last vertex coordinate point for each sequence.

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

The new function syntax conforms to the ISO Fortran standard. Digital recommends that you code using the new function syntax.