TrainzOnline - User contributions [en]

T:ANE NEW FEATURES

2015-05-01T14:09:01Z

Tram: /* Interlocking Towers */

Trainz: A New Era introduces a range of new features that Trainz fans have been waiting for for many years. This page introduces you to some of those features:

Page is under construction...

=Procedural Animated Junctions=

With the new "TANE" track, when you create a junction all the additional elements such as frogs, blades and sleepers are created and adjusted in real time. Older track can be replaced simply using the "Replace Assets" feature.

=Superelevation=
To add "tilt" to your track, use the Track Properties dialog and adjust each of the parameters.

=Weather & PFX Collision=
Smoke will collide with scenery objects and "supported" spline objects such as tunnels and bridges. Rain and snow now collide with the terrain and do not enter tunnels.

=Cabin Sway=
Adjust track condition and car suspension to increase or decrease the amount of pitch and roll with each car at various speeds.

Future wishlist:
* the train cabin usually has rigid connection to traincar body, so here should be the sway of driver's head relative to cabin...

=Train Motion=

==Add "bumps" to the track==

(i) Load your test route in Surveyor

(ii) Under Track Tab > Trackside Objects find Invisible Track Bump

(iii) Place a few bumps along your track and place a loco and wagons at the head of your track.

(iv) Click on Quickdrive, Save and enter Driver

(v) Start your loco and watch using external camera for visual bumps

==Adjust the track condition==

(i) Load your test route in Surveyor, and open the Track Tab

(ii) Click on the Properties tool (?) and click on the track. Adjust the default track condition from 50 to 1. Repeat for various track segments.

Note: You may want to place objects or paint the terrain next to where you change the track condition to see where you "should" notice the effect.

==Create your own "Bump"assets==

(i) Open Content Manager and using the Custom filter, search for Invisible Track Bump (asset will be available on DLS soon)

(ii) R-Click > Duplicate to clone the asset, then select the new asset and R-Click > Edit Config File text

(ii) Rename the line:

username "Invisible Track Bump" to

username "Invisible Track Bump 1"

(iii) Change the line:
track-bump-angles 1,0 to

track-bump-angles 0,1

(iv) Close and save the config file

(v) R-Click > Submit Edits

Note: Close Trainz and re-open (Start Trainz) after creating your bump assets for the changes to take effect.

==Try out your new Bump 1 asset==

(i) Place your new bump onto the track in Surveyor, run your test drive over the bump in Driver and see what happens differently with your new asset.

Hint: Rock and _ _ _ _

(ii) Create more assets following the same process trying different values other than 0 and 1.

==Adjust Rolling Stock Suspension==

(i) In Content Manager, locate the loco being used then R-Click > Edit Config file Text

(i) Add the following lines to the file that opens

suspension-stiffness 0.1

suspension-damping 0.1

suspension-pitch-limit 10

suspension-roll-limit 25

These relate to:

suspension-stiffness - The stiffness of the suspension, from 0 to 1 where 0 is floppy and 1 is completely rigid. Defaults to 0.75 
suspension-damping - Degree of suspension damping, where 0-1 is underdamped (will oscillate back and forward to gradually settle), 1 is critically damped (will move back to equilibrium as quickly as possible), >1 is overdamped (will move back to equilibrium more slowly). Defaults to 0.3. 
suspension-pitch-limit - maximum pitch angle of the vehicle, in degrees. Defaults to 0.5 
suspension-roll-limit - maximum roll angle of the vehicle, in degrees. Defaults to 4 
Note: random jolt movement will only occur on below average track (condition scalar >.5). As with other movement it also gets worse at high speed 

=Interlocking Towers=

Feature coming soon (not available in day 1 release version)

=New Graphics Features=
* Full world shadows
* Per-pixel HDR lighting
* A range of Post-processing effects including:
** Near and far depth of field blur
** HDR Tonemapping
** Bloom
** Convolution
** SSAO
** Grayscale
** Sepia
* Water reflections
* Water shaders

=Other "Cool New Stuff"=
* Ctrl+Mousewheel in Driver and Surveyor to change your field of view
* Shift-Mousewheel (or shift-arrow) in Driver and Surveyor to make finer adjustments to your camera
* Ctrl-shift-drag for even finer object height adjustment
* Shift +/- to adjust your draw distance without opening the Setting window
* Lots more to come...

=See Also=

* [[T:ANE NEW FEATURES]]
* [[T:ANE LATEST CHANGES]]

* [[Help:Main_Page]]

Help talk:TANE General FAQs

2015-04-18T19:54:40Z

Tram: /* Questions from the forums */

This page is designed to give users a central location to find out more information about current "known issues" with Trainz: A New Era or useful hints and tips about how to use the product.

=TANE "Community Edition" V1.0=
This version was release in December 2014. It was released to provide Kickstarter backers and pre-order customers a "sneak peak" at the current state of development of T:ANE and as a goodwill gesture since we had to delay release of the full version they were suporting.

This version included initial implementations of many of the new T:ANE features including shadows, train motion, procedural junctions, Test Track physics tools, multiplayer, pfx collisions and much more.

