Help:AssetPreview - Revision history

Tonyhilliam at 00:44, 18 January 2018

2018-01-18T00:44:51Z

← Older revision		Revision as of 00:44, 18 January 2018
Line 100:		Line 100:

	[[Category:Content creation]]		[[Category:Content creation]]
	[[Category:~~TRS18~~]]		[[Category:Modeling]]

Tonyhilliam at 02:40, 17 January 2018

2018-01-17T02:40:03Z

← Older revision		Revision as of 02:40, 17 January 2018
Line 98:		Line 98:
	* [[Terminology]]		* [[Terminology]]
	* [[Modeling Guidelines]]		* [[Modeling Guidelines]]

			[[Category:Content creation]]
			[[Category:TRS18]]

Windwalkr at 01:32, 23 October 2017

2017-10-23T01:32:09Z

← Older revision		Revision as of 01:32, 23 October 2017
Line 75:		Line 75:
	* Each material (or "sub-material" in [[Autodesk 3ds Max]] parlance) requires a separate chunk in the model file.		* Each material (or "sub-material" in [[Autodesk 3ds Max]] parlance) requires a separate chunk in the model file.
	* If a chunk would exceed approximately 65536 [[vertices]], it is split until it is below this limit. Be aware that the vertex count in your modelling software may understate the true number of vertices in the mesh file- certain mesh features may require unique vertices per triangle, resulting in multiple instances of vertices that were shared in the modelling software.		* If a chunk would exceed approximately 65536 [[vertices]], it is split until it is below this limit. Be aware that the vertex count in your modelling software may understate the true number of vertices in the mesh file- certain mesh features may require unique vertices per triangle, resulting in multiple instances of vertices that were shared in the modelling software.
	* For old-style "rigid" animation, each chunk is associated with a single bone. Triangles attached to separate bones will reside in separate chunks.
	* Meshes are independent of each other. If one mesh would have 3 draw calls, and a second mesh would have 5 draw calls, the result is 8 draw calls.		* Meshes are independent of each other. If one mesh would have 3 draw calls, and a second mesh would have 5 draw calls, the result is 8 draw calls.
	* Similarly, asset instances are independent of each other. If one asset has 8 draw calls, and the same asset is reused elsewhere in the scene, the result will be 16 draw calls.		* Similarly, asset instances are independent of each other. If one asset has 8 draw calls, and the same asset is reused elsewhere in the scene, the result will be 16 draw calls. [[Mesh stitching]] and [[hardware instancing]] may help reduce this.

	Similarly, there are ways that an asset can reduce draw calls at runtime:		Similarly, there are ways that an asset can reduce draw calls at runtime:

Windwalkr at 01:28, 23 October 2017

2017-10-23T01:28:50Z

Windwalkr: /* Camera Controls */

2015-09-06T00:20:11Z

Camera Controls

← Older revision		Revision as of 00:20, 6 September 2015
Line 5:		Line 5:

	The following keyboard controls are also supported:		The following keyboard controls are also supported:
	* Up arrow :- Tilt camera up		{\| class="wikitable"
	* Down arrow :- Tilt camera down		!Key(s)\|\|Action
	* Left arrow :- Rotate camera left		\|-
	* Right arrow :- Rotate camera right		\|Up arrow\|\|Tilt camera up
	* W :- Move camera forwards		\|-
	* A :- Move camera left		\|Down arrow\|\|Tilt camera down
	* S :- Move camera backwards		\|-
	* D :- Move camera right		\|Left arrow\|\|Rotate camera left
	* Q :- Move camera down		\|-
	* E :- Move camera up		\|Right arrow\|\|Rotate camera right
	* R :- Toggle camera rotation		\|-
	* -, Page Down ~~: -~~ Zoom camera out		\|W\|\|Move camera forwards
	* +, Page Up ~~: -~~ Zoom camera in		\|-
	* Home, Spacebar :- Reset camera		\|A\|\|Move camera left
	* Esc :- Close the preview window		\|-
			\|S\|\|Move camera backwards
			\|-
			\|D\|\|Move camera right
			\|-
			\|Q\|\|Move camera down
			\|-
			\|E\|\|Move camera up
			\|-
			\|R\|\|Toggle camera rotation
			\|-
			\| -, Page Down\|\|Zoom camera out
			\|-
			\| +, Page Up\|\|Zoom camera in
			\|-
			\|Home, Spacebar\|\|Reset camera
			\|-
			\|Esc\|\|Close the preview window
			\|}

	==Performance Controls & Statistics==		==Performance Controls & Statistics==

