DpUpdVarQuadMesh(3D)

NAME
DpUpdVarQuadMesh - Update a variable quadrilateral mesh primitive object

SYNOPSIS
C:
void DpUpdVarQuadMesh(object, vertlocs,
		vertnorms, vertcolors,
		recompute_norms)
DtObject object;
DtReal vertlocs[];
DtReal vertnorms[];
DtReal vertcolors[];
DtFlag recompute_norms;

FORTRAN:
CALL DPUVQM(OBJECT, VTXLOC, VTXNRM,
		VTXCLR, CMPNRM)
INTEGER*4 OBJECT
REAL*8 VTXLOC(3,*)
REAL*8 VTXNRM(3,*)
REAL*8 VTXCLR(*,*)
INTEGER*4 CMPNRM

DESCRIPTION
DpUpdVarQuadMesh updates a variable quadrilateral 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 quadrilaterals, 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 DoVarQuadMesh <DOVQDM>.

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 DoVarQuadMesh <DOVQDM>.

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 DoVarQuadMesh <DOVQDM>, and if the shading needs them.

ERRORS
DpUpdVarQuadMesh will issue a warning if a zero vertex normal is calculated by Dore.

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

DpUpdVarQuadMesh will fail if an invalid object is specified.

[WARNING - invalid or deleted object]

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

[WARNING - value out of range]

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

[WARNING - value out of range]

SEE ALSO
DoVarQuadMesh(3D)