NAME

DpUpdVarTriangleMesh − Update a variable triangle mesh primitive object

SYNOPSIS

C:

DtObject DpUpdVarTriangleMesh(object, vertlocs, vertnorms, vertcolors,
recompute_norms)
DtObject object;
DtReal vertlocs[];
DtReal vertnorms[];
DtReal vertcolors[];
DtFlag recompute_norms;

Fortran:

INTEGER∗4 DPUVTM(OBJECT, VTXLOC, VTXNRM, VTXCLR, CMPNRM)
INTEGER∗4 OBJECT
REAL∗8 VTXLOC(3,∗)
REAL∗8 VTXNRM(3,∗)
REAL∗8 VTXCLR(∗,∗)
INTEGER∗4 CMPNRM

DESCRIPTION

DpUpdVarTriangleMesh updates a variable triangle mesh primitive object. 

The parameter object is the handle to the object. 

The parameter vertlocs is an array of vertex locations.  If the vertex locations have not been modified use DcNullPtr <DCNULL>.  The number of vertices, the number of triangles and the mesh connectivity cannot be modified. 

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 DoVarTriangleMesh <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 DoVarTriangleMesh, <DOVTRM>. 

The parameter recompute_norms specifies whether normals should be recomputed if vertlocs is not null.  The vertex normals will only be recomputed if smoothflag was set when the object was created with DoVarTriangleMesh <DOVTRM>, and if the shading needs them. 

ERRORS

DpUpdateVarTriangleMesh will issue a warning if a zero vertex normal is calculated by Doré. 

[WARNING - triangle normals sum to 0 at vertex, check for back to back triangles]

DpUpdateVarTriangleMesh will fail if an invalid object is specified. 

[WARNING - invalid or deleted object]

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

[WARNING - value out of range]

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

[WARNING - value out of range]

SEE ALSO

DoVarTriangleMesh(3D)

September 29, 2021