How to Use Environment Tools

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22. A video tutorial specific to setting the environmental controls can be found at TRS19 Environment and Lighting Tutorial

The Environmental Tools give you access to settings that control the season of the year, basic weather conditions, lighting, geographic location, etc The Environment Tools are used to set:- the skybox - to configure the cloud cover the weather - from rain to snow to clear. Weather can also be set from the Main Menu - Settings options and by using Session rules the wind speed - which will only affect the swaying motion of Speedtrees the snowline - the minimum snow altitude for assets that have a snow effect layer. Used with the world origin altitude setting the date - for assets that have different seasonal options. Used with the world origin to set the season of the year the lighting - the light levels and colours through a 24 hour period the water colour and water surface effects (smooth, rough, etc) for Legacy Water only the road traffic - enabled/disabled the world origin - geographic coordinates (used with the date to set the season of the year) and altitude (used with the snowline to set snow effects) To set the Session Start Time use the  Startup Options Rule or the  Time and Rate Rule in the  Session Editor Notes: There is no Save or OK button on the Environment Tools Window. As soon as you enter or select a setting it will be set. When finished editing simply Left Click the window Off button BUT make sure you SAVE before exiting Trainz Seasons (for those assets that show seasons - e.g. snow, leaf colours, etc) are controlled by the Date, Snow Altitude (for snow effects) and Location (World Origin) settings The dates at which the seasons change in Trainz are:- March 1st - Southern Hemisphere Fall (Autumn), Northern Hemisphere Spring July 1st - Southern Hemisphere Winter, Northern Hemisphere Summer October 1st - Southern Hemisphere Spring, Northern Hemisphere Fall (Autumn) December 1st - Southern Hemisphere Summer, Northern Hemisphere Winter

Loading and Saving Environmental Settings

	A newly created Route will have its environmental settings set to their default values
	A newly created Session will have its environmental settings set to those of the Route
	Where the Route and Session have different saved environmental settings, those in the Session will be used

In Routes

When you create a new route, or load an existing one with NO saved Environmental settings, then all those settings will be set to their default values If you change any of the nvironmental settings of a route then you must also edit the route (e.g. move a route asset) and save it for those settings to become part of the route

In Sessions

When you create a new session, or load an existing one with NO saved Environmental settings, then the session will use the settings that are part of the route which will be the default settings if none have been set for the route When you load an existing session with saved Environmental settings, then those settings will take priority over the same settings that have been saved in the route If you change any of the Environmental settings of a session then you must also edit the session (e.g. move a session asset or change a session property) and save it for those settings to become part of the session

Because a Session can have its own environmental settings you are able to create Sessions set in different conditions - some examples:- separate summer and winter sessions or for any season - see the Set Date and Set World Origin sections below a session set in an early morning winter fog - see the Fog Control section below spring rain shower and cool overcast autumn (fall) sessions - see the Set the Weather and Set the Sky sections below

The Environment Tool

Open the Environment Tools Editor from the Surveyor Main Menu in TANE as shown below left or from the Surveyor Edit Menu in TRS19 and later versions as shown below right.

In all versions select the option  Edit Environment...

This will open the Environment Properties Window as shown below.

Notes: The Clock Dial shown in this tool does NOT set the game time. It sets the times at which lighting conditions change To set the Session Start Time use the  Startup Options Rule or the  Time and Rate Rule in the  Session Editor TRS19 and later Trainz versions have an additional control that adjusts the lighting level, as shown below

Lighting

The Lighting Tools control the ambient, sun and water colours. This tool tab is opened by default whenever the Environment Editor is opened

Light and Time

The dial shown is a 24 hour clock that sets the lighting conditions at selected times of the day and night

The Diurnal Cycle Steps: To see the full 24hr cycle:- Left Click on the Diurnal Cycle button to set the clock running through the full 24 hour cycle in just 30 seconds Left Click on it again to stop the cycle The scene shown in Surveyor will display the lighting conditions that correspond to the time on the clock as the hand sweeps around. Selecting a Time Steps: To set a specific time:- Left Click and Drag the clock pointer arm to the required position on the clock dial Notes: The clock dial does NOT set the starting time for a session To set the Session Start Time use the  Startup Options Rule or the  Time and Rate Rule in the  Session Editor In Trainz Plus and TRS22 the Session Time can be set "on the fly" in Driver from the  Session Options Window. But the time setting is approximate, it is not exact