Windwalkr at 00:14, 6 September 2015

2015-09-06T00:14:47Z

← Older revision		Revision as of 00:14, 6 September 2015
Line 39:		Line 39:
	* ''Bone Count'' - The sum number of bones used by the animations in the scene.		* ''Bone Count'' - The sum number of bones used by the animations in the scene.
	* ''Mesh Object Count'' - The number of scenery asset instances in the scene. This includes any sub-instances (ie. attached mesh objects.)		* ''Mesh Object Count'' - The number of scenery asset instances in the scene. This includes any sub-instances (ie. attached mesh objects.)
	* ''Attachment Point Count'' - The number of active attachment points in the scene.		* ''Attachment Point Count'' - The number of active attachment points in the scene. This includes explicit attachment points specified in the mesh, implicit attachment points generated by the structure of the asset, and attachment points introduced through other internal mechanisms.
	* ''Renderable Count'' - The number of renderable objects in the scene. This typically correlates with the number of ".im" or ".lm.txt" file instances in use, however various other runtime objects also generate renderables.		* ''Renderable Count'' - The number of renderable objects in the scene. This typically correlates with the number of ".im" or ".lm.txt" file instances in use, however various other runtime objects also generate renderables.

Windwalkr at 05:39, 26 July 2015

2015-07-26T05:39:39Z

← Older revision		Revision as of 05:39, 26 July 2015
Line 56:		Line 56:
	There are a variety of ways that a given asset can induce additional draw calls:		There are a variety of ways that a given asset can induce additional draw calls:

	* Each material (or "sub-material" in [[Max]] parlance) requires a separate chunk in the model file.		* Each material (or "sub-material" in [[Autodesk 3ds Max]] parlance) requires a separate chunk in the model file.
	* If a chunk would exceed approximately 65536 vertices, it is split until it is below this limit. Be aware that the vertex count in your modelling software may understate the true number of vertices in the mesh file- certain mesh features may require unique vertices per triangle, resulting in multiple instances of vertices that were shared in the modelling software.		* If a chunk would exceed approximately 65536 vertices, it is split until it is below this limit. Be aware that the vertex count in your modelling software may understate the true number of vertices in the mesh file- certain mesh features may require unique vertices per triangle, resulting in multiple instances of vertices that were shared in the modelling software.
	* For old-style "rigid" animation, each chunk is associated with a single bone. Triangles attached to separate bones will reside in separate chunks.		* For old-style "rigid" animation, each chunk is associated with a single bone. Triangles attached to separate bones will reside in separate chunks.

Windwalkr at 05:36, 26 July 2015

2015-07-26T05:36:30Z

← Older revision		Revision as of 05:36, 26 July 2015
Line 25:		Line 25:
	The asset preview window captures a number of statistics which are of use to content creators. These statistics are not gathered every frame but are updated on a regular basis. When analysing these statistics, please keep in mind that these reflect the actual scene being viewed and may be affected by performance settings, scene culling, LOD, and the internal details of the file loaders and renderer. They are not simply a dump of the contents of the files.		The asset preview window captures a number of statistics which are of use to content creators. These statistics are not gathered every frame but are updated on a regular basis. When analysing these statistics, please keep in mind that these reflect the actual scene being viewed and may be affected by performance settings, scene culling, LOD, and the internal details of the file loaders and renderer. They are not simply a dump of the contents of the files.

			===Controls===
			The following controls are available to adjust how the asset is displayed in the preview window:
			* ''Preview Mode'' - Configures how the preview window will display the asset, in order that the user can view different aspects of the asset's construction and performance. See 'Preview Mode' below.
			* ''LOD Level'' - Allows the standard LOD logic to be overridden and a particular LOD level to be forced. This currently only affects mesh-table LOD. Smaller numbers indicate higher-detail LODs.
			* ''Season'' - Allows the display season to be customised. Different assets may interpret the season numbers in different ways, and it is asset-specific as to how many season numbers are supported.

			===Statistics===
	The following statistics are currently available:		The following statistics are currently available:

Line 35:		Line 42:
	* ''Renderable Count'' - The number of renderable objects in the scene. This typically correlates with the number of ".im" or ".lm.txt" file instances in use, however various other runtime objects also generate renderables.		* ''Renderable Count'' - The number of renderable objects in the scene. This typically correlates with the number of ".im" or ".lm.txt" file instances in use, however various other runtime objects also generate renderables.

	=== ~~Inspect vs Analyse~~ ===		=== Preview Mode ===
	The asset preview window currently offers two display modes.		The asset preview window currently offers two display modes.

