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 ORed 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, the vertex type would be set with: DcLocNrm | DsTextureUVWCount(2).  Each vertex in this example requires twelve DtReal 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 29, 2021