Help:VE186
(Initial version) |
(Update on background information based on advice from N3V.) |
||
| Line 2: | Line 2: | ||
| − | Meshes that can share materials improve game performance, but when meshes within the same asset use the same material name, and the material differs, then that | + | Meshes that can share materials improve game performance, but when meshes within the same asset use the same material name, and the material differs, then that may result in unexpected behaviour. The first time the game encounters a material name, the material is loaded. On subsequent encounters, the same material is ignored. However, the sequence of loading the material is not predictable so variations in the displayed material can occur if the material specification varies. Therefore, it is important to avoid this issue. |
VE186 is a warning for assets with a [http://online.ts2009.com/mediaWiki/index.php/Trainz_Build_Versions Trainz Build] less than 4.5, and an error for assets with a Trainz Build 4.5 and later. | VE186 is a warning for assets with a [http://online.ts2009.com/mediaWiki/index.php/Trainz_Build_Versions Trainz Build] less than 4.5, and an error for assets with a Trainz Build 4.5 and later. | ||
Revision as of 20:13, 22 May 2017
Category code 'ZX - Material 'arc:fld:$(local)/hash-nn||kuid nnnnn nnnnn.tzarc|**material name is shared between multiple meshes in this asset but the material parameters conflict.
Meshes that can share materials improve game performance, but when meshes within the same asset use the same material name, and the material differs, then that may result in unexpected behaviour. The first time the game encounters a material name, the material is loaded. On subsequent encounters, the same material is ignored. However, the sequence of loading the material is not predictable so variations in the displayed material can occur if the material specification varies. Therefore, it is important to avoid this issue.
VE186 is a warning for assets with a Trainz Build less than 4.5, and an error for assets with a Trainz Build 4.5 and later.
A Trainz material, intended for use for two or more meshes within the same asset, must be identical for each mesh that uses the material. This includes material characteristics such as: opacity, ambient, diffuse, specular, emissive and shininess. Textures, where used in the material, must be the same number of textures, the same image, size, and texture type (TEX_DIFFISE, TEX_BUMP, etc).
The following examples will result in a warning/error.
- An asset uses the same material name for three different LOD meshes. Two meshes are exported with one version of the material but the last is exported with a variation, such as the material specular value.
- As for the first example, but a texture is substituted, added or removed, for one of the meshes.
- An asset is created with a two meshes both within their own source file. The same notex material name is used for both meshes but there is a variation in the diffuse colour.
