DoQuadGrid(3D)

NAME
DoQuadGrid - Create a quadrilateral grid primitive object

SYNOPSIS
C:
DtObject DoQuadGrid(colormodel, vertextype, width, height,
			vertices, smoothflag)
DtColorModel colormodel;
DtVertexType vertextype;
DtInt width;
DtInt height;
DtReal vertices[];
DtFlag smoothflag;

FORTRAN:
INTEGER*4 DOQUDG(COLMOD, VTXTYP, WIDTH,
			HEIGHT, VTXS, SMOOFL)
INTEGER*4 COLMOD
INTEGER*4 VTXTYP
INTEGER*4 WIDTH
INTEGER*4 HEIGHT
REAL*8 VTXS(*)
INTEGER*4 SMOOFL

DESCRIPTION
DoQuadGrid creates a primitive object that defines a grid of (width-1) by (height-1) quadrilaterals. The parameter colormodel specifies the color model used if the vertices contain color information for shading. The parameter vertextype specifies the exact nature of the vertices. For more information, refer to Chapter 6, Dore Vertex Types, in the Dore Reference Manual or to the VertexTypes on-line manual page.) The parameter vertices is an array of vertex data. It must contain data for width*height vertices. Starting from the upper left corner, the first width vertices specify the top edges of the grid. Each subsequent group of width vertices specifies the next row of vertices for the grid.

The geometric normal to each quadrilateral is calculated using the right-hand rule (when the fingers of the right hand point in the order of the vertices, the thumb points in the direction of the normal). These geometric normal calculations require that all quadrilaterals be planar. Dore uses these normals for backface culling and flat shading.

SEE ALSO
DoQuadMesh(3D), DoQuadList, VertexTypes(3D)