Appendix C: Custom vertex data

User Guide > Rendering and Render Setup > Shading > Appendices >

Previously, UVs, ColorPerVertex, and User Data per Vertex are being referenced by index. This creates a pipeline challenge since it is difficult to enforce indices.

Now, by default, a data block is added to each shape node that provides the name of each piece of data (UVs, CVP, and custom data per vertex). You can query this table from within the shader API in order to retrieve and resolve the string value passed to a shader.

You can assign shading networks to many objects and assign the ColorPerVertex and UVs at render time without explicitly creating a connection within the Maya scene. At render time, the shader would be responsible for converting Name references into per-instance or per-shapeNode indices.

An example of this data block is shown below:

data "pPlaneShape1:PerVertexNomenclature"

 "PerVertexNomenclature"

 "magicnumber" 5149248936,

 "tex" // texture space or Maya UVs

 { "name" "uvset1", "index" 0 }

 { "name" "myUVset", "index" 1 }

 { "name" "bakeUV", "index" 2 }

],

 "cpv" // color per vertex (RGB only)

 { "name" "ColorSet1", "index" 3 }

 { "name" "CPV_DirtMask", "index" 4 }

 { "name" "CPV_WetMask", "index" 5 }

],

 "cudpv" //custom data per vertex

 { "name" "LightIndexField", "index" 6 }

object "pPlaneShape1"

 visible on

 shadow 3

 transparency 3

 reflection 3

 refraction 3

 finalgather 3

 face both

 tagged

 trilist vertex 4 p n t 2 b 2 u 3 triangle 2

 vertex data goes here

 0 0 1 3

 0 3 1 2

 end trilist

 data "pPlaneShape1:PerVertexNomenclature"

end object

shader "DirtMapCPVLookup1" "myCustomVertexColor" ( "cpvname" "CPV_Dirtmask", .... )

To turn this off, you can select between the following methods:

Turn off Export Custom Data under the Customization section of the Translation section under the Render Settings: mental ray tabs, Options tab. This disables the recognition of custom vertex data and the whole data info block translation; but it does not disable translation of Maya's standard vertex data (UV and color sets). This is the primary control to disable 'info' data block translation.
Turn off Export Vertex Colors under the Translation section of the Render Settings: mental ray tabs. Options tab. This disables vertex color translation. As a consequence, the 'cpv' section of the 'info' data block is not translated. If this option is enabled, then vertex color sets are translated (along with the 'info') regardless of usage of the node mentalrayVertexColors in a shading graph.