NAME

DsTextureUVCount − Set the number of uv sets in the vertex type specification

SYNOPSIS

C:

DtInt DsTextureUVCount(count)
DtInt count;

FORTRAN:

INTEGER∗4 DSTUVC(COUNT)
INTEGER∗4 COUNT

DESCRIPTION

DsTextureUVCount 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 uv coordinates.  The new vertex type is specified when primitive objects requiring the specification of vertices are created.  The parameter count specifies the number of uv 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 2 uv coordinates, you could set the vertex type in C with FORTRAN with IOR(DCLN, DSTUVC(2).  Each vertex in this example requires ten 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] = u2
vertices[10∗n+9] = v2

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

Note that a vertex type may include uvw coordinates in addition to uv coordinates.  In that case both DsTextureUVWCount <DSTWC> and DsTextureUVCount 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

DsTextureUVWCount(3D), VertexTypes(3D)

September 02, 1992