Line 42:		Line 49:
	* ''Performance Analysis'' mode displays a large number of instances of the asset in question. This is useful for understanding how the asset behaves in certain real-world scenarios. Mechanisms such as [[mesh stitching]], material sharing and LOD will be in effect and so the efficiency of using the asset repeatedly in a scene can be properly analysed. For example, many costs will not scale linearly with the number of instances in the scene.		* ''Performance Analysis'' mode displays a large number of instances of the asset in question. This is useful for understanding how the asset behaves in certain real-world scenarios. Mechanisms such as [[mesh stitching]], material sharing and LOD will be in effect and so the efficiency of using the asset repeatedly in a scene can be properly analysed. For example, many costs will not scale linearly with the number of instances in the scene.

	=== Draw Count ==		=== Draw Count ===
	In optimal usage, a scene will have one draw call per 30-60k triangles. For the majority of assets, a single instance (as seen in "inspect" mode) will not reach these numbers - although some very heavy assets such as locomotives may do so at top LOD. In "performance analysis" mode, however, you can observe whether bulk usage of the asset trends towards this optimum, or whether costs remain high.		In optimal usage, a scene will have one draw call per 30-60k triangles. For the majority of assets, a single instance (as seen in "inspect" mode) will not reach these numbers - although some very heavy assets such as locomotives may do so at top LOD. In "performance analysis" mode, however, you can observe whether bulk usage of the asset trends towards this optimum, or whether costs remain high.

Windwalkr at 05:29, 26 July 2015

2015-07-26T05:29:28Z

← Older revision		Revision as of 05:29, 26 July 2015
Line 23:		Line 23:

	==Performance Controls & Statistics==		==Performance Controls & Statistics==
			The asset preview window captures a number of statistics which are of use to content creators. These statistics are not gathered every frame but are updated on a regular basis. When analysing these statistics, please keep in mind that these reflect the actual scene being viewed and may be affected by performance settings, scene culling, LOD, and the internal details of the file loaders and renderer. They are not simply a dump of the contents of the files.

			The following statistics are currently available:

			* ''Triangle Count'' - The number of triangles that the GPU is rendering in the current scene.
			* ''Draw Count'' - The number of draw calls placed with the GPU in order to render the current scene.
			* ''Animation Count'' - The number of discreet animation effects in the scene. This typically correlates with the number of "*.kin" file instances in use.
			* ''Bone Count'' - The sum number of bones used by the animations in the scene.
			* ''Mesh Object Count'' - The number of scenery asset instances in the scene. This includes any sub-instances (ie. attached mesh objects.)
			* ''Attachment Point Count'' - The number of active attachment points in the scene.
			* ''Renderable Count'' - The number of renderable objects in the scene. This typically correlates with the number of ".im" or ".lm.txt" file instances in use, however various other runtime objects also generate renderables.

			=== Inspect vs Analyse ===
			The asset preview window currently offers two display modes.

			* ''Inspect'' mode displays a single instance of the asset in question (for spline assets, this show a short stretch of spline.) This is useful for understanding how the asset is constructed. The performance statistics give the numbers for the single asset instance.

			* ''Performance Analysis'' mode displays a large number of instances of the asset in question. This is useful for understanding how the asset behaves in certain real-world scenarios. Mechanisms such as [[mesh stitching]], material sharing and LOD will be in effect and so the efficiency of using the asset repeatedly in a scene can be properly analysed. For example, many costs will not scale linearly with the number of instances in the scene.

			=== Draw Count ==
			In optimal usage, a scene will have one draw call per 30-60k triangles. For the majority of assets, a single instance (as seen in "inspect" mode) will not reach these numbers - although some very heavy assets such as locomotives may do so at top LOD. In "performance analysis" mode, however, you can observe whether bulk usage of the asset trends towards this optimum, or whether costs remain high.

			The top LOD is also expected to be relatively expensive in terms of draw calls. This doesn't mean that you should avoid optimising the top LOD, but rather is an acknowledgement that the top LOD tends to prioritise appearance and functionality over performance. As the instance drops in LOD (either via manual LOD control in "inspect" mode, or via "performance analysis" mode) it is important that the triangle count per instance drops off sharply, and the draw call count per instance trends towards 1.

			There are a variety of ways that a given asset can induce additional draw calls:

			* Each material (or "sub-material" in [[Max]] parlance) requires a separate chunk in the model file.
			* If a chunk would exceed approximately 65536 vertices, it is split until it is below this limit. Be aware that the vertex count in your modelling software may understate the true number of vertices in the mesh file- certain mesh features may require unique vertices per triangle, resulting in multiple instances of vertices that were shared in the modelling software.
			* For old-style "rigid" animation, each chunk is associated with a single bone. Triangles attached to separate bones will reside in separate chunks.
			* Meshes are independent of each other. If one mesh would have 3 draw calls, and a second mesh would have 5 draw calls, the result is 8 draw calls.
			* Similarly, asset instances are independent of each other. If one asset has 8 draw calls, and the same asset is reused elsewhere in the scene, the result will be 16 draw calls.

			Similarly, there are ways that an asset can reduce draw calls at runtime:

			* If chunks with a single mesh are considered to use an identical material, they may be merged as long as the chunk maximum vertex count is not exceeded. This is an optimisation to the mesh file loader, and is not related to mesh stitching. This works within a given mesh only, and will not merge between multiple meshes that may comprise a single asset.
			* If the asset is a candidate for mesh stitching, each chunk from the source model may be stitched together with other compatible chunks in the scene, reducing the overall draw call count in the scene.
			* In some cases where non-stitched assets are used repeatedly in the scene, the engine may use a GPU technology known as "instancing" to substantially reduce the overall draw cost. ''(TBD: need to explain how this affects the stats.)''

			=== Triangle Count ===
			Please note that the terms "triangle" and "polygon" are used interchangeably in the Trainz environment. Trainz only supports rendering triangles, so by definition all polygons in the Trainz environment are triangles. If you are using modelling software that works in patches, quads, higher-order polygons, or anything else other than triangle meshes, please be aware that your asset will have been converted to triangles at export time, before it enters the Trainz environment.

			Be aware that the triangle count in your modelling software may understate the true number of triangles in the mesh file or at runtime- mesh features such as double-sided geometry may require that two single-sided triangles are sent to the GPU in place of one double-sided triangle in the modelling software.

			At higher LODs, it is somewhat meaningless to drop below about 300 triangles per draw call. At lower LODs, especially for stitched objects, it is imperative that the triangle count is dropped as low as possible.




			= See Also =

			* [[Terminology]]
			* [[Modeling Guidelines]]