It did not include:
* Superelevation
* Interlocking Towers
* Merge Route
* In-cab controls (do not operate using mouse but hotkeys work)
* Alt y and alt u (additional camera options in surveyor)
* User Message (Driver reporting dialog)
* Engine Features:
** Post-processing effects (HDR, bloom, depth-of-field, SSAO etc)
** New shaders to add animated water effects
** Mirror reflections on water
** Environment cube-map support for "basic" reflections
** DirectX texture extraction (ie. screenshot)
** Extended scene shadow culling
** Differential shadows

A list of known issues was posted at:
http://forums.auran.com/trainz/showthread.php?116149-Your-T-ANE-Community-Edition-questions-answered-(Incl-Known-Issues

For people that understood this was not a final version of the product, it provided a great opportunity to see the work-in-progress and to help N3V Games identify the key issues that needed addressing.

=TANE "Community Edition" V1.1=
This version was released on Jan 28, 2015. It provided a huge list of updates to V1.0 (although a number of key features still needed to be implemented).

Updates included work on procedural junctions, content manager, shadows, basic post-processing effects, and a huge list of bug fixes and content updates: http://forums.auran.com/trainz/showthread.php?117145-Community-Edition-V1-1-Update-Now-Available

=TANE "Community Edition" V1.2=
This version is currently in final testing with our Kickstarter backers. It will be released in early April to all pre-order customers. It will continue the overall improvement process as we head towards our release day version of T:ANE on May 15, 2015 and delivers the "target graphics" feature set including per-pixel lighting, full world shadows, post-processing effects, water reflections and environmental fogging.

==Updating to CE v1.2==
There are two options available to update to CE v1.2 (build 74539).
* Full install - this will be available via your MyTrainz login
* Patch from build 73706 (4MB) - start build 72079 and you should be prompted to download the Trainz patcher.

You will be advised via email when you are able to upgrade to the latest version.

==Trainz Patcher==
The auto patcher appears when a new update is available on the patch server.
If you cancel this the first time, you will need to manually trigger the update by clicking Launcher > Trainz Settings > Install > Check for T:ANE Updates
You will be notified if a patch is available.
Click OK to begin the process.

Once the Trainz Patcher is downloaded, it will begin the updating process.
* ''Waiting for Trainz: A New Era to safely shut down...'' (this step may take a minute or so. If tane.exe does not close in the first few minutes, you can close it manually and the patch should then continue)
* ''Checking for available disk space for patching.''
* ''Searching for patches...''
* ''Downloading patch file...'' (this step depends on your Internet speed - a 4.4GB patch may take several hours to download)
* ''Unpacking patch file...''
* ''Patching from xxxxx to xxxxx...'' (this step depends on your hardware and will take from 10 minutes to an hour or more)
* ''No (more) patches at server for version: xxxxx''
* ''Updating Trainz asset database...'' (this may take several minutes)
* ''Patch Complete''

If you do not receive the Patch Complete message, your update has failed and you are likely to have problems. We suggest that you reinstall the game and begin the process again.

You may also get some error messages such as:
TADClientHandleNotification> unsupported notification code 0x7
IsAssetAccessorWithinBuildFilepaths> ignoring bad filepath: C:/Program Files/N3V Games/TANE - 73706/Resources/builtin/base/content/kuid 30501 1009.tzarc

As long as the patch shows as Complete, then there shouldn't be any problems with these errors.

==V1.2 Known Issues==
* Installer shows as "Not responding" for 10-30 minutes during install. Please be patient - it is working.
* "Starting TANE..." window appears for 1-3 minutes on first "Start Trainz" (compiling graphics shaders for chosen performance settings)
* Game pauses occasionally for 10-30 second when first loading a session or when moving to a new location or placing a new loco (this is due to compiling new material shaders which is done only once for each new material type in the scene)
* Performance can vary dramatically from one start-up to the next (for some hardware configurations using the same settings each time). We are looking into this issue as a priority but encourage users to check for more information on performance tuning at [[Help:Video_Settings]]
* Procedural Junction currently supports single turnouts only (the basic 1 track in, 2 tracks out junction)
* Still some minor issues with blade gaps, blade length, sleeper spacing, level of detail, moire effect that we are fine tuning
* Speedtrees not lit by train headlights
* Session loading can stall for several minutes (this is usually fixed on subsequent loads).
* Superelevated track is supported but not included in built-in routes (additional tools to come)
* TS12 built-in content that is NOT on the download station cannot be imported into TANE due to file formatting issues. We will be updating the DLS with additional TS12 content to ensure broad compatibility
* Older DLC items are not supported yet but we aim to have most existing DLC supported by release day.
* After downloading the Deluxe Routes you may need to exit the game window and click Start Trainz to see all the content in the Routes and Sessions menu.

=Questions from the forums=
This section is to highlight questions that are asked frequently on the Trainz forums. This link can then be used to provide people a central point to see answers to a variety of questions. 
Q. When will T:ANE be released? 
A. The retail version will appear in store in Europe, USA and Australasia on May 15, 2015. These releases are being handled by our various publishing partners. The retail version will be released on the same day via Simulator Central, MyTrainz and STEAM store.
 
Q. Can I upgrade from my "Community Edition" version of T:ANE?
 
