Help:VE186 - Revision history

Dundun92 at 02:07, 6 May 2024

2024-05-06T02:07:36Z

← Older revision		Revision as of 02:07, 6 May 2024
Line 3:		Line 3:
	[[Material sharing]] is a recommended technique for improving performance. This asset contains meshes which share materials, but which are configured such that material sharing is inappropriate and will introduce unwanted and undefined behaviour. The resulting visual faults may be subtle or substantial, and may give different results on each run or on different Trainz installs.		[[Material sharing]] is a recommended technique for improving performance. This asset contains meshes which share materials, but which are configured such that material sharing is inappropriate and will introduce unwanted and undefined behaviour. The resulting visual faults may be subtle or substantial, and may give different results on each run or on different Trainz installs.

	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 to 5.0.		VE186 is a warning for assets with a [http://online.ts2009.com/mediaWiki/index.php/Trainz_Build_Versions Trainz Build] less than 4.5 or greater than 5.0, and an error for assets with a Trainz Build from 4.5 to 5.0.

	Trainz may also show diagnostic messages before this warning/error. These diagnostics will help identify which material attributes are mismatched.		Trainz may also show diagnostic messages before this warning/error. These diagnostics will help identify which material attributes are mismatched.

Dundun92 at 02:07, 6 May 2024

2024-05-06T02:07:15Z

← Older revision		Revision as of 02:07, 6 May 2024
Line 3:		Line 3:
	[[Material sharing]] is a recommended technique for improving performance. This asset contains meshes which share materials, but which are configured such that material sharing is inappropriate and will introduce unwanted and undefined behaviour. The resulting visual faults may be subtle or substantial, and may give different results on each run or on different Trainz installs.		[[Material sharing]] is a recommended technique for improving performance. This asset contains meshes which share materials, but which are configured such that material sharing is inappropriate and will introduce unwanted and undefined behaviour. The resulting visual faults may be subtle or substantial, and may give different results on each run or on different Trainz installs.

	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 to 5.0.

	Trainz may also show diagnostic messages before this warning/error. These diagnostics will help identify which material attributes are mismatched.		Trainz may also show diagnostic messages before this warning/error. These diagnostics will help identify which material attributes are mismatched.

Builderbob: Additional example

2017-11-16T01:29:56Z

Additional example

← Older revision		Revision as of 01:29, 16 November 2017
Line 24:		Line 24:
	* As for the first example, but a texture is substituted, added or removed, for one of the meshes.		* 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~~.		* As for the first example, but the two conflicting meshes are generic meshes (eg, an attachment mesh and a shadow mesh) that use the same material name and the materials in the two meshes have different property values. The error is reported even though there is no texture resource for the material.

			* An asset is created with 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.

	Therefore:		Therefore:
	* Do not use the same material name if the materials should have different parameters		* Do not use the same material name if the materials should have different parameters.
	* If you use the same material name in different meshes then ensure that the material parameters are the same.		* If you use the same material name in different meshes then ensure that the material parameters are the same.
			* Avoid material names (eg 'black_m') that are common in generic meshes that might subsequently be added to the asset.


	[[Category:Validation Errors]]		[[Category:Validation Errors]]

Windwalkr at 08:52, 13 October 2017

2017-10-13T08:52:05Z

← Older revision		Revision as of 08:52, 13 October 2017
Line 7:		Line 7:
	Trainz may also show diagnostic messages before this warning/error. These diagnostics will help identify which material attributes are mismatched.		Trainz may also show diagnostic messages before this warning/error. These diagnostics will help identify which material attributes are mismatched.

	This warning/error always involves multiple [[render ~~chunks~~]], typically across two or more mesh files. The warning/error will clear only once all of the involved [[render ~~chunks~~]] have been corrected.		This warning/error always involves multiple [[render chunk]]s, typically across two or more mesh files. The warning/error will clear only once all of the involved [[render chunk]]s have been corrected.

Windwalkr at 00:33, 11 October 2017

2017-10-11T00:33:16Z

← Older revision		Revision as of 00:33, 11 October 2017
Line 4:		Line 4:

	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.

			Trainz may also show diagnostic messages before this warning/error. These diagnostics will help identify which material attributes are mismatched.

			This warning/error always involves multiple [[render chunks]], typically across two or more mesh files. The warning/error will clear only once all of the involved [[render chunks]] have been corrected.


	=Background=		=Background=

Windwalkr at 00:31, 11 October 2017

2017-10-11T00:31:13Z

← Older revision		Revision as of 00:31, 11 October 2017
Line 1:		Line 1:
	'''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.'''		'''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.'''

			[[Material sharing]] is a recommended technique for improving performance. This asset contains meshes which share materials, but which are configured such that material sharing is inappropriate and will introduce unwanted and undefined behaviour. The resulting visual faults may be subtle or substantial, and may give different results on each run or on different Trainz installs.

	~~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.~~		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.

	~~The first time the game encounters~~ a ~~material name, that material is loaded~~ with ~~the material parameters that are defined for it~~. ~~If the same material name is subsequently encountered in a mesh, then a new material is not loaded - the parameters already loaded are used~~. ~~Those parameters might not be what was intended for that second material, and the rendering of the asset might therefore be incorrect~~. ~~Also, as the sequence of loading meshes is not predictable, the resultant rendering will vary in different circumstances~~. ~~To obtain correct~~, ~~consistent rendering of the asset it is important to ensure that each material is loaded~~ with ~~the correct parameters for that material~~.


	~~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~~.		=Background=
			The first time the game encounters a named material in a given asset, that material is loaded with the material parameters that are defined for it (including texture slots and lighting parameters). If the same material name is subsequently encountered in another chunk or mesh of the same asset, then a new material is not loaded - the parameters already loaded are used. Those parameters might not be what was intended for that second material, and the rendering of the asset might therefore be incorrect. Also, as the sequence of loading meshes is not predictable, the resultant rendering will vary in different circumstances. To obtain correct, consistent rendering of the asset it is important to ensure that each material is loaded with the correct parameters for that material.

			=Automated Workaround=
			Newer versions of Trainz will attempt to detect and work around this problem at runtime on older assets, by disabling material sharing for the assets. This workaround may reduce performance, but may help to stabilise the visual result. This workaround may or may not give the visual result that the content creator had in mind when they created the asset. For newer assets, this problem is simply considered an error. In either case, it is recommended that the content creator fix the problem so that the result is well defined and performs as expected.

	A [http://online.ts2009.com/mediaWiki/index.php/Material_Types 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_DIFFUSE, TEX_BUMP, etc).		=Examples=

	The following examples will result in a warning/error.		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.		* 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 a different material specular value.

	* As for the first example, but a texture is substituted, added or removed, for one of the meshes.		* As for the first example, but a texture is substituted, added or removed, for one of the meshes.

Pcas1986: Improved description.

2017-05-22T22:29:34Z

Improved description.

← Older revision		Revision as of 22:29, 22 May 2017
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 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~~.		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, that material is loaded with the material parameters that are defined for it. If the same material name is subsequently encountered in a mesh, then a new material is not loaded - the parameters already loaded are used. Those parameters might not be what was intended for that second material, and the rendering of the asset might therefore be incorrect. Also, as the sequence of loading meshes is not predictable, the resultant rendering will vary in different circumstances. To obtain correct, consistent rendering of the asset it is important to ensure that each material is loaded with the correct parameters for that material.


	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.


	A [http://online.ts2009.com/mediaWiki/index.php/Material_Types 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).		A [http://online.ts2009.com/mediaWiki/index.php/Material_Types 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_DIFFUSE, TEX_BUMP, etc).

	The following examples will result in a warning/error.		The following examples will result in a warning/error.
Line 16:		Line 19:

	* 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.		* 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.


			Therefore:
			* Do not use the same material name if the materials should have different parameters
			* If you use the same material name in different meshes then ensure that the material parameters are the same.


	[[Category:Validation Errors]]		[[Category:Validation Errors]]

Pcas1986: Update on background information based on advice from N3V.

2017-05-22T10:13:57Z

Update on background information based on advice from N3V.

← Older revision		Revision as of 10:13, 22 May 2017
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 ~~will reduce performance~~.		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.

Pcas1986: Initial version

2017-05-22T08:21:11Z

Initial version

New page

'''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 will reduce performance.

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.

A [http://online.ts2009.com/mediaWiki/index.php/Material_Types 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.

[[Category:Validation Errors]]