NAME

DpUpdVarLineList − Update a variable line list primitive object

SYNOPSIS

C:

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

FORTRAN:

INTEGER∗4 DPUVLL(OBJECT, LINCNT, VTXLOC,
VTXNRM, VTXCLR)
INTEGER∗4 OBJECT
INTEGER∗4 LINCNT
REAL∗8 VTXLOC(∗)
REAL∗8 VTXNRM(∗)
REAL∗8 VTXCLR(∗)

DESCRIPTION

DpUpdVarLineList updates a variable line 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 DoVarLineList <DOVLNL>. 

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 DoVarLineList <DOVLNL>. 

ERRORS

DpUpdVarLineList will fail if an invalid object is specified. 

[WARNING - invalid or deleted object]

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

[WARNING - value out of range]

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

[WARNING - value out of range]

SEE ALSO

DoVarLineList(3D)

September 02, 1992