NAME

DoVarLineList − Create a variable line list primitive object

SYNOPSIS

C:

DtObject DoVarLineList(colormodel, linecount, vertlocs,
vertnorms, vertcolors)
DtColorModel colormodel;
DtInt linecount;
DtReal vertlocs[];
DtReal vertnorms[];
DtReal vertcolors[];

FORTRAN:

INTEGER∗4 DOVLNL(COLMOD, LINCNT, VTXLOC,
VTXNRM, VTXCLR)
INTEGER∗4 COLMOD
INTEGER∗4 LINCNT
REAL∗8 VTXLOC(∗)
REAL∗8 VTXNRM(∗)
REAL∗8 VTXCLR(∗)

DESCRIPTION

DoVarLineList creates a primitive object that defines a variable list of independent lines.  The main difference between a variable line list and a line list is that the variable line list does not copy the vertex data into its own data space.  It simply maintains pointers to the vertex data (locations, normals and colors) in user space.  A call to DpUpdVarLineList <DPUVLL> informs a variable line list object that the user data has changed. 

The parameter colormodel specifies the color model to be used when defining vertex colors (if any).  The parameter linecount contains the number of lines in the list.  The parameter vertlocs is an array of three dimensional vertices containing the locations of 2∗linecount vertices.  The parameter vertnorms is an array of vertex normals.  If vertex normals are not available use DcNullPtr <DCNULL>.  The parameter vertcolors is an array of vertex colors.  If vertex colors are not available use DcNullPtr <DCNULL>. 

If no vertex normals are provided, backface culling cannot affect for lines because they have no surface on which to define a geometric normal. 

SEE ALSO

DpUpdVarLineList(3D), DoLineList(3D), DoVarPointList(3D), DoVarTriangleMesh(3D), DoVarSimplePolygonMesh(3D), DoVarTriangleStrip(3D)

September 02, 1992