A. For Simulator Central/MyTrainz users there will be an "auto-patch" available from CE V1.2 to the "release day" version of T:ANE. Just launch your CE V1.2 build and the auto-patcher prompt will appear. We expect to also have a patch from CE V1.1 to final but we cannot confirm that patch at this time 
For Steam users, this update will happen via your normal Steam update process
 
Q. I have pre-ordered T:ANE. How do I access the pre-release version?
 
A. Log in to your MyTrainz account and click on the TANE-CE link then choose your download location.
 
Q. Will T:ANE run on Windows 10?
 
A. T:ANE currently works well with Win10 Pro Technical Preview 10049. We expect performance to generally be better on Win10 that Win7 or 8 but of course we won't know for sure until Microsoft release the product officially (expected later in 2015).
 
Q. What are the system specifications for T:ANE?
 
A. 
Minimum:
OS: Windows 7 64bit, Windows 8 64bit
CPU: Intel i-series, AMD K10 or higher with at least 2Ghz Dual Core
GPU: NVidia GT 430 or ATI 5550 or better, at least 1GB dedicated VRAM supporting DirectX 11
Memory: 4GB
Hard Disk: 30GB free space
Soundcard: DirectX-compatible
Internet connection required
 
Recommended:
OS: Windows 7 64bit, Windows 8 64bit
CPU: Intel i5 3330, AMD FX 8350, QuadCore 2,3 Ghz
or better
GPU: NVidia GTX 660 or AMD HD 6950 or better, at
least 2GB dedicated VRAM supporting DirectX11
Memory: 8GB
Hard Disc: 30GB free space
Soundcard: DirectX-compatible
Internet connection required
 
Q. Performance is not as good as I would like - what are my options?
 
A. T:ANE delivers a huge update to the graphics capabilities with a range of new options that can be turned off and on or tweaked to suit your needs. The [[Help:Video_Settings]] page details the various performance options available to adjust for either better performance or better graphics - the key is that you cannot have both. In addition to these settings, the next best thing to do is to ensure your hardware is performing optimally (a fresh install of Win10 when it is released later this year is likely to boost things). The final step is to upgrade your hardware (use google to compare your current hardware benchmark versus the latest hardware).
 
Q. How do I import content from older version of Trainz?
 
A. Not all content from older versions is "built-in" to T:ANE. Due to file format errors, you cannot import "built-in" content directly. We suggest that you import the route and sessions and then use the Download Station to import the missing dependencies. Note that locally modified content can be imported directly.
 
Q. Where are the in-game screenshots located?
 
A. Currently, there is no in-game screenshot mechanism. We are adding this function for release.
 
Q. Do splines and track sit directly on top of the terrain now or there is still a 0.2m offset?
 
A. There is no longer an offset applied when smoothing splines. This was originally coded to avoid z-fighting when floating point accuracy was a problem for computers. Now the problem is that legacy track will "float" and show a shadow. This is a small price to pay for the ongoing benefits and resolves one of the most talked about "problems" with older Trainz versions.
 
Q. Doos the smoke from ANY locomotive (steam or diesel) automatically have collision or do they need to be edited? 
 
A. By turning on PhysX (in the Launcher settings) you automatically get smoke collisions with "supported" assets, without further effort on your part. Content creators, please check [[HowTo/Configure_a_spline_for_collisions]] for more info on creating the appropriate spline config tags.
 
Q. How do I access the post-processing settings and other "Developer" settings?
 
A. In Launcher > Trainz Setting > Developer, tick the "Enable Advanced Debug Tools" option then restart TANE for this change to take effect.
You can then access additional Developer Tools from the Developer menu option on the Launcher, such as in-game log or post-processing settings. Use these tools at your own risk.
 
Q. 
 
A.
 

=General Hints and Tips=
* When laying procedural track, use the straighten tool to lead into the junction to improve the junction shape.
* Turn PhysX ON to enable particle effects collisions (with supported splines and scenery assets)

=See Also =
[[Help:Video_Settings|TANE Performance Settings]]

[[Category: Help]]

Help talk:TANE General FAQs

2015-04-18T19:52:34Z

Tram: /* Questions from the forums */

This page is designed to give users a central location to find out more information about current "known issues" with Trainz: A New Era or useful hints and tips about how to use the product.

=TANE "Community Edition" V1.0=
This version was release in December 2014. It was released to provide Kickstarter backers and pre-order customers a "sneak peak" at the current state of development of T:ANE and as a goodwill gesture since we had to delay release of the full version they were suporting.

This version included initial implementations of many of the new T:ANE features including shadows, train motion, procedural junctions, Test Track physics tools, multiplayer, pfx collisions and much more.

It did not include:
* Superelevation
* Interlocking Towers
* Merge Route
* In-cab controls (do not operate using mouse but hotkeys work)
* Alt y and alt u (additional camera options in surveyor)
* User Message (Driver reporting dialog)
* Engine Features:
** Post-processing effects (HDR, bloom, depth-of-field, SSAO etc)
** New shaders to add animated water effects
** Mirror reflections on water
** Environment cube-map support for "basic" reflections
** DirectX texture extraction (ie. screenshot)
** Extended scene shadow culling
** Differential shadows

