Vertex color information is stored with a Mesh. This information can be used in conjunction with the vertex color map (\MAXSDK\SAMPLES\MATERIALS\VERTCOL.CPP) or the Color Per Vertex utility and modifier (\MAXSDK\SAMPLES\UTILITIES\APPLYVC\APPLYVC.CPP and AVCMOD.CPP).
Several public member fields and methods in the Mesh class provide access to this data.
Data Members
- Mesh::numCVerts - The number of color vertices.
- Mesh::vertCol - Array of color vertices. Note that VertColor is a Point3 typedef.
- Mesh::vcFace - Array of vertex color faces.
- Mesh::vertColArray - The source data for vertex colors can come from other than the internal vertex color array (Mesh::vertCol). The data can come from an external array or one of the map channels. When 3ds Max is rendering, the color values come from
the Mesh::vertColArray variable. This array defaults to the internal array (Mesh::vertCol) but can be set to an external array or a mapping channel.
- Mesh::curVCArray - If an external array is used this data member points to it (it defaults to NULL).
- Mesh::curVCChan - If a mapping channel is used this data member indicates which one. It defaults to 0.
- Mesh::vcFaceData - When 3ds Max is rendering the vertex lookup comes from this variable. The defaults is to use the Mesh::vcFace data. However if a mapping channel is used for color lookup then 3ds Max uses its TVFace structure.
Methods
The methods associates with this are as follows:
- Mesh::setNumVertCol() - Sets the number of vertex colors.
- Mesh::getNumVertCol() - Gets the number of vertex colors.
- Mesh::setNumVCFaces() - Sets the number of vertex color faces.
- Mesh::setCVertArray() - Is used to set a different source array for vertex color data. This can be either an external array or one of the mapping
channels.
