DpUpdVarQuadGrid(3D)

NAME
DpUpdVarQuadGrid - Update a variable quadrilateral mesh primitive object

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

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

DESCRIPTION
DpUpdVarQuadGrid updates a variable quadrilateral grid 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 width and height of the grid 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 DoVarQuadGrid <DOVQDG>.

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 DoVarQuadGrid <DOVQDG>.

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

ERRORS
DpUpdVarQuadGrid 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]

DpUpdVarQuadGrid will fail if an invalid object is specified.

[WARNING - invalid or deleted object]

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

[WARNING - value out of range]

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

[WARNING - value out of range]

SEE ALSO
DoVarQuadGrid(3D) DoVarQuadGridUV(3D) DoVarQuadGridUVW(3D)