Setting the Lighting Conditions

Colour Control Points

The ring around the dial contains a number of green dots.

	Each dot is a Control Point that sets the specific Red, Green and Blue colour values, and other lighting features, at the time shown on the clock
	Each of the RGB colour value can be altered by dragging its needle point to a new position around the dial

Steps: To see the settings for a particular time control point:- Left Click on one of the green points around the ring. The clock dial will immediately point to the selected dot and time The control point will be highlighted and the RGB Wheels will display the Red Green and Blue values that have been set at that point

Steps: To alter the colour settings for a particular time control point:- select an RGB colour wheel and either:- Left Click on the required value spot on its colour dial, OR Left Click and Drag the pointer to the new value on its colour dial To set all 3 colour wheels to the same value hold the down  Shift  key while performing option or above

Types of Lighting

Notes: Each control point stores the RGB values for three different types of lighting in the scene. The Ambient Colour which is the directional lighting and mostly affects the hue of buildings and other scenery objects The Sun Colour which affects the colour of the sunlight and mostly affects the hue of the terrain The Water Colour (for Trainz versions before TRS19 SP4) which affects the colours reflected by water surfaces

The 3 boxes below the colour wheels and next to the Sky box show the colour effects created for each type of lighting at the selected time.

Ambient Colour

Steps: To set the Ambient Color:- Left Click on the control point for the time that you want to edit Left Click on the top box of the three. This is the Ambient Colour. The 3 dials will show the RGB values for the Ambient Colour at the selected time and the Ambient color preview box will show the colour produced by the RGB settings You can then change the RGB settings for the Ambient Colour by either:- Left Click and Drag the pointers to new positions on the coloured rims of each dial, OR Left Click on a new position on the coloured rims of each dial

Sun Colour

Steps: To set the Sun Colour:- Left Click on the control point for the time that you want to edit Left Click on the middle box of the three. This is the Sun Colour. The 3 dials will show the RGB values for the Sun Colour at the selected time and the Sun color preview box will show the colour produced by the RGB settings You can then change the RGB settings for the Sun Colour by either:- Left Click and Drag the pointers to new positions on the coloured rims of each dial, OR Left Click on a new position on the coloured rims of each dial

Water Colour

This Water Colour control only affects the colour of the water created using the Add Water tools (for Classic or Legacy Water) in the Topology menu (the  F1  key in Surveyor Classic). It has no effect on the colour of water created as Water Layers used in TRS19 SP4 and later versions.

Water Colour values set for one control point become the values for ALL the control points Steps: To set the Water Colour for "legacy water" only:- Left Click on any control point Left Click on the bottom box of the three. This is the Water Colour. The 3 dials will show the RGB values for the Water Colour at the selected time and the Water color preview box will show the colour produced by the RGB settings You can then change the RGB settings for the Water Colour by either:- Left Click and Drag the pointers to new positions on the coloured rims of each dial, OR Left Click on a new position on the coloured rims of each dial

Water Effect Layer

In TRS19 SP4 and later a new method of adding water to a route was introduced - as an Effect Layer. The original method, now called Legacy Water, can still be used in a route but it is NOT recommended that both water methods (Legacy and Effect Layer) are used in the same route.

TRS19 SP4
The water colour for the Water Effect Layer is set by altering the colour for the Top Skybox.

Steps: To set the Water Colour in TRS19 SP4:- select a time control point for a specific time of day Left Click in the top region of the Skybox - a while line or bar will appear across the region Set the RGB color wheels for the Top Skybox region for the selected time Repeat for each time control point as required (the Water Effect Layer can have its colour changed at different times of the day/night)

See The Skybox below for more details.

Trainz Plus and TRS22

The major changes to water introduced in these versions are:- multiple water layers can be added to a route each water layer has its own colour controls built into its properties (i.e. the colours are not part of the Skybox) Legacy Water is NOT compatible with the Water Effect Layers in Trainz Plus and TRS22

Mixing Colours

Notes: Getting the "right colours" can be more of an art than a science. To set the exact colour you want means mixing the correct quantities of Red, Green and Blue. Each of these colours has 256 different values from 0 to 255 that, when combined, produce over 16 million different possible colours - but many monitors and most eyeballs will not be able to tell the differences between many of those 16 million colours.

