NAME

DoPolyline  − Create a connected line segment primitive object

SYNOPSIS

C:

DtObject DoPolyline(colormodel, vertextype, vertexcount,
vertices)
DtColorModel colormodel;
DtVertexType vertextype;
DtInt vertexcount;
DtReal vertices[];

FORTRAN:

INTEGER∗4 DOPL(COLMOD, VTXTYP, VTXCNT,
VTXS)
INTEGER∗4 COLMOD
INTEGER∗4 VTXTYP
INTEGER∗4 VTXCNT
REAL∗8 VTXS(∗)

DESCRIPTION

DoPolyline creates a primitive object that defines a collection of vertices connected into a continuous set of line segments. 

The parameter colormodel specifies the color model used if the vertices contain color information for shading purposes.  The parameter vertextype specifies the exact nature of the vertices.  FORTRANr more information, refer to Chapter 6, Doré Vertex Types, in the Doré Reference Manual or to the VertexTypes on-line manual page.) 

The parameter vertexcount contains the number of vertices; there must be at least two.  The parameter vertices is an array of vertices.  Vertices are listed in the order in which they connect.  Polylines may be circular, interconnected, or may reconnect the same pair of vertices multiple times. 

ERRORS

DoPolyline will error if vertexcount is less than two. 

[WARNING - invalid parameter]

SEE ALSO

DoLineList(3D), DoLineWidth(3D), DoLineType(3D), VertexTypes(3D)

September 02, 1992