NAME

DpUpdVarPointList − Update a variable point list primitive object

SYNOPSIS

C:

DtObject DpUpdVarPointList(object, pointcount,
vertlocs, vertnorms, vertcolors)
DtObject object;
DtInt pointcount;
DtReal vertlocs[];
DtReal vertnorms[];
DtReal vertcolors[];

FORTRAN:

INTEGER∗4 DPUVPL(OBJECT, PNTCNT, VTXLOC,
VTXNRM, VTXCLR)
INTEGER∗4 OBJECT
INTEGER∗4 PNTCNT
REAL∗8 VTXLOC(∗)
REAL∗8 VTXNRM(∗)
REAL∗8 VTXCLR(∗)

DESCRIPTION

DpUpdVarPointList updates a variable point list primitive object. 

The parameter object is the handle to the object. 

The parameter pointcount specifies the number of points in the vertex data arrays.  A value of 0 indicates that the number of points has not changed. 

The parameter vertlocs is an array of vertex locations.  If the vertex locations have not been modified use DcNullPtr <DCNULL>. 

The parameter vertnorms is an array of vertex normals.  If the vertex normals have not been modified use DcNullPtr <DCNULL>.  vertnorms must be a null pointer if vertex normals were not provided when the object was created with DoVarPointList <DOVPTL>. 

The parameter vertcolors is an array of vertex colors.  If the vertex colors have not been modified use DcNullPtr <DCNULL>.  vertcolors must be a null pointer if vertex colors were not provided when the object was created with DoVarPointList <DOVPTL>. 

ERRORS

DpUpdVarPointList will fail if an invalid object is specified. 

[WARNING - invalid or deleted object]

DpUpdVarPointList will fail if vertex normals are specified for an object that did not possess them originally. 

[WARNING - value out of range]

DpUpdVarPointList will fail if vertex colors are specified for an object that did not possess them originally. 

[WARNING - value out of range]

SEE ALSO

DoVarPointList(3D)

September 02, 1992