Setting all three colours to the same values will produce monotones from Black to White with 254 different shades of gray between those two tones. You can quickly set all three dials to the exact same value by a  Shift  Left Click on a dial position on any one of the three dials. Note that in the examples below, the "tyre" around each dial shows the exact quantity of colour that is being added. R = 0; G = 0; B = 0 R = 128; G = 128; B = 128 R = 255; G = 255; B = 255 Black 50% Gray White All other colours are made by mixing different quantities of the three colours.

Example  1:  Setting Grey Scale Values for the Ambient and Sun Colours This is an example only Setting both the Ambient and Sun colours to different shades of grey, as shown in the example below, can solve many brightness issues. Time 06:00 07:00 10:00 12:00 18:00 Ambient Sun RGB values (all 3 RGB dials set equally) Ambient 128 192 224 255 128 Sun 160 192 224 224 192 Brightness (TRS19/Trainz Plus/TRS22) 40% 50% 50% 50% 40%

Example  2:  Setting a Water Colour For Legacy Water only:- Creating a colour suitable for water (RGB values are approximate) Starting with pure Blue R = 0; G = 0; B = 255 Add pure Green to make the colour Cyan R = 0; G = 255; B = 255 Scale back (darken) the Green R = 0; G = 155; B = 255 Scale back a bit more R = 0; G = 128; B = 255 Add some Red R = 75; G = 128; B = 255

Shadows

The tone of shadows cast by objects is controlled by the combined effects of the Ambient Color and the Sun Color settings

These settings are examples only Initial settings for the Ambient and Sun colours are shown in the image below with the resulting shadow effects. Lighting conditions are set for mid to late afternoon Shadows and lighting are "normal" for the time shown
Ambient colours set to 0. Sun colours unchanged The overall lighting is noticeably darker. Shadows are black Ambient colours set to Maximum. Sun colours unchanged The overall lighting is noticeably lighter. Shadows are lighter	Ambient colours unchanged. Sun colours set to 0 Scene is evenly lit but much darker. No shadows. A heavily overcast late afternoon? Ambient settings unchanged. Sun settings set to Maximum Scene lighting is noticeably brighter. Shadows are darker but not black. A summer afternoon?

Moving the Ambient and Sun colour controls to values between 0 and Maximum will alter the results. Experimentation is a good idea.

Lighting Level Control

TRS19 and later Trainz versions have an additional control that is placed next to the Ambient, Sun and Water colour boxes. This sets the overall brightness or lighting level for each control point.

Steps: To set the brightness level:- select a time control point for a specific time of day move the brightness slider to:- the BOTTOM to give maximum brightness level the TOP to give minimum brightness level a point in between these two positions for an intermediate lighting level Repeat for each time control point as required.

Resetting the Lighting Conditions

All the lighting colour settings can be reset back to the Trainz default colours.

Steps: To reset ALL the lighting conditions to their default values:- Left Click on the Color Reset button, then either:- Left Click on the icon to accept the reset, OR Left Click on the icon to reject the reset

Adding a New Control Point

New control points can be added to the clock dial

Steps: To add a new time control point:- Left Click on the Add button Left Click on the ring at the place where the new control point is to be located

Notes: the Add button will remain active (selected) until it is deactivated so each Left Click can add another control point. The button can be deactivated by a Left Click on it again or by selecting another button.

Notes: During the running of a Session the lighting will "morph" or "transform" at a steady rate from the set of colour values at one control point to the set of colour values at the next control point. Left Click on the Diurnal Cycle button for a demonstration. If the control points are far apart then the transition will be gradual If the control points are close together then the transition will be faster If there are several control points grouped closely together then the transitions can be more dramatic The places where you would need faster dramatic transitions would be at dawn (around 06:00) and dusk (around 18:00)

Deleting a Control Point

Existing control points can be deleted

Steps: To delete an existing time control point:- Left Click on the Delete button Left Click on the control point to be deleted

Notes: the Delete button will remain active (selected) until it is deactivated so each Left Click can delete another control point. The button can be deactivated by a Left Click on it again or by selecting another button.

Moving a Control point

Existing control points can be moved

Steps: To move a control point:- Left Click on the Move button Left Click on the control point to be moved and either:- Left Click and Drag the point to its new position around the ring, OR Left Click on the ring at the spot where the point is to be placed

Notes: the Move button will remain active (selected) until it is deactivated so each Left Click and Drag can move another control point. The button can be deactivated by a Left Click on it again or by selecting another button.

The Skybox