A list of known issues was posted at:
http://forums.auran.com/trainz/showthread.php?116149-Your-T-ANE-Community-Edition-questions-answered-(Incl-Known-Issues

For people that understood this was not a final version of the product, it provided a great opportunity to see the work-in-progress and to help N3V Games identify the key issues that needed addressing.

=TANE "Community Edition" V1.1=
This version was released on Jan 28, 2015. It provided a huge list of updates to V1.0 (although a number of key features still needed to be implemented).

Updates included work on procedural junctions, content manager, shadows, basic post-processing effects, and a huge list of bug fixes and content updates: http://forums.auran.com/trainz/showthread.php?117145-Community-Edition-V1-1-Update-Now-Available

=TANE "Community Edition" V1.2=
This version is currently in final testing with our Kickstarter backers. It will be released in early April to all pre-order customers. It will continue the overall improvement process as we head towards our release day version of T:ANE on May 15, 2015 and delivers the "target graphics" feature set including per-pixel lighting, full world shadows, post-processing effects, water reflections and environmental fogging.

==Updating to CE v1.2==
There are two options available to update to CE v1.2 (build 74539).
* Full install - this will be available via your MyTrainz login
* Patch from build 73706 (4MB) - start build 72079 and you should be prompted to download the Trainz patcher.

You will be advised via email when you are able to upgrade to the latest version.

==Trainz Patcher==
The auto patcher appears when a new update is available on the patch server.
If you cancel this the first time, you will need to manually trigger the update by clicking Launcher > Trainz Settings > Install > Check for T:ANE Updates
You will be notified if a patch is available.
Click OK to begin the process.

Once the Trainz Patcher is downloaded, it will begin the updating process.
* ''Waiting for Trainz: A New Era to safely shut down...'' (this step may take a minute or so. If tane.exe does not close in the first few minutes, you can close it manually and the patch should then continue)
* ''Checking for available disk space for patching.''
* ''Searching for patches...''
* ''Downloading patch file...'' (this step depends on your Internet speed - a 4.4GB patch may take several hours to download)
* ''Unpacking patch file...''
* ''Patching from xxxxx to xxxxx...'' (this step depends on your hardware and will take from 10 minutes to an hour or more)
* ''No (more) patches at server for version: xxxxx''
* ''Updating Trainz asset database...'' (this may take several minutes)
* ''Patch Complete''

If you do not receive the Patch Complete message, your update has failed and you are likely to have problems. We suggest that you reinstall the game and begin the process again.

You may also get some error messages such as:
TADClientHandleNotification> unsupported notification code 0x7
IsAssetAccessorWithinBuildFilepaths> ignoring bad filepath: C:/Program Files/N3V Games/TANE - 73706/Resources/builtin/base/content/kuid 30501 1009.tzarc

As long as the patch shows as Complete, then there shouldn't be any problems with these errors.

==V1.2 Known Issues==
* Installer shows as "Not responding" for 10-30 minutes during install. Please be patient - it is working.
* "Starting TANE..." window appears for 1-3 minutes on first "Start Trainz" (compiling graphics shaders for chosen performance settings)
* Game pauses occasionally for 10-30 second when first loading a session or when moving to a new location or placing a new loco (this is due to compiling new material shaders which is done only once for each new material type in the scene)
* Performance can vary dramatically from one start-up to the next (for some hardware configurations using the same settings each time). We are looking into this issue as a priority but encourage users to check for more information on performance tuning at [[Help:Video_Settings]]
* Procedural Junction currently supports single turnouts only (the basic 1 track in, 2 tracks out junction)
* Still some minor issues with blade gaps, blade length, sleeper spacing, level of detail, moire effect that we are fine tuning
* Speedtrees not lit by train headlights
* Session loading can stall for several minutes (this is usually fixed on subsequent loads).
* Superelevated track is supported but not included in built-in routes (additional tools to come)
* TS12 built-in content that is NOT on the download station cannot be imported into TANE due to file formatting issues. We will be updating the DLS with additional TS12 content to ensure broad compatibility
* Older DLC items are not supported yet but we aim to have most existing DLC supported by release day.
* After downloading the Deluxe Routes you may need to exit the game window and click Start Trainz to see all the content in the Routes and Sessions menu.

=Questions from the forums=
This section is to highlight questions that are asked frequently on the Trainz forums. This link can then be used to provide people a central point to see answers to a variety of questions. 
Q. When will T:ANE be released? 
A. The retail version will appear in store in Europe, USA and Australasia on May 15, 2015. These releases are being handled by our various publishing partners. The retail version will be released on the same day via Simulator Central, MyTrainz and STEAM store.
 
Q. Can I upgrade from my "Community Edition" version of T:ANE?
 
A. For Simulator Central/MyTrainz users there will be an "auto-patch" available from CE V1.2 to the "release day" version of T:ANE. Just launch your CE V1.2 build and the auto-patcher prompt will appear. We expect to also have a patch from CE V1.1 to final but we cannot confirm that patch at this time 
For Steam users, this update will happen via your normal Steam update process
 
Q. I have pre-ordered T:ANE. How do I access the pre-release version?
 
A. Log in to your MyTrainz account and click on the TANE-CE link then choose your download location.
 
