DpUpdVarQuadList(3D)

NAME
DpUpdVarQuadList - Update a variable quadrilateral list primitive object

SYNOPSIS
C:
DtObject DpUpdVarQuadList(object, quadcount, vertlocs,
		vertnorms, vertcolors)
DtObject object;
DtInt  quadcount;
DtReal vertlocs[];
DtReal vertnorms[];
DtReal vertcolors[];

FORTRAN:
INTEGER*4 DPUVQL(OBJECT, QUDCNT, VTXLOC, VTXNRM, VTXCLR)
INTEGER*4 OBJECT
INTEGER*4 QUDCNT
REAL*8 VTXLOC(3,*)
REAL*8 VTXNRM(3,*)
REAL*8 VTXCLR(*,*)

DESCRIPTION
DpUpdVarQuadList updates a variable quadrilateral list 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 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 DoVarQuadList <DOVQDL>.

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 DoVarQuadList <DOVQDL>.

The parameter quadcount specifies the total number of quadrilaterals in the list. Therefore, vertlocs -- and when supplied, vertnorms and vertcolors -- must contain data for 4*quadcount vertices.

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

DpUpdVarQuadList will fail if an invalid object is specified.

[WARNING - invalid or deleted object]

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

[WARNING - value out of range]

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

[WARNING - value out of range]

SEE ALSO
DoVarQuadList(3D)