The Skybox sets the sky colours in three different regions of the sky at the selected time of day, as shown in the extreme example below

Each control point also stores the Skybox settings for that particular time Steps: To set the Skybox colours:- Select a control point for a specific time of day Left Click in a region of the Skybox (top, middle, bottom) - a while line or bar will appear across the selected region Set the RGB color wheels for the selected region Repeat for the other two regions and for other times of the day/night as needed In the areas between the three regions the colours will be blended to create a smooth transition. The Top Skybox region will set the colour for the Water Effect Layer in TRS19 SP4. In Trainz Plus and TRS22 each Water Effect Layer (there can be more than one) has its water colour built into the layer properties - for more information see  Edit Effect Layers.

Do you need an Overcast Sky for your scene? Steps: To create an overcast sky:- for each daylight control point set each Skybox region (top, middle, bottom) to shades of gray (see Mixing Colours above). in the Environment Tab (see below), set the Sky Type to No Cloud 01 Note: This will not remove or hide the sun.

Fog Control

This controls the level of "fog" in the scene

Settings: Select a control point for a specific time of day Move the slider to the required position Repeat for other times of the day/night as needed

Note: Each control point also stores the Fog setting for that particular time Increasing the fog level can also increase the brightness level (real fog does scatter light causing the background to appear brighter). In TANE you may need to reduce the RGB levels to compensate. In TRS19/Trainz Plus/TRS22 you can reduce the Brightness level to compensate.

Location

The Location Tools control the geographic and date (season) data for the Route and Session. Left Click on the Location tab icon to open the Location Tool Controls

Set the Date The top section is a standard calendar selection tool that allows you to set the month and the day of the month. The only effect this has in Trainz is to set, with the geographic coordinates, the season of the year. Settings: Set the Month by scrolling left or right through the 12 month calendar Set the Day (if required) by a Left Click on the date in the selected month You can also set a date by typing it directly in the text entry box above the calender The entered date can be saved in the Route, the Session or both depending on whether you are editing the Route or the Session or both You must make a change to an object in a Route Layer or a Session Layer for the date change to be recorded as part of the Route or the Session (or both) Sick of it always being winter in your Session during winter? Want it to always be summer instead? Set the date to a Summer month. This will be saved when you edit and save the Session - BUT make sure that you have set the World Origin to the correct hemiphere.

Notes: It is possible to set a date to a particular Year but this will have no effect on the operation of the Route or Session. Essentially only the Month is important. Setting the year to 1900, for example, will not recreate an early 20th Century railroad. Time periods have to be recreated by carefully selecting scenery and rolling stock assets that belong to that particular time period.

To Set The Route Date:  Load a Route into Surveyor Change the date Edit the Route (e.g. edit a Route Layer object or the terrain) Save the Route  To Set The Session Date:  Load a Session into Surveyor Change the date Edit the Session (e.g. edit a Session Layer object, a commodity item or Session Rule) Save the Session  To Set Both The Route and Session Dates:  Load a Session into Surveyor Change the date Edit both the Route and the Session Save both the Route and the Session

Notes: There is an order of priority with dates in Routes and Sessions If the Route and the Session are saved with different dates, then the Session date will decide the visible season. If a Session does not have a saved date, then the Route date will decide the visible season. If no date has been saved in the Route and the Session, then today's date will decide the visible season. This order of priority also applies to all Environmental Settings except the World Origin which only applies to a Route. In Trainz Plus and TRS22 the Month and therefore, the Season of the Year can be set "on the fly" in Driver from the  Session Options Window. The North/South Hemisphere must also be correctly set in the World Origin or Region

Set World Origin

The middle section is the World Origin Tool and sets the geographic location, including the altitude, of the route using a World Origin marker that is only visible in Surveyor.

	Setting the World Origin does NOT set regional features such as which side of the road the cars drive on. Use the Route Editor - Region setting for that
	The World Origin is always part of a Route, not part of a Session

Steps: To set the World Origin:- Move the Surveyor view to the location where you want the origin marker to be placed Left Click on the Add world origin button Left Click the selected location in the layout to place the marker Another Left Click will simply move the marker, it will not add a new one

The World Origin marker

Once it has been placed, the marker can be moved by a Left Click and Drag or a Left Click. After adding the marker it should be edited to add geographic data.

Left Click on the Go to world origin icon to move the Surveyor screen so that it is centred on the World Origin marker.