Pw3r at 03:15, 17 July 2015

2015-07-17T03:15:35Z

← Older revision		Revision as of 03:15, 17 July 2015
Line 1:		Line 1:
	The TANE Asset Preview Interface is used to give a quick preview of a single asset from within Trainz Content. To open the interface, right-click on any locally installed asset within Trainz Content and select "Preview Asset".		The TANE Asset Preview Interface is used to give a quick preview of a single asset from within Trainz Content. To open the interface, right-click on any locally installed asset within Trainz Content and select "Preview Asset".


	==Camera Controls==		==Camera Controls==

← Older revision		Revision as of 01:28, 23 October 2017
Line 51:		Line 51:
	The following statistics are currently available:		The following statistics are currently available:

	* ''Triangle Count'' - The number of ~~triangles~~ that the GPU is rendering in the current scene.		* ''Triangle Count'' - The number of [[triangle]]s that the GPU is rendering in the current scene. Keeping this number low, especially at lower LOD levels, is an important requirement for performance optimisation.
	* ''Draw Count'' - The number of draw ~~calls~~ placed with the GPU in order to render the current scene.		* ''Draw Count'' - The number of [[draw call]]s placed with the GPU in order to render the current scene. Keeping this number low is an important requirement for performance optimisation.
	* ''Animation Count'' - The number of discreet animation effects in the scene. This typically correlates with the number of "*.kin" file instances in use.		* ''Animation Count'' - The number of discreet [[animation]] effects in the scene. This typically correlates with the number of "*.kin" file instances in use.
	* ''Bone Count'' - The sum number of bones used by the animations in the scene.		* ''Bone Count'' - The sum number of bones used by the animations in the scene.
	* ''Mesh Object Count'' - The number of scenery asset instances in the scene. This includes any sub-instances (ie. attached mesh objects.)		* ''Mesh Object Count'' - The number of [[KIND Mesh\|scenery asset]] instances in the scene. This includes any sub-instances (ie. attached mesh objects.)
	* ''Attachment Point Count'' - The number of active attachment points in the scene. This includes explicit attachment ~~points~~ specified in the mesh, implicit attachment points generated by the structure of the asset, and attachment points introduced through other internal mechanisms.		* ''Attachment Point Count'' - The number of active attachment points in the scene. This includes explicit [[attachment point]]s specified in the mesh, implicit attachment points generated by the structure of the asset, and attachment points introduced through other internal mechanisms.
	* ''Renderable Count'' - The number of renderable objects in the scene. This typically correlates with the number of ~~".im"~~ or ~~".lm~~.txt" file instances in use, however various other runtime objects also generate renderables.		* ''Renderable Count'' - The number of renderable objects in the scene. This typically correlates with the number of [[trainzmesh file]] or [[LM.txt file]] instances in use, however various other runtime objects also generate renderables.

	=== Preview Mode ===		=== Preview Mode ===
