NAME

DoVarPointList − Create a variable point list primitive object

SYNOPSIS

C:

DtObject DoVarPointList(colormodel, pointcount,
vertlocs, vertnorms, vertcolors)
DtColorModel colormodel;
DtInt pointcount;
DtReal vertlocs[];
DtReal vertnorms[];
DtReal vertcolors[];

FORTRAN:

INTEGER∗4 DOVPTL(COLMOD, PNTCNT, VTXLOC,
VTXNRM, VTXCLR)
INTEGER∗4 COLMOD
INTEGER∗4 PNTCNT
REAL∗8 VTXLOC(∗)
REAL∗8 VTXNRM(∗)
REAL∗8 VTXCLR(∗)

DESCRIPTION

DoVarPointList creates a primitive object that defines a variable list of independent points.  The main difference between a variable point list and a point list is that the variable point 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 DpUpdVarPointList <DPUVPL> informs a variable point 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 pointcount contains the number of points in the list.  The parameter vertlocs is an array of three dimensional vertices containing the locations of pointcount 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 vertex normals are not provided, backface culling cannot affect for points because they have no surface on which to define a geometric normal. 

SEE ALSO

DpUpdVarPointList(3D), DoPointList(3D), DoVarLineList(3D), DoVarTriangleMesh(3D), DoVarSimplePolygonMesh(3D), DoVarTriangleStrip(3D)

March 13, 1992