Left Click on the Edit world origin icon to set or edit the World Origin data. See Editing the World Origin below.

Editing the World Origin

The  Reset  button sets ALL values to their defaults Left Click on the icon to accept the entered data Left Click on the icon to reject the entered data

Enter the geographic data for the world origin Latitude and Longitude in degrees and minutes (with seconds added as the decimal fraction of the minutes - 10'30" would be entered as 10.50) Hemispheres - N/S (North/South) and E/W (East/West). The North/South setting along with the Date will set the season of the year Altitude in metres. This, with the Snowline setting, will affect the appearance of assets that have a built in snow effect Notes: The Latitude determines the sun angle and, with the Date, the season of the year Setting a high latitude value North or South will NOT change the times of sunrise or sunset. They are fixed at 06:00 and 18:00

Deleting the World Origin

There is no delete button for the World Origin marker, but you can still delete it

In Surveyor 1.0 (Classic)  Steps: To delete the world origin:- open the Objects Tool flyout (press the  F3  key) select the Delete tool Left Click on the World Origin marker  In Surveyor 2.0  Steps: To delete the world origin:- select the Free Move Tool (press the  S  key) or the Fine Adjustment Tool (press the  D  key) Left Click on the World Origin marker press the  Delete  key

Notes: All routes MUST have a World Origin If you delete the World Origin marker then it will be hidden and will take the default coordinates of latitude 52.45 N, longitude 13.3 E, altitude 0 metres - which places it in Berlin

Traffic Control

This tool simply turns the road traffic ON and OFF

Notes: This road traffic tool:- only works on roads that have been designed to use road traffic (not all roads support traffic) does not set the road traffic characteristics - the number and types of vehicles, which side of the road is used. These features are set in the Route Editor - Region by assigning a Region to the route. Details on how to create and assign a Region asset can be found in the  Create a Region Asset Wiki page

Settings: Left Click on the car icon to enable and disable traffic

Weather and Water

	The Weather and Water Tools control the weather (sky, weather type, wind, snow) and water surface data for the Route and Session. Left Click on the Weather and Water tab icon to open the Weather and Water Tool Controls
	To set the Water Colour, refer to the Setting the Lighting Conditions section above

Set the Sky This sets the basic sky and cloud characteristics Settings: Left Click on the Sky Title (Cloud Cover) to select from a drop down list of sky types, OR Scroll through the list by using the Scroll icons The box below the sky title will give a preview of the selected sky. Set the Weather This sets some very basic weather conditions. The set conditions will be constant throughout the running of a Session. Settings: Move the slider to set the weather between Rain and Snow Notes: There are Session Rules that also control the weather, including changeable weather conditions. Check the Trainz Wiki Session Rules list at Session Rules - Weather In Trainz Plus and TRS22 the Weather can be set "on the fly" in Driver from the  Session Options Window

Trainz Plus/TRS22 Platinum Driver Weather Controls In Trainz Plus and TRS22 when in Driver mode open the  Window Menu and  Session Options  and you will have access to Weather Controls to change the weather "on-the-fly".  Weather  this drop down list will show all the different weather conditions from Clear to Heavy Snow.  Left Click  on the required setting  Weather Changeability  this drop down list will set the rate and range of the weather changeability.  Left Click  on None, Periodic or Extreme

Wind Strength

This setting only effects SpeedTrees

	Settings: Move the slider to set the wind strength between zero (left) and maximum (right)

Set the Water Surface

This sets the water surface effects for Legacy Water only. It does not apply to Water Effect Layers

Settings: Left Click on the Water Surface to select from a drop down list of surface effects, OR Scroll through the list by using the Scroll icons

Set the Snow Altitude

This sets the altitude at which objects built with snow effects will display snow in winter. It has no effect on objects created without this feature

Settings: Enter the minimum altitude, in metres, at which snow can appear.

Notes: The snow effects will only appear in winter if the altitude of the terrain is at or above the Snow Altitude‡ Only those assets that were created with snow effects will be affected by this setting ‡ a few assets may display snow even if they are placed below the set Snow Altitude. This is usually the result of an error by the asset creator.

---

---

Trainz Wiki

More Tutorials and Guides to Using Trainz How to Guides Driver Commands List Session Rules List (Alphabetical) with Parameters Session Rules List (Categories) With Parameters

---

This page was created by Trainz user pware in July 2018 and was last updated as shown below.

---