Q. Will T:ANE run on Windows 10?
 
A. T:ANE currently works well with Win10 Pro Technical Preview 10049. We expect performance to generally be better on Win10 that Win7 or 8 but of course we won't know for sure until Microsoft release the product officially (expected later in 2015).
 
Q. What are the system specifications for T:ANE?
 
A. 
Minimum:
OS: Windows 7 64bit, Windows 8 64bit
CPU: Intel i-series, AMD K10 or higher with at least 2Ghz Dual Core
GPU: NVidia GT 430 or ATI 5550 or better, at least 1GB dedicated VRAM supporting DirectX 11
Memory: 4GB
Hard Disk: 30GB free space
Soundcard: DirectX-compatible
Internet connection required
 
Recommended:
OS: Windows 7 64bit, Windows 8 64bit
CPU: Intel i5 3330, AMD FX 8350, QuadCore 2,3 Ghz
or better
GPU: NVidia GTX 660 or AMD HD 6950 or better, at
least 2GB dedicated VRAM supporting DirectX11
Memory: 8GB
Hard Disc: 30GB free space
Soundcard: DirectX-compatible
Internet connection required
 
Q. Performance is not as good as I would like - what are my options?
 
A. T:ANE delivers a huge update to the graphics capabilities with a range of new options that can be turned off and on or tweaked to suit your needs. The [[Help:Video_Settings]] page details the various performance options available to adjust for either better performance or better graphics - the key is that you cannot have both. In addition to these settings, the next best thing to do is to ensure your hardware is performing optimally (a fresh install of Win10 when it is released later this year is likely to boost things). The final step is to upgrade your hardware (use google to compare your current hardware benchmark versus the latest hardware).
 
Q. How do I import content from older version of Trainz?
 
A. Not all content from older versions is "built-in" to T:ANE. Due to file format errors, you cannot import "built-in" content directly. We suggest that you import the route and sessions and then use the Download Station to import the missing dependencies. Note that locally modified content can be imported directly.
 
Q. Where are the in-game screenshots located?
 
A. Currently, there is no in-game screenshot mechanism. We are adding this function for release.
 
Q. Do splines and track sit directly on top of the terrain now or there is still a 0.2m offset?
 
A. There is no longer an offset applied when smoothing splines. This was originally coded to avoid z-fighting when floating point accuracy was a problem for computers. Now the problem is that legacy track will "float" and show a shadow. This is a small price to pay for the ongoing benefits and resolves one of the most talked about "problems" with older Trainz versions.
 
Q. Doos the smoke from ANY locomotive (steam or diesel) automatically have collision or do they need to be edited? 
 
A. By turning on PhysX (in the Launcher settings) you automatically get smoke collisions with "supported" assets, without further effort on your part. Content creators, please check [[HowTo/Configure_a_spline_for_collisions]] for more info on creating the appropriate spline config tags.
 
Q. How do I access the post-processing settings and other "Developer" settings?
 
A. In Launcher > Trainz Setting > Developer, tick the "Enable Advanced Debug Tools" option then restart TANE for this change to take effect.
You can then access additional Developer Tools from the Developer menu option on the Launcher, such as perfomance profiler or post-processing settings. Use these tools at your own risk.
 
Q. 
 
A.
 

=General Hints and Tips=
* When laying procedural track, use the straighten tool to lead into the junction to improve the junction shape.
* Turn PhysX ON to enable particle effects collisions (with supported splines and scenery assets)

=See Also =
[[Help:Video_Settings|TANE Performance Settings]]

[[Category: Help]]

T:ANE NEW FEATURES

2015-04-12T19:47:07Z

Tram: /* Cabin Sway */

Trainz: A New Era introduces a range of new features that Trainz fans have been wanting for many years. This page introduces you to some of those features:

Page is under construction...

=Procedural Animated Junctions=
Page is under construction...
=Cabin Sway=
Page is under construction...

* the train cabin usually has rigid connection to traincar body, so here should be the sway of driver's head relative to cabin...

=Weather & PFX Collision=
Page is under construction...
=Interlocking Towers=
Page is under construction...
=Train Motion=

==Add "bumps" to the track==

(i) Load your test route in Surveyor

(ii) Under Track Tab > Trackside Objects find Invisible Track Bump

(iii) Place a few bumps along your track and place a loco and wagons at the head of your track.

(iv) Click on Quickdrive, Save and enter Driver

(v) Start your loco and watch using external camera for visual bumps

==Adjust the track condition==

(i) Load your test route in Surveyor, and open the Track Tab

(ii) Click on the Properties tool (?) and click on the track. Adjust the default track condition from 50 to 1. Repeat for various track segments.

Note: You may want to place objects or paint the terrain next to where you change the track condition to see where you "should" notice the effect.

==Create your own "Bump"assets==

(i) Open Content Manager and using the Custom filter, search for Invisible Track Bump

(ii) R-Click > Duplicate to clone the asset, then select the new asset and R-Click > Edit Config File text

(ii) Rename the line:

username "Invisible Track Bump" to

username "Invisible Track Bump 1"

(iii) Change the line:
track-bump-angles 1,0 to

track-bump-angles 0,1

