NAME

DpUpdVarTriangleStrip − Update a variable triangle strip primitive object

SYNOPSIS

C:

DtObject DpUpdVarTriangleStrip(object, vertcount,
vertlocs, vertnorms, vertcolors)
DtObject object;
DtInt vertcnt;
DtReal vertlocs[];
DtReal vertnorms[];
DtReal vertcolors[];

FORTRAN:

INTEGER∗4 DPUVTS(OBJECT, VTXCNT, VTXLOC,
VTXNRM, VTXCLR)
INTEGER∗4 OBJECT
INTEGER∗4 VTXCNT
REAL∗8 VTXLOC(3,∗)
REAL∗8 VTXNRM(3,∗)
REAL∗8 VTXCLR(∗,∗)

DESCRIPTION

DpUpdVarTriangleStrip updates a variable triangle strip primitive object. 

The parameter object is the handle to the object. 

The parameter vertcount contains the number of vertices in the strip.  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 DoVarTriangleStrip <DOVTRM>. 

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 DoVarTriangleStrip <DOVTRM>. 

ERRORS

DpUpdVarTriangleStrip will fail if an invalid object is specified. 

[WARNING - invalid or deleted object]

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

[WARNING - value out of range]

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

[WARNING - value out of range]

SEE ALSO

DoVarTriangleStrip(3D)

March 13, 1992