Line 64:		Line 64:
	* ''Inspect'' mode displays a single instance of the asset in question (for spline assets, this show a short stretch of spline.) This is useful for understanding how the asset is constructed. The performance statistics give the numbers for the single asset instance.		* ''Inspect'' mode displays a single instance of the asset in question (for spline assets, this show a short stretch of spline.) This is useful for understanding how the asset is constructed. The performance statistics give the numbers for the single asset instance.

	* ''Performance Analysis'' mode displays a large number of instances of the asset in question. This is useful for understanding how the asset behaves in certain real-world scenarios. Mechanisms such as [[mesh stitching]], material sharing and ~~LOD~~ will be in effect and so the efficiency of using the asset repeatedly in a scene can be properly analysed. For example, many costs will not scale linearly with the number of instances in the scene.		* ''Performance Analysis'' mode displays a large number of instances of the asset in question. This is useful for understanding how the asset behaves in certain real-world scenarios. Mechanisms such as [[mesh stitching]], [[material sharing]] and [[Level of Detail]] will be in effect and so the efficiency of using the asset repeatedly in a scene can be properly analysed. For example, many costs will not scale linearly with the number of instances in the scene.

	=== Draw Count ===		=== Draw Count ===
Line 74:		Line 74:

	* Each material (or "sub-material" in [[Autodesk 3ds Max]] parlance) requires a separate chunk in the model file.		* Each material (or "sub-material" in [[Autodesk 3ds Max]] parlance) requires a separate chunk in the model file.
	* If a chunk would exceed approximately 65536 vertices, it is split until it is below this limit. Be aware that the vertex count in your modelling software may understate the true number of vertices in the mesh file- certain mesh features may require unique vertices per triangle, resulting in multiple instances of vertices that were shared in the modelling software.		* If a chunk would exceed approximately 65536 [[vertices]], it is split until it is below this limit. Be aware that the vertex count in your modelling software may understate the true number of vertices in the mesh file- certain mesh features may require unique vertices per triangle, resulting in multiple instances of vertices that were shared in the modelling software.
	* For old-style "rigid" animation, each chunk is associated with a single bone. Triangles attached to separate bones will reside in separate chunks.		* For old-style "rigid" animation, each chunk is associated with a single bone. Triangles attached to separate bones will reside in separate chunks.
	* Meshes are independent of each other. If one mesh would have 3 draw calls, and a second mesh would have 5 draw calls, the result is 8 draw calls.		* Meshes are independent of each other. If one mesh would have 3 draw calls, and a second mesh would have 5 draw calls, the result is 8 draw calls.
Line 81:		Line 81:
	Similarly, there are ways that an asset can reduce draw calls at runtime:		Similarly, there are ways that an asset can reduce draw calls at runtime:

	* If chunks with a single mesh are considered to use an identical material, they may be merged as long as the chunk maximum vertex count is not exceeded. This is an optimisation to the mesh file loader, and is not related to mesh stitching. This works within a given mesh only, and will not merge between multiple meshes that may comprise a single asset.		* If chunks with a single [[mesh]] are considered to use an identical material, they may be merged as long as the chunk maximum vertex count is not exceeded. This is an optimisation to the mesh file loader, and is not related to mesh stitching. This works within a given mesh only, and will not merge between multiple meshes that may comprise a single asset.
	* If the asset is a candidate for mesh stitching, each chunk from the source model may be stitched together with other compatible chunks in the scene, reducing the overall draw call count in the scene.		* If the asset is a candidate for mesh stitching, each chunk from the source model may be stitched together with other compatible chunks in the scene, reducing the overall draw call count in the scene.
	* In some cases where non-stitched assets are used repeatedly in the scene, the engine may use a GPU technology known as "instancing" to substantially reduce the overall draw cost. ''(TBD: need to explain how this affects the stats.)''		* In some cases where non-stitched assets are used repeatedly in the scene, the engine may use a GPU technology known as "instancing" to substantially reduce the overall draw cost. ''(TBD: need to explain how this affects the stats.)''