NAME

DpUpdVarPointList − Update a variable point list primitive object

SYNOPSIS

C:

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

Fortran:

INTEGER∗4 DPUVPL(OBJECT, LINCNT, VTXLOC, VTXNRM, VTXCLR)
INTEGER∗4 OBJECT
INTEGER∗4 LINCNT
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 linecount specifies the number of lines in the vertex data arrays.  A value of 0 indicates that the number of lines 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

DpUpdateVarPointList will fail if an invalid object is specified. 

[WARNING - invalid or deleted object]

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

[WARNING - value out of range]

DpUpdateVarPointList 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 29, 2021