(iv) Close and save the config file

(v) R-Click > Submit Edits

Note: Close Trainz and re-open (Start Trainz) after creating your bump assets for the changes to take effect.

==Try out your new Bump 1 asset==

(i) Place your new bump onto the track in Surveyor, run your test drive over the bump in Driver and see what happens differently with your new asset.

Hint: Rock and _ _ _ _

(ii) Create more assets following the same process trying different values other than 0 and 1.

==Adjust Rolling Stock Suspension==

(i) In Content Manager, locate the loco being used then R-Click > Edit Config file Text

(i) Add the following lines to the file that opens

suspension-stiffness 0.1

suspension-damping 0.1

suspension-pitch-limit 10

suspension-roll-limit 25

These relate to:

suspension-stiffness - The stiffness of the suspension, from 0 to 1 where 0 is floppy and 1 is completely rigid. Defaults to 0.75
suspension-damping - Degree of suspension damping, where 0-1 is underdamped (will oscillate back and forward to gradually settle), 1 is critically damped (will move back to equilibrium as quickly as possible), >1 is overdamped (will move back to equilibrium more slowly). Defaults to 0.3.
suspension-pitch-limit - maximum pitch angle of the vehicle, in degrees. Defaults to 0.5
suspension-roll-limit - maximum roll angle of the vehicle, in degrees. Defaults to 4
Note: random jolt movement will only occur on below average track (condition scalar >.5). As with other movement it also gets worse at high speed

=See Also=

* [[T:ANE NEW FEATURES]]
* [[T:ANE LATEST CHANGES]]

* [[Help:Main_Page]]

"Motor" container

2013-07-05T20:22:17Z

Tram: /* brakeratio */

{{TOCright}}
The Motor container is a top-level [[config.txt file]] entry used by [[KIND Engine|Enginespec]] and [[KIND Steam-engine|Steam Enginespec]] assets.

==Supported Tags==

The Motor container supports the following tags. Each tag is show here with its default value.

motor
{
resistance 1.7
adhesion 5.0
maxvoltage 600.0
maxspeed 33.3
brakeratio 55000
max-accel 3500
max-decel 9000
throttle-notches 8
axle-count 6
surface-area 80.0
moving-friction-coefficient 0.03
air-drag-coefficient 0.00017
full-throttle-speed 33.0<big>*</big>
driving-wheel-weight-ratio 1.0
}
* Omit/delete as an illegal value in TRS2006{{Tech question}}

====resistance====
:Type: Decimal
:Desc: ''Not used''

====adhesion====
:Type: Decimal
:Desc: ''Not used''

====maxvoltage====
:Type: Decimal
:Desc: Voltage to ''traction motors''. This is used to scale the ammeter displayed in the cab. (Power is volts times amps - increasing the voltage means reducing the ammeter...)

====maxspeed====
:Type: Decimal
:Desc: Maximum speed in DCC mode.

====brakeratio====
:Type: Decimal
:Desc: Coefficient between the pressure in brake cylinder and the brake force.

====max-accel====
:Type: Decimal
:Desc: Accelerative force available in DCC mode. Note - this is a force, not a rate of acceleration. The rate of acceleration will depend on the mass of the train as well.

====max-decel====
:Type: Decimal
:Desc: Decelerative force available in DCC mode. Note - this is a force, not a rate of deceleration. The rate of deceleration will depend on the mass of the train as well.

====throttle-notches====
:Type: Integer
:Desc: Number of throttle notches

====axle-count====
:Type: Integer
:Desc: Number of axles on this vehicle. Used in rolling [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations resistance calculations].

====surface-area====
:Type: Decimal
:Desc: frontal surface area (sq ft) of vehicle. Used in air [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations resistance calculations].

====moving-friction-coefficient====
:Type: Decimal
:Desc: Used in rolling [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations resistance calculations].

