Compatibility mode - Revision history

Windwalkr at 05:25, 21 June 2022

2022-06-21T05:25:01Z

← Older revision		Revision as of 05:25, 21 June 2022
Line 4:		Line 4:

	==Maximise compatibility==		==Maximise compatibility==
	In maximise compatibility mode Trainz will disable all [[Asynchronous_Route_Streaming\|Route streaming]], and maintain the maximum level of [[TrainzScript\|script]] support possible. While running in this mode Trainz will keep the entire Route loaded into system memory, which can massively degrade performance.		In "maximise compatibility" mode, Trainz will disable all [[Asynchronous_Route_Streaming\|Route streaming]], and maintain the maximum level of [[TrainzScript\|script]] support possible. While running in this mode Trainz will keep the entire Route loaded into system memory, which can massively degrade performance.

	This mode should only be used to run legacy content which fails to operate correctly with streaming enabled.		This mode should only be used to run legacy content which fails to operate correctly with streaming enabled.

			In both [[TRS19]] and [[TRS22]], this mode is the default for the game due to the large number of legacy scripts in circulation. Users may override this default in the (out-of-game) Trainz Settings, and are encouraged to do so in order to achieve better game performance and/or test content to ensure that it functions correctly.

	==Stream objects==		==Stream objects==
	This mode enables [[Asynchronous_Route_Streaming\|Route streaming]], but keeps the maximum level of [[TrainzScript\|script]] support possible. With streaming enabled, Trainz ~~is able to unload~~ portions of the Route which are inactive and far away from the player, increasing performance. This is especially evident on very large Routes. However, older scripted assets can experience issues, as they may attempt to query Route data which is not currently loaded.		This mode enables [[Asynchronous_Route_Streaming\|Route streaming]], but keeps the maximum level of [[TrainzScript\|script]] support possible. With streaming enabled, Trainz avoids loading portions of the Route which are inactive and far away from the player, increasing performance, reducing loading times, and reducing overall system resource consumption. This is especially evident on very large Routes. However, older scripted assets (especially session rules) can experience issues, as they may attempt to query Route data which is not currently loaded.

			This mode is most appropriate for running most content from older versions of Trainz.

	~~This~~ mode is ~~most appropriate for running content from older versions of Trainz~~.		Packaged routes which are bundled with the [[TRS19]] and [[TRS22]] products use this mode even if "Maximise Compatibility" is selected, because they have been tested internally at N3V to confirm correct operation.

	==Maximise performance==		==Maximise performance==
	In maximise performance mode Trainz enables [[Asynchronous_Route_Streaming\|Route streaming]], and prevents many ~~legacy~~ [[~~TrainzScript~~\|script]] ~~functions~~ from running. This can hugely improve performance but older scripted content is likely to function incorrectly, or not at all. Specifically, script functions which are tagged with the 'obsolete' keyword are likely not to function, and may return empty, null, or incomplete results.		In maximise performance mode Trainz enables [[Asynchronous_Route_Streaming\|Route streaming]], and also prevents many [[HowTo/Upgrade obsolete script functions\|legacy script functions]] from running. This can hugely improve performance but older scripted content is likely to function incorrectly, or not at all. Specifically, script functions which are tagged with the [[TrainzScript Keywords#obsolete\|'obsolete' keyword]] are likely not to function, and may return empty, null, or incomplete results.

	~~This~~ mode ~~is the used to~~ run ~~most builtin~~ and ~~DLC content, but it can break Session gameplay in content from older versions of Trainz~~.		It is expected that future Trainz products will enable this mode by default, so script authors should run in this mode or beyond when developing and testing their creations.

	==Show errors on legacy calls==		==Show errors on legacy calls==
	This mode is useful for finding/debugging content which attempts to use legacy ~~[[TrainzScript\|~~script]] features. While in 'Show errors on legacy calls' mode, Trainz will operate identically to 'Maximise performance' mode, but script calls to obsolete/legacy functions will also generate script exceptions. This allows content creators to determine which assets require fixing/replacing in order to support 'Maximise performance' mode, but due to the extra processing game performance will be slightly worse than when running in 'Maximise performance'.		This mode is useful for finding/debugging content which attempts to use legacy script features. While in 'Show errors on legacy calls' mode, Trainz will operate identically to 'Maximise performance' mode, but script calls to obsolete/legacy functions will also generate script exceptions. This allows content creators to determine which assets require fixing/replacing in order to support 'Maximise performance' mode, but due to the extra processing game performance will be slightly worse than when running in 'Maximise performance'.

	This mode should only be used for testing and debugging during content creation.		This mode should only be used for testing and debugging during content creation.
Line 26:		Line 30:
	* [[Asynchronous_Route_Streaming\| Asynchronous Route Streaming]]		* [[Asynchronous_Route_Streaming\| Asynchronous Route Streaming]]
	* [[HowTo/Search_for_objects_in_the_world\| How to Search for objects in the world]]		* [[HowTo/Search_for_objects_in_the_world\| How to Search for objects in the world]]
			* [[HowTo/Upgrade obsolete script functions]]

Pw3r: /* Show errors on legacy calls */

2022-03-03T00:33:38Z

Show errors on legacy calls

← Older revision		Revision as of 00:33, 3 March 2022
Line 19:		Line 19:

	==Show errors on legacy calls==		==Show errors on legacy calls==
	This mode is useful for finding/debugging content which attempts to use legacy script features. While in 'Show errors on legacy calls' mode, Trainz will operate identically to 'Maximise performance' mode, but ~~[[TrainzScript\|~~script]] calls to obsolete/legacy functions will also generate script exceptions. This allows content creators to determine which assets require fixing/replacing in order to support 'Maximise performance' mode, but due to the extra processing game performance will be slightly worse than when running in 'Maximise performance'.		This mode is useful for finding/debugging content which attempts to use legacy [[TrainzScript\|script]] features. While in 'Show errors on legacy calls' mode, Trainz will operate identically to 'Maximise performance' mode, but script calls to obsolete/legacy functions will also generate script exceptions. This allows content creators to determine which assets require fixing/replacing in order to support 'Maximise performance' mode, but due to the extra processing game performance will be slightly worse than when running in 'Maximise performance'.

	This mode should only be used for testing and debugging during content creation.		This mode should only be used for testing and debugging during content creation.

Pw3r at 00:33, 3 March 2022

2022-03-03T00:33:21Z

← Older revision		Revision as of 00:33, 3 March 2022
Line 4:		Line 4:

	==Maximise compatibility==		==Maximise compatibility==
	In maximise compatibility mode Trainz will disable all [[Asynchronous_Route_Streaming\|Route streaming]], and maintain the maximum level of script support possible. While running in this mode Trainz will keep the entire Route loaded into system memory, which can massively degrade performance.		In maximise compatibility mode Trainz will disable all [[Asynchronous_Route_Streaming\|Route streaming]], and maintain the maximum level of [[TrainzScript\|script]] support possible. While running in this mode Trainz will keep the entire Route loaded into system memory, which can massively degrade performance.

	This mode should only be used to run legacy content which fails to operate correctly with streaming enabled.		This mode should only be used to run legacy content which fails to operate correctly with streaming enabled.

	==Stream objects==		==Stream objects==
	This mode enables [[Asynchronous_Route_Streaming\|Route streaming]], but keeps the maximum level of script support possible. With streaming enabled, Trainz is able to unload portions of the Route which are inactive and far away from the player, increasing performance. This is especially evident on very large Routes. However, older scripted assets can experience issues, as they may attempt to query Route data which is not currently loaded.		This mode enables [[Asynchronous_Route_Streaming\|Route streaming]], but keeps the maximum level of [[TrainzScript\|script]] support possible. With streaming enabled, Trainz is able to unload portions of the Route which are inactive and far away from the player, increasing performance. This is especially evident on very large Routes. However, older scripted assets can experience issues, as they may attempt to query Route data which is not currently loaded.

	This mode is most appropriate for running content from older versions of Trainz.		This mode is most appropriate for running content from older versions of Trainz.

	==Maximise performance==		==Maximise performance==
	In maximise performance mode Trainz enables [[Asynchronous_Route_Streaming\|Route streaming]], and prevents many legacy script functions from running. This can hugely improve performance but older scripted content is likely to function incorrectly, or not at all. Specifically, script functions which are tagged with the 'obsolete' keyword are likely not to function, and may return empty, null, or incomplete results.		In maximise performance mode Trainz enables [[Asynchronous_Route_Streaming\|Route streaming]], and prevents many legacy [[TrainzScript\|script]] functions from running. This can hugely improve performance but older scripted content is likely to function incorrectly, or not at all. Specifically, script functions which are tagged with the 'obsolete' keyword are likely not to function, and may return empty, null, or incomplete results.

	This mode is the used to run most builtin and DLC content, but it can break Session gameplay in content from older versions of Trainz.		This mode is the used to run most builtin and DLC content, but it can break Session gameplay in content from older versions of Trainz.

	==Show errors on legacy calls==		==Show errors on legacy calls==
	This mode is useful for finding/debugging content which attempts to use legacy script features. While in 'Show errors on legacy calls' mode, Trainz will operate identically to 'Maximise performance' mode, but script calls to obsolete/legacy functions will also generate script exceptions. This allows content creators to determine which assets require fixing/replacing in order to support 'Maximise performance' mode, but due to the extra processing game performance will be slightly worse than when running in 'Maximise performance'.		This mode is useful for finding/debugging content which attempts to use legacy script features. While in 'Show errors on legacy calls' mode, Trainz will operate identically to 'Maximise performance' mode, but [[TrainzScript\|script]] calls to obsolete/legacy functions will also generate script exceptions. This allows content creators to determine which assets require fixing/replacing in order to support 'Maximise performance' mode, but due to the extra processing game performance will be slightly worse than when running in 'Maximise performance'.

	This mode should only be used for testing and debugging during content creation.		This mode should only be used for testing and debugging during content creation.

Pw3r at 00:26, 3 March 2022

2022-03-03T00:26:59Z

← Older revision		Revision as of 00:26, 3 March 2022
Line 1:		Line 1:
	This page details the various ~~"Compatibility~~ mode" options available in TRS19 and later, and how they affect gameplay and performance.		The "Compatibility mode" setting in Trainz is used to disable various optimisations in order to support legacy content (Routes, Sessions, and their dependencies).

			This page details the various compatibility mode options available in TRS19 and later, and how they each affect gameplay and performance.

	==Maximise compatibility==		==Maximise compatibility==
	~~TODO~~		In maximise compatibility mode Trainz will disable all [[Asynchronous_Route_Streaming\|Route streaming]], and maintain the maximum level of script support possible. While running in this mode Trainz will keep the entire Route loaded into system memory, which can massively degrade performance.

			This mode should only be used to run legacy content which fails to operate correctly with streaming enabled.

	==Stream objects==		==Stream objects==
	~~TODO~~		This mode enables [[Asynchronous_Route_Streaming\|Route streaming]], but keeps the maximum level of script support possible. With streaming enabled, Trainz is able to unload portions of the Route which are inactive and far away from the player, increasing performance. This is especially evident on very large Routes. However, older scripted assets can experience issues, as they may attempt to query Route data which is not currently loaded.

			This mode is most appropriate for running content from older versions of Trainz.

	==Maximise performance==		==Maximise performance==
	~~TODO~~		In maximise performance mode Trainz enables [[Asynchronous_Route_Streaming\|Route streaming]], and prevents many legacy script functions from running. This can hugely improve performance but older scripted content is likely to function incorrectly, or not at all. Specifically, script functions which are tagged with the 'obsolete' keyword are likely not to function, and may return empty, null, or incomplete results.

			This mode is the used to run most builtin and DLC content, but it can break Session gameplay in content from older versions of Trainz.

	==Show errors on legacy calls==		==Show errors on legacy calls==
	~~TODO~~		This mode is useful for finding/debugging content which attempts to use legacy script features. While in 'Show errors on legacy calls' mode, Trainz will operate identically to 'Maximise performance' mode, but script calls to obsolete/legacy functions will also generate script exceptions. This allows content creators to determine which assets require fixing/replacing in order to support 'Maximise performance' mode, but due to the extra processing game performance will be slightly worse than when running in 'Maximise performance'.

			This mode should only be used for testing and debugging during content creation.

			==See Also==
			* [[Asynchronous_Route_Streaming\| Asynchronous Route Streaming]]
			* [[HowTo/Search_for_objects_in_the_world\| How to Search for objects in the world]]

Pw3r: Created page with "This page details the various "Compatibility mode" options available in TRS19 and later, and how they affect gameplay and performance. ==Maximise compatibility== TODO ==Stre..."

2022-03-02T07:40:24Z

Created page with "This page details the various "Compatibility mode" options available in TRS19 and later, and how they affect gameplay and performance. ==Maximise compatibility== TODO ==Stre..."

New page

This page details the various "Compatibility mode" options available in TRS19 and later, and how they affect gameplay and performance.

==Maximise compatibility==
TODO

==Stream objects==
TODO

==Maximise performance==
TODO

==Show errors on legacy calls==
TODO