NAME

DsTextureUVWCount − Set the number of uvw coordinates in the vertex type specification

SYNOPSIS

C:

DtInt DsTextureUVWCount(count)
DtInt count;

FORTRAN:

INTEGER∗4 DSTWC(COUNT)
INTEGER∗4 COUNT

DESCRIPTION

DsTextureUVWCount is a system function that returns a value to be combined by a bitwise or with a base vertex type to create a new vertex type that includes uvw coordinates.  The new vertex type is specified when primitive objects requiring the specification of vertices are created.  The parameter count specifies the number of uvw coordinates that are present for each vertex in the vertex list.  For example, if the vertices of a primitive were to contain locations, normals and two uvw coordinates, you could set the vertex type in C with FORTRAN with IOR(DCLN, DSTWC(2).  Each vertex in this example requires twelve DtReal <REAL∗8> values.  Thus, for vertex n the array would look like:

vertices[10∗n+0] = x
vertices[10∗n+1] = y
vertices[10∗n+2] = z
vertices[10∗n+3] = nx
vertices[10∗n+4] = ny
vertices[10∗n+5] = nz
vertices[10∗n+6] = u1
vertices[10∗n+7] = v1
vertices[10∗n+8] = w1
vertices[10∗n+9] = u2
vertices[10∗n+10] = v2
vertices[10∗n+11] = w2

where the position of vertex n is (x,y,z), the normal is (nx, ny, nz), the first uvw coordinate is (u1,v1,w1) and the second uvw coordinate is (u2,v2,w2). 

Note that a vertex type may include uv coordinates in addition to uvw coordinates.  In that case both DsTextureUVCount <DSTUVC> and DsTextureUVWCount are used in conjunction with the base vertex type, and in the vertex array all the uv coordinates of a vertex come before the uvw coordinates for that vertex. 

SEE ALSO

DsTextureUVCount(3D), VertexTypes(3D)

September 02, 1992