====air-drag-coefficient====
:Type: Decimal
:Desc: Used in air [http://online.ts2009.com/mediaWiki/index.php5/%22Motor%22_container#Resistance_calculations resistance calculations].

====full-throttle-speed====
:Type: Decimal
:Desc:

====driving-wheel-weight-ratio====
:Type: Decimal
:Desc: Ratio (between 0.0 and 1.0) of the weight of this vehicle bearing down on driven wheels. Used by steam locos only.

==Example motor container==

''TBD''

[[Category:Config Container]]

==Resistance calculations==

These calculations occur according to Davis formula:

R = (1.3ˑm + 29ˑaxle-count) + moving-friction-coefficientˑmˑV + air-drag-coefficientˑsurface-areaˑV^2 + 20ˑmˑG 

R = total resistance in lb. including grade resistance 
V = speed - mph 
m = weight of the vehicle (tons) 
G = % grade (upgrade +, downgrade -)

Class MeshObject

2009-10-22T23:46:03Z

Tram: /* SetFXAttachment */

*[[TrainzScript Langage Reference|API Hierarchy]]
**[[Class GSObject|GSObject]]
***[[Class GameObject|GameObject]]
****[[Class PropertyObject|PropertyObject]]
****[[Class TrainzGameObject|TrainzGameObject]]
*****MeshObject
 

This is a base class for [[class Asset|Asset]] based game objects that have meshes, effects, animations and particles. Interface methods to deal with these are provided so things like showing or hiding a mesh, attaching a mesh to an attachment point or controlling an animation can be done from a script.

For animation Trainz interpolates between key frames. This means an intermediate animation frame is calculated dynamically to be-in-synch with the game's framerate.

Trainzscript is an interpreted scripting language intended to be used to monitor and react to events in the Trainz world, not to perform sophisticated real-time animation tasks. Using a script to start an animation in response to an event in a thread is reasonable. However trying to control animation tightly down to short intervals is likely to provide unsatisfactory results and to adversely affect overall performance of the game.

==MeshObject Messages==
Messages related to MeshObject assets:
*[[Animation-Event Message]]
*[[pfx Message]]
 

==GetFXAttachment==
{{MethodHeader|public native MeshObject GetFXAttachment(string effect)}}
;Parameters
*'''effect''' = name of the mesh effect to query.
;Returned Value
*Returns a reference to the MeshObject currently attached to the named effect.
;Syntax
MeshObject attachment = GetFXAttachment("coupler");
;Notes
*The method returns null if the effect is unoccupied.
 

==GetMeshAnimationFrame==
{{MethodHeader|public native float GetMeshAnimationFrame(string mesh)'''}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the animation file to be queried.
;Returned Value
*Current fame of the animation file within the specified mesh container.
;Syntax
float height = GetMeshAnimationFrame("zPosition")
;Notes
*Note that the returned value is likely to be an interpreted floating point value.
 

==GetMeshAnimationFrameCount==
{{MethodHeader|public native float GetMeshAnimationFrameCount(string mesh)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the animation file to be queried.
;Returned Value
*The number of frames in the specified animation.
;Syntax
float positions = GetMeshAnimationFrameCount("lever");
;Notes
*Note that the returned value is a float rather than an integer.
 

==GetTextureSelfIlluminationState==
{{MethodHeader|public native bool GetTextureSelfIlluminationState(string texture)'''}}
;Parameters
*'''texture''' = root name of ''*.texture.text'' file to query.
;Returned Value
*Returns true if the specified texture has self illumination set.
;Syntax
bool isEmissive = GetTextureSelfIlluminationState("texture");
;Notes
*Compatibility warning: Use of this function is not recommended, it may become non-functional in future Trainz versions.
 

==HasMesh==
{{MethodHeader|public native bool HasMesh(string mesh)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh to be queried.
;Returned Value
*None
;Syntax
if (HasMesh("ventilation")) StartMeshAnimationLoop("fans");
;Notes
*
 

==SetFXAnimationState==
{{MethodHeader|public native void SetFXAnimationState(string effect, bool state)}}
;Parameters
*'''effect''' = name of attached-animation effect containing the animation to play.
*'''state''' = true to start the animation loop, false to stop.
;Returned Value
*None
;Syntax
if (gateClosed) SetFXAnimationState("gate",false);
;Notes
 

==SetFXAttachment==
{{MethodHeader|public native MeshObject SetFXAttachment(string effect, Asset asset)'''}}
;Parameters
*'''effect''' = effect containing the attachment to be manipulated.
*'''asset''' = mesh asset to attach to the effect. If asset is null any existing asset will be removed and nothing will be added.
;Returned Value
*Returns a reference to the MeshObject which has been attached to the named effect.
;Syntax
MeshObject lamp = SetFXAttachment("lamp0",redlamp);
;Notes
*Returns null if the effect is unoccupied when the method returns.
 

==SetFXCoronaTexture==
{{MethodHeader|public native void SetFXCoronaTexture(string effect, Asset texture)}}
;Parameters
*'''effect''' = effect containg the corona to be manipulated.
*'''asset''' = corona texture asset to attach to the effect. If asset is null the corona will be turned off.
;Returned Value
*None
;Syntax
SetFXCoronaTexture("stopLight",redCorona);
;Notes
*Other corona parameters such as frequency and size are defined in ''config.txt'' and cannot be altered by script code.
 

==SetFXNameText==
{{MethodHeader|public native void SetFXNameText(string effect, string text)}}
;Parameters
*'''effect''' = effect containg the name effect to be changed.
*'''text''' = new string value.
;Returned Value
*None
;Syntax
SetFXNameText("home","Shangri-La");
;Notes
*Method will not accept an empty string in the ''text'' parameter.
 

==SetFXTextureReplacement==
{{MethodHeader|public native void SetFXTextureReplacement(string effect, Asset textureGroup, int index)}}
;Parameters
*'''effect''' = texture-replacement effect to be changed.
*'''textureGroup''' = reference to texture group asset which is the source of the texture to be applied.
*'''index''' = index into ''textures'' table of texture-group indicating which texture to apply.
;Returned Value
*None
;Syntax
SetFXTextureReplacement("load","loadTextures",5); // applies texture 5 from texture-group
SetFXTextureReplacement("load",null,0); // clears the effect, reinstating the texture defined in the asset.
;Notes
*Use null in the textureGroup parameter to turn texture replacement off.
 

==SetMesh==
{{MethodHeader|public native void SetMesh(string mesh, float fadeDuration)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh to be displayed.
*'''fadeDuration''' = period in seconds during which mesh visibility will be faded in or out.
;Returned Value
*None
;Syntax
SetMesh("default",0.5);
;Notes
*Shows the specified mesh and hides all other meshes.
*If fadeDuration is 0.0 the mesh transition will be instantaneous.
 

==SetMeshAnimationFrame==
{{MethodHeader|public native void SetMeshAnimationFrame(string mesh, float frame) 
public native void SetMeshAnimationFrame(string mesh, float frame, float period)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the animation file to be manipulated.
*'''frame''' = the frame position to which the animation is to be moved, this may be an interpolated value.
*'''period''' = the period over which the animation will be moved from its current position to the newly specified point.
;Returned Value
*None
;Syntax
SetMeshAnimationFrame("default",5.0); // move the animation to frame 5 instantaneously
SetMeshAnimationFrame("default",5.0,2.0); // move the animation to frame 5 over 2 seconds
;Notes
*Moves the specified animation to the specified frame.
*For the first variant the transition is instant.
*For the second variant the transition will complete during the specified period.
 

==SetMeshAnimationSpeed==
{{MethodHeader|public native void SetMeshAnimationSpeed(string mesh, float speed)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the animation file to be manipulated.
*'''speed''' = multiplication factor to apply to the original animation speed.
;Returned Value
*None
;Syntax
SetMeshAnimationSpeed("fans",2.0); // run fans at double speed
SetMeshAnimationSpeed("fans",-1.0); // run fans backwards at original speed
;Notes
*Modifies the speed at which the animation is played.
*The original speed is multiplied by the new speed factor.
*Use negative values to make the animation run in reverse.
 

==SetMeshAnimationState==
{{MethodHeader|public native void SetMeshAnimationState(string mesh, bool state)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the animation file to be played.
*'''state''' = the direction in which the file is to be played, true for forwards, false for backwards.
;Returned Value
*None
;Syntax
SetMeshAnimationState("door",true); // opens the door
SetMeshAnimationState("door",false); // closes the door
;Notes
*This method plays animations and is best suited to those which have defined start and end points such as the opening and closing of a gate or door.
*If ''state'' is true the animation plays forwards from its current position to the last frame. If the current position is already at the last frame the call has no effect.
*If ''state'' is false the animation plays backwards from its current position to the first frame. If the current position is already at the first frame the call has no effect.
 

==SetMeshVisible==
{{MethodHeader|public native void SetMeshVisible(string mesh, bool visible, float fadeDuration)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh to be displayed.
*'''visible''' = true to show the mesh, false to hide it.
*'''fadeDuration''' = period in seconds during which mesh visibility will be faded in or out.
;Returned Value
*None
;Syntax
SetMeshVisible("driver", false, 1.0);
;Notes
*If fadeDuration is 0.0 the mesh transition will be instantaneous.
 

==SetTextureSelfIllumination==
{{MethodHeader|public native void SetTextureSelfIllumination(string texture, float r, float g, float b)}}
;Parameters
*'''texture''' = root name of ''*.texture.text'' file to query.
*'''r,g,b''' = red green and blue components of self illumination value to apply, range 0 .. 1 where 1 is equal to 100%.
;Returned Value
*None
;Syntax
SetTextureSelfIllumination("interior",0.5,0.5,0.5);
;Notes
*Applies an emissive component to the texture using the red, green and blue components specified.
*Compatibility warning: Use of this function is not recommended, it may become non-functional in future Trainz versions.
 

==StartMeshAnimationLoop==
{{MethodHeader|public native void StartMeshAnimationLoop(string mesh)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the animation file to be played.
;Returned Value
*None
;Syntax
StartMeshAnimationLoop("windmill");
;Notes
*This method plays animations and is best suited to those which are designed to run in a continuous loop.
*The speed of the animation can be altered using [[#SetMeshAnimationSpeed|SetMeshAnimationSpeed()]]
*Using [[#SetMeshAnimationSpeed|SetMeshAnimationSpeed()]] with a negative value will cause the animation to play in reverse.
*[[#StopMeshAnimation|StopMeshAnimation()]] will halt the animation.
 

==StopMeshAnimation==
{{MethodHeader|public native void StopMeshAnimation(string mesh)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the animation file to be stopped.
;Returned Value
*None
;Syntax
StopMeshAnimation("default");
;Notes
*Turns animation off for the specified mesh.
 

==SwapTextureOnMesh==
{{MethodHeader|public native void SwapTextureOnMesh(string mesh, string oldTexture, string newTexture)}}
;Parameters
*'''mesh''' = the name of the mesh or submesh container which includes the texture to be changed.
*'''oldTexture''' = the original ''*.texture.txt'' file to use as the source of the transition.
*'''newTexture''' = the new ''*.texture.txt'' file to apply.
;Returned Value
*None
;Syntax
SwapTextureOnMesh("left-passenger-door","gwr","lms");
;Notes
*Swap one texture against another texture on specified mesh.
*Similar to texture-replacement effects, but without the need for an extra texture asset.
*'''possible bug''' Texture names in the .im file must be lower case for this function to work properly.
 

==Code Examples==

==Related Methods==

==Categories==
[[Category:Script Class]]