NAME

DoTriangleList − Create a triangle list primitive object

SYNOPSIS

C:

DtObject DoTriangleList(colormodel, vertextype, trianglecount, vertices)
DtColorModel colormodel;
DtVertexType vertextype;
DtInt trianglecount;
DtReal vertices[];

Fortran:

INTEGER∗4 DOTRIL(COLMOD, VTXTYP, TRICNT, VTXS)
INTEGER∗4 COLMOD
INTEGER∗4 VTXTYP
INTEGER∗4 TRICNT
REAL∗8 VTXS(∗)

DESCRIPTION

DoTriangleList creates a primitive object that defines a list of independent triangles.  The parameter colormodel specifies the color model used if the vertices contain color information for shading purposes.  The parameter vertextype specifies the exact nature of the vertices.  See the appendix on vertex types for more information on this parameter.  The parameter trianglecount contains the number of triangles in the list.  The parameter vertices is an array of vertex data.  It must contain data for 3∗trianglecount vertices. 

The geometric normal to each triangle 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).  If no vertex normals are provided by the application program, or facet shading is specified, Doré computes geometric normals to find back-facing triangles for backface culling and incident and reflected light angles for shading. 

SEE ALSO

DoTriangleMesh(3D), VertexTypes(3D)

September 29, 2021