How to Use Layers

From TrainzOnline
Jump to: navigation, search

The information in this Wiki Page applies to TANE, TRS19, Trainz Plus and TRS22.

      Next Down Bottom

Contents

Some Helpful Tips

 Route Layers 
PencilTips.PNG Use Route layers for all those objects that will appear in every Session based on the Route
PencilTips.PNG When you edit Route layers, always save the Route


 Session Layers 
PencilTips.PNG Use Session layers for all those objects that will ONLY appear in the current Session
PencilTips.PNG When you edit Session layers, always save the Session and avoid using "Default" as the Session name


 When Editing 
PencilTips.PNG Lock the layers that you are not currently editing
PencilTips.PNG Always be aware of which layer is the Active Layer


 When Creating 
PencilTips.PNG Place all track and track objects (Track Marks and Triggers can be exceptions) into the route-layer and always keep it as the top level layer
PencilTips.PNG For TRS19PE and later, you should place all rolling stock into a session layer to be saved with the session and not the route

What Are Layers?

    Top   Next Down Bottom
BlueDot10x10.png Layers are a Surveyor tool that allows you to better manage the objects that are placed in your Trainz World.
BlueDot10x10.png Layers are a Driver tool that allows you to change what the players see as they drive around your Trainz World.


Layers can contain any objects, visible and invisible, that can be placed into a layout in Surveyor Classic using the Object, Track and Train tools or using the Placement Tool in Surveyor 2.0. The layers and their contents can be hidden from view (in both Surveyor and in Driver) or locked against alteration whenever required. Their main use is in the development of a Route and a Session but they can also be used as a way of providing some additional novelty during a Driver session.


NotePad.PNG Effect Layers Notes:

The special ground effects layers, Clutter, TurfFX and more recently Water, are not discussed here. In many ways they are more like Ground Textures but some aspects of their use is similar to the layers covered here. These special ground effects layers are saved as part of a Route but are not associated with any Route Layer.

Almost all of what you will see in a Trainz World will be found in layers, and mostly in the Route Layers and Session Layers.

DotPoint.JPG Route Layers will contain the objects that will appear in ALL the sessions created using the current route
DotPoint.JPG Session Layers will contain the objects that will only appear in the current session
DotPoint.JPG Effect Layers (Trainz Plus and TRS22) will contain the TurfFX, Clutter and Water effects created using the current route


The Layers Tool in Surveyor Classic (S10)

Skip Down   Top Next Up Next Down Bottom
SurveyorToolMenuLayers.JPG












RightArrowRed.JPG
Left Click the Layers Tool (or press  F6 ) to open up its properties.
LayersTools.JPG


NotePad.PNG Notes:

The layers are organised into two groups:-

DotPoint.JPG Route Layers in the top group, and
DotPoint.JPG Session Layers in the lower group
Each group can contain multiple layers - the scroll bars next to the layer names shown on the left indicate that there are more layers in each group than can fit into the display window area.


Layers can be:-
DotPoint.JPG Created
DotPoint.JPG Deleted
DotPoint.JPG Hidden
DotPoint.JPG Locked
DotPoint.JPG Merged
DotPoint.JPG Moved
DotPoint.JPG Renamed

Objects can be:-

DotPoint.JPG assigned to a layer
DotPoint.JPG bound to a second layer
DotPoint.JPG moved between layers
The following sections show how these tasks can be done using Surveyor Classic


Loading a Route and Loading a Session (S10)

Skip Down Skip Up        
BlueDot10x10.png Route Layers are saved with the Route. Session Layers are saved with the Session
BlueDot10x10.png If you edit a Session Layer and later load just the Route then those edits will not appear.


LinkWiki.PNG

More information on creating, loading and saving Routes and Sessions can be found on the Trainz Wiki Page at Route and Session Basics


The layers you see will depend on whether you have loaded a Route by itself (with no "child" Session) or a Session and its "parent" Route.

LayersToolsRoute.JPG LayersToolsSession.JPG The first image on the left gives an example of the layers that can appear if a Route only is loaded into Surveyor. These are the layers that are saved with the Route. Note that a default "session-layer" is present.
NotePad.PNG Notes:

DotPoint.JPG An empty default session-layer is always created in the Session Layers Group when only the Route is loaded into Surveyor
DotPoint.JPG If you load just the Route and edit its session-layer then those edits will not appear the next time you load just the Route because a new empty session-layer is created each time a Route is loaded without a Session

The second image on the left gives an example of the layers that can appear if a Session based on that Route is loaded into Surveyor. It shows Route Layers and Session Layers.

In both cases, the Route Layers are identical because the same Route has been loaded. A Session contains its own layers, the Session Layers, that are loaded and saved with the Session but are not loaded or saved with the Route.

PencilTips.PNG If you load a Session and do not want to edit any of the Route layers then Left Click the Lock Route Layers icon on the Layers Tool
LayersToolButtonsLOCKALL.JPG Left Click the Lock Button



Stop.PNG If you load a ROUTE but not the SESSION then only edit the Route Layers
Stop.PNG If you edit a SESSION or its layers then always save the Session
Stop.PNG When you save a new SESSION always give it a name, do NOT leave it as "Default"

Creating a New Route (S10)

Skip Down Skip Up        
LayersNewRoute.JPG
NotePad.PNG Notes:

DotPoint.JPG When a brand new route is created it will come with two layers, a single route-layer and a single session-layer
DotPoint.JPG Both layers will be empty (the baseboard with its grid is saved with the route but is not in any layer)
PencilTips.PNG A layer can be renamed at anytime by a Double Left Click on its name and entering a new name

The "Active Layer" (S10)

Skip Down Skip Up        
BlueDot10x10.png The Active Layer is the selected (highlighted) layer
BlueDot10x10.png When you load the Route only into Surveyor, the first Route layer will be the Active Layer
BlueDot10x10.png When you load a Session into Surveyor, the first Session layer will be the Active Layer


In the image above, the route-layer is the Active Layer. You can change the Active Layer at any time by a Left Click on the name of another layer.
NotePad.PNG Notes:

The Active Layer is the "working layer" which is:-
DotPoint.JPG where new objects will be added to the layout
DotPoint.JPG the layer that is automatically selected for merging and deleting
 
Stop.PNG Trainz does not identify which is the Active Layer in Surveyor and this often leads to problems such as objects being added to the wrong layer.

See PageLink.PNG Adding Objects To Layers below for more information.


Adding a New Layer (S10)

Skip Down Skip Up        
LayersToolButtonsADD.JPG Left Click the Add Button

An Add layer dialogue window will appear.

LayersAddLayer.JPG
Steps: To name and place the new layer:-
DotPoint1.JPG Enter a name for the new layer
DotPoint2.JPG Select the layer group, Route or Session, where it will be placed
DotPoint3.JPG Left Click on the Tick.PNG icon to accept the change
Left Click on the Cross.PNG icon to reject the change


PencilTips.PNG You can easily rename the layer or move it to the other layer group if you change your mind.

Deleting a Layer (S10)

Skip Down Skip Up        
Stop.PNG WARNING:

Deleting Layers cannot be undone


LayersToolButtonsDELETE.JPG Select the layer to be deleted and Left Click on the Delete Button. If you don't select a layer to delete then Trainz will select the current Active Layer.


Stop.PNG Deleting a layer will delete ALL the objects placed in that layer except objects that are "Bound" to that layer. See PageLink.PNG The Bound Layer section below.
Stop.PNG In TRS19 and later Trainz versions there will be a delay when deleting a layer. The delay will be indicated by a progress bar but can take several minutes on very large routes.

 Resist any urge to Left Click on the  Cancel  button 

This delay will occur every time a layer is deleted.
Stop.PNG Due to a "bug" deleting a layer that contains a ruler will not delete the ruler. It will be hidden from view but it may reappear if another layer with the same name as the deleted layer is created or it will, eventually, reappear in the route-layer.

If the layer being deleted is empty, then the following dialogue window will appear:-

LayerDeleteEmpty.JPG
Options: Choose one of the following:-
Ablue.png Left Click  Yes  to delete the layer, OR
Bblue.png Left Click  No  to cancel the delete operation

If the layer being deleted is NOT empty, then the following dialogue window will appear:-

LayerDeleteNotEmpty.JPG
Options: Choose one of the following:-
Ablue.png Left Click  Merge  to merge this layer and its contents into another layer (see Merging Layers below for more information), OR
Bblue.png Left Click  Delete  to delete the layer and its contents, OR
Cblue.png Left Click  Cancel  to cancel the operation

Merging Layers (S10)

Skip Down Skip Up        
BlueDot10x10.png Merging a layer into another layer will move ALL the objects from the first layer into the second layer. The first layer, which is now empty, will then be deleted
BlueDot10x10.png Once layers have been merged they cannot be separated.


Stop.PNG WARNING:

Merging Layers cannot be undone


LayersToolButtonsMERGE.JPG Select the layer to be merged into another layer and Left Click the  Merge  button. If you don't select a layer to merge then Trainz will select the current Active Layer.


Stop.PNG In TRS19 and later Trainz versions there will be a delay when merging a layer. The delay will be indicated by a progress bar but can take several minutes on very large routes.

 Resist any urge to Left Click on the  Cancel  button 
This delay will occur every time a layer is merged.


The layer merge dialogue window will appear as shown below:-

LayersMergeInto.JPG
Steps: To merge two layers:-
DotPoint1.JPG Select the destination layer for the merge
DotPoint2.JPG Left Click on the Tick.PNG icon to accept the change
Left Click on the Cross.PNG icon to reject the change
The Merge into: list shows all the available layers with no distinction between Route Layers and Session Layers

Locking Layers (S10)

Skip Down Skip Up        
BlueDot10x10.png If you LOCK or UNLOCK a Route Layer while editing a Session then you will have made a change to the Route and will be asked to save both the Route and the Session when you exit Surveyor


PencilTips.PNG It is good practice to LOCK ALL LAYERS that you are not currently editing. This will avoid the all too common problem of accidentally adding objects to the wrong layer.


Locking Individual Layers (S10)

BlueDot10x10.png The objects in a LOCKED layer cannot be moved (around the layout) or deleted but they can be moved to other layers.


To LOCK an individual layer, Left Click on the LayerUnLocked S20.png Open Padlock icon next to its name. The layer being locked does not have to be the current Active Layer.

LayersRouteTreesActive.JPG LayersRouteTreesActiveLocked.JPG
DotPoint.JPG The first image on the left shows two Route Layers, both UNLOCKED with their Padlock icons Open. One layer, "Trees", is highlighted showing that it is the currently active layer
DotPoint.JPG The second image on the left shows the same two layers after the "Trees" layer has been LOCKED
DotPoint.JPG A locked layer can be UNLOCKED by a Left Click on its LayerLocked S20.png Closed Padlock icon.


If you attempt to add a scenery object to a locked layer you will receive the following message:-

LayersRouteTreesActiveLockedError.JPG Left Click on the Tick.PNG icon to accept the change and add the object
Left Click on the Cross.PNG icon to reject the change

Locking ALL Route Layers (S10)

LayersToolButtonsLOCKALL.JPG Left Click on the Lock Button

This will LOCK ALL the layers in the Route Layers Group. The Session Layers Group will not be affected.

The Route Layers Group can be UNLOCKED by a Left Click on the Lock Button again.

Moving a Layer (S10)

Skip Down Skip Up        
BlueDot10x10.png Layers can be moved up or down within the same layer group (e.g. Route or Session) or between the two groups
BlueDot10x10.png Track Objects (signals, switches, etc) should be in the same layer as the Track or in a layer below the Track layer


Stop.PNG

In TRS19 and later Trainz versions there will be a delay when moving a layer. The delay will be indicated by a progress bar but can take several minutes on very large routes
 Resist any urge to Left Click on the  Cancel  button 
This delay will occur every time a layer is moved.


In the example shown below a layer created in the Route Layers Group is being moved into the Session Layers Group.

LayersMove1.JPG LayersMove3.JPG
Steps: To move a layer:-
DotPoint1.JPG Left Click on the layer to be moved
DotPoint2.JPG Left Click and Drag the layer up or down to its new position


NotePad.PNG Notes:

DotPoint.JPG The move can be between layer groups as shown left
Stop.PNG WARNING:
Moving layers between the Session and Route groups will change where those layers are saved - in the Route or in the Session
DotPoint.JPG The move can be to a higher or lower position in the same group. The only situation where layer order within a group makes any difference is when track objects (e.g. signals, switches, track signs, etc) are not in the same layer as the track
RedDot10x10.png track objects must be in the same layer as the track or in a layer below the layer that contains the track. For more information, see the section PageLink.PNG The "route-layer" below
RedDot10x10.png If you attempt to move a layer containing track objects, such as signals, to a position above the layer containing the track, you will get an error message


Hiding Layers (S10)

Skip Down Skip Up        

To hide or show a layer Left Click the Eye Icon next to its name.

LayersHideNone.JPG In the image shown left the two trees are in different Route Layers and all the layers have their LayerEyeOpen S20.png Eye icons open (set to Show)
LayersHideTree.JPG In the image shown left the Trees layer has its LayerEyeClosed S20.png Eye icon closed (set to Hide)

NotePad.PNG Notes:
DotPoint.JPG If you attempt to add an object to a hidden layer you will receive a warning message
DotPoint.JPG Layers that are hidden when saved in Surveyor will also be hidden when loaded in Driver

Adding Objects To Layers (S10)

Skip Down Skip Up        
When an object (such as a scenery item, consist, track or track object) is added to the layout it is automatically placed in the currently Active Layer. Unfortunately, Surveyor Classic (S10) does not indicate which layer is the Active Layer unless you open the Layers Tool to look. This can lead to objects being placed into the wrong layers and while these objects can later be moved to another layer (see the section PageLink.PNG Moving Objects To Other Layers below) it would be better to correctly set the Active Layer first.


PencilTips.PNG It is good practice to LOCK ALL LAYERS that you are not currently editing. This will avoid the all too common problem of accidentally adding objects to the wrong layer.


BlueDot10x10.png You cannot add objects to a layer that is LOCKED

If you attempt to add a scenery object to a locked layer you will receive the following message:-

LayersRouteTreesActiveLockedError.JPG Left Click on the Tick.PNG icon to accept the change and add the object
Left Click on the Cross.PNG icon to reject the change


BlueDot10x10.png When adding track objects (signals, speed signs, etc) to a track, the objects being added must be in the same layer as the track or in a layer below the track layer. For more information, see the section PageLink.PNG The "route-layer" below


NotePad.PNG Notes:

There are many features of Trainz Routes and Sessions that are NOT stored in layers. In some cases while the objects themselves may be placed in layers, their settings or properties are not. These include:-

  • landforms
  • textures
  • legacy water, TurfFX and Clutter prior to Trainz Plus
  • trackside camera settings
  • weather conditions
  • time of day
  • session rules and driver commands
  • signal and junctions settings
  • rolling stock loads
  • industry settings
  • portal settings
  • passenger station settings
  • navigation points
  • interlocking tower settings BugMini.PNG
DotPoint.JPG Landforms, textures, effect layers and legacy water are saved as part of the Route
DotPoint.JPG Environment Settings are saved in both the Route and the Session - see the Trainz Wiki Page WikiLink.PNG Environment Tools for more details
DotPoint.JPG When you enter or edit the name of a route layer scenery object, such as a station name board, that change will be treated as a change to both the Route and the Session. The new or edited name will still be saved as a property of the scenery object in the Route layer but you will be given the option of saving the Session as well as the Route. You can ignore the offer to save the Session if you have not edited any objects in a Session Layer, the Session Layers themselves (e.g. moved, merged, deleted or renamed) or other Session properties (e.g. commodity levels or loads).  If uncertain, always save the Session as well as the Route 
Bug.png A bug has been reported in the Interlocking Towers (and the Enhanced Interlocking Towers) where the path and settings are initially saved in the Route but any later edits and changes are then saved in the Session. The workaround for this is to always load the Session when working with IT and EIT assets.


Deleting Objects From Layers (S10)

Skip Down Skip Up        
BlueDot10x10.png You cannot delete objects from a layer that is LOCKED


PencilTips.PNG
DotPoint.JPG It is good practice to LOCK ALL LAYERS that you are not currently editing. This will avoid the all too common problem of accidentally deleting objects from the wrong layer
DotPoint.JPG An exception to this "good practice" is when managing rulers. Unless you have used a dedicated ruler layer for all rulers it can be difficult to discover which layer contains a particular ruler. If rulers are not added to a dedicated layer then you will need to unlock and unhide all the layers first before you can use the Delete Ruler tool.


Unfortunately Trainz does not give you a warning message when you attempt to delete an object from a locked layer, the object just refuses to be deleted.

PencilTips.PNG If you cannot delete an object then check:-
DotPoint.JPG that the objects layer and bound layer (if it has been set) are unlocked
DotPoint.JPG that you are using the correct delete tool (e.g. such as attempting to delete a tree with the spline, signal or rolling stock delete tool) - it happens!


Moving Objects To Other Layers (S10)

Skip Down Skip Up        
LayersObjectProperties.JPG

LayersObjectPropertiesChangeLayer.JPG

Steps: To move an object to another layer:-
DotPoint1.JPG Left Click the Properties window (? button in the Object Tools) of the object to be moved
DotPoint2.JPG Left Click on the Layer or one of the scroll buttons
DotPoint3.JPG Select the new layer
DotPoint4.JPG Left Click on the Tick.PNG icon to accept the change
Left Click on the Cross.PNG icon to reject the change


NotePad.PNG Notes:

DotPoint.JPG You can move an object into and out of a locked layer
DotPoint.JPG Rulers cannot be moved to a different layer because they do not have a properties window. If it is necessary to move a ruler to another layer, it must be manually created in the new layer (using the Add Ruler tool), then the pre-existing ruler must be deleted (using the Delete Ruler tool)
DotPoint.JPG Multiple scenery objects can be simultaneously moved to another layer by using the Bulk Asset Update/Replacement tool from the Surveyor Tools Menu. The exception to this is spline objects (including track splines) which must be moved segment by segment ☹


The Layers Palette in Surveyor 2.0 (S20)

  Skip Up Top Next Up Next Down Bottom
Surveyor 2.0 is only available in Trainz Plus and TRS22 Platinum


Layers are found in the Layers Palette.
Layers Palette in S20 The Layers Palette will show all the layers in their groups (Effect, Route and Session) plus the Ground Height and Ground Textures which are "special layers". In the image on the left all the layer groups have been minimised (the "arrow" symbol in front of each group name is pointing to the right).
DotPoint.JPG The Route Layers Group, along with the Ground Height, Ground Textures and Effect Layers, are saved and loaded with the Route
DotPoint.JPG The Session Layers Group are saved and loaded with the Session


Layers can be:-
DotPoint.JPG Created
DotPoint.JPG Deleted
DotPoint.JPG Hidden
DotPoint.JPG Locked
DotPoint.JPG Merged
DotPoint.JPG Moved
DotPoint.JPG Renamed

Objects can be:-

DotPoint.JPG assigned to a layer
DotPoint.JPG bound to a second layer
DotPoint.JPG moved between layers
The following sections show how these tasks can be done using Surveyor 2.0
NotePad.PNG Notes:

If the Layers Palette is not shown on the screen, then:-

Windows Menu
Steps: To display palettes:-
DotPoint1.JPG open (Left Click) the SurveyorWindowIcon.png Window Menu from the menu icons at the top of the screen
 
BulletTick.png visible palettes have ticks next to their names
BulletNoTick.png invisible (hidden) palettes have no ticks next to their names
DotPoint2.JPG if the Layers Palette, or any required palette, does not have a tick next to its name then Left Click on the name of the palette or on the empty BulletNoTick.png box next to its name. This will add a BulletTick.png and make the palette visible


Lock the Route Layer Group (S20)

All the layers in the Route Layer Group can be locked against accidental alteration.

The Route Layer Group has a padlock icon next to its name - shown as LayerUnLocked S20.png (unlocked)
DotPoint.JPG Left Click on the unlocked icon to lock ALL the layers in the Route Layer Group
The icon will change to LayerLocked S20.png (locked)
DotPoint.JPG Left Click on the locked icon to unlock all its layers


Open a Layer Group (S20)

To the left of each Layer Group name is a small arrow. Left Click on the arrow to open up the group.

Layers palette with session layers open The image on the left shows that the Session Layers Group is open and its individual layers are now displayed. To close or minimise the group Left Click on the arrow again.
The image shows that the Session Layers Group contains 3 individual layers:-
DotPoint.JPG the top layer is always named session-layer and is always present even in a new route where you have not yet added anything
DotPoint.JPG likewise, the top layer in the Route Layers Group is always named route-layer and is also always present
DotPoint.JPG there are two user created layers named Track Markers and Rail Workers (layer names are chosen by the creator and do not necessarily indicate their contents or purpose)


Add a New Layer (S20)

You cannot create new layer groups but you can add new layers to a existing group.

Each Layer Group has a LayerAdd S20.png icon next to its name. Left Click on the icon to add and name a new layer to that group. If you are adding a new Effect Layer then you will also have to identify the type of effect - TurfFX, Clutter or Water.


Renaming a Layer (S20)

LayerRename S20.png Right Click on a layer name and select  Rename Layer..  from the popup menu.

You will be asked to enter a new name for the layer.


Deleting a Layer (S20)

LayerDelete S20.png Right Click on a layer name and select  Delete Layer  from the popup menu.

You will be given a warning that you are about to delete a layer.

DotPoint.JPG if you confirm the delete order then the layer and all its contents will be deleted
DotPoint.JPG depending on the contents of the layer, the process may take some time. You will be shown a progress bar during the deleting operation
DotPoint.JPG the deleted layer and its contents can be restored (after the delete has completed) using the  Ctrl   Z  keys


Moving a Layer (S20)

Layers can be individually moved up and down within the same layer group or between the Route Layers Group and the Session Layers Group.

NotePad.PNG Notes:

DotPoint.JPG Moving a layer between the Session Layer Group and the Route Layer Group will move the layer and its contents between the Route and the Session and this will affect where the layer and its contents are saved
DotPoint.JPG There is no advantage in moving a layer within the same layer group except when preparing for a layer merge operation (see Merging a Layer below)
Stop.PNG Layers containing Track objects, such as signals, junctions and track signs, cannot be moved to a position that is above the layer containing the track that they are attached to. If the route-layer is used for all the track and track objects and this layer is left as the top layer in the route layer group then this will never be a problem.
DotPoint.JPG layers in the Effect Layers Group cannot be moved
DotPoint.JPG layers from the other groups cannot be moved into the Effect Layers Group
Left Click on a layer name and, while holding the left button down, drag the layer up or down to its new position.
DotPoint.JPG depending on the contents of the layer, the process may take some time. You will be shown a progress bar during the move operation
DotPoint.JPG the move can be reversed (after it has completed) by using the  Ctrl   Z  keys


Merging a Layer (S20)

LayerMerge S20.png Right Click on a layer name and select  Merge Layer Up  from the popup menu.
DotPoint.JPG the selected layer will be merged with the layer immediately above it
DotPoint.JPG you may need to move the layer being merged into the correct position before the merge (see Moving a Layer above)
DotPoint.JPG depending on the contents of the layer, the process may take some time. You will be shown a progress bar during the merge operation
DotPoint.JPG the merged layers and their contents can be restored (after the merge has completed) back into two separate layers by using the  Ctrl   Z  keys
DotPoint.JPG layers in the Effect Layers Group cannot be merged. In place of  Merge Layer Up  the Effect Layers will have an  Edit Layer  command


Hiding Layers (S20)

Each individual layer has an Eye icon that controls the visible state of that layer. Left Click on the icon to toggle its state between visible and hidden. If the Eye is:-

LayerEyeOpen S20.png open then layer is visible in both Surveyor and Driver
LayerEyeClosed S20.png closed then layer is hidden in both Surveyor and Driver


Locking Layers (S20)

Each individual layer has a Padlock icon that controls the state (LayerLocked S20.png Locked or LayerUnLocked S20.png Unlocked) of that layer. Left Click on the icon to toggle its state between Locked and Unlocked.
If the Padlock is:-

LayerUnLocked S20.png open then the layer is Unlocked and can be edited
LayerLocked S20.png closed then the layer is Locked and cannot be edited
NotePad.PNG Notes:

DotPoint.JPG Locking a layer will protect its contents from being individually selected, deleted and physically moved
DotPoint.JPG New assets cannot be added to a locked layer
DotPoint.JPG Locked layers can still be deleted, renamed, moved and merged


Setting the Active Layer (S20)


Active layer selected the Active Layer is the layer where new objects will be automatically added when using the Placement Tool. The active layer is shown in the palette with its name on a blue background. In the image on the left the Rail Workers layer is the current Active Layer.

The name of the current Active Layer is also shown in the Layer Palette Title Bar.

To set a new Active Layer, Double Left Click on a layer name.


Move an Object to a New Layer (S20)


The Info Palette will show the layer assigned to the currently selected object. An object is selected by using the Free Move Tool (the  S  key) or the Fine Adjustment Tool (the  D  key) found in the Tools Palette.


To the left of the layer name is a small arrow object.

Info palette

Layer control

Tools and keymap for S20
DotPoint.JPG Left Click the small arrow next to the layer name. This will open the layer properties for the selected object
DotPoint.JPG Left Click the Layer drop down box to select a new layer for the object
DotPoint.JPG if required, Left Click the Binding drop down box to select a new binding layer for the object
DotPoint.JPG if required, Left Click the  Lock Layer  button to lock the selected layer. If the layer is already locked then this will be shown as an  Unlock Layer  button

Route Layers vs Session Layers

Skip Down   Top Next Up Next Down Bottom

This topic has filled endless threads in the Trainz Forums with arguments raging on both sides.

BlueDot10x10.png In general, there are no "cast iron" rules that dictate what should be placed in the Route Layers Group and what should be placed in the Session Layers Group (for an exception see TRS19 Platinum Edition, Trainz Plus, TRS22 Notes below)
Each Route and Session will be different and different creators have different ways of working. The main question to be asked is how many different Sessions will be created using a particular Route?
NotePad.PNG Notes:

DotPoint.JPG For a Route with only a single Session - everything can safely go into the Route Layers Group
Many creators only ever build a single Session for each of their Routes and do not use Session Layers at all (but they still have to save the session separately from the route)
DotPoint.JPG For a Route with multiple (2 or more) Sessions - certain things will probably need to go into the Session Layers Group for each Session.
Many creators build multiple Sessions for each Route and rely on the Session Layers to create the differences between their Sessions
DotPoint.JPG Many scenery assets actually have their properties stored in the Session, even when the assets themselves are in a Route layer. Editing the properties of these assets is considered to be a change to the Session. Unless you have a particular reason for saving the edited data (such as a change to commodities) you can usually ignore the offer to save the Session. These assets include:-
RedDot10x10.png junction switches - the left/right switch direction is stored in the Session (but the default switch direction is stored in the Route)
RedDot10x10.png industries - the commodities and quantities loaded/unloaded are stored in the Session
RedDot10x10.png industry enabled wagons - the commodities and quantities carried are stored in the Session
RedDot10x10.png consist locations (TRS19 Platinum Edition, Trainz Plus and TRS22) - this is stored in the Session. Unless you need to save their new locations, you can safely ignore the offer to save the Session
RedDot10x10.png named route objects (TRS19 Platinum Edition, Trainz Plus and TRS22) - while the name is stored in the Route, adding or changing the name is treated as a change to the Session. If the name is all that you have changed then you can safely ignore the offer to save the Session


NotePad.PNG TRS19 Platinum Edition, Trainz Plus, TRS22 Notes:

DotPoint.JPG The recommended practice in these versions of Trainz is to place all consists in a session layer and NOT in a route layer. Because these versions have the Unified Driver Surveyor Interface, placing a train in a route layer after switching from Driver to Surveyor can cause problems. For example:-
RedDot10x10.png If active Driver consists (i.e. those under manual or AI control) are in a route layer and you switch from Driver to Surveyor to edit the route and save the route edit, then those consists will be saved in their new positions, not their starting positions for the session
DotPoint.JPG Recent experiments using the Unified Driver Surveyor Interface have indicated that when portals produce trains they will be placed into the same layer as the portal - so if a train that is in a Session layer enters a portal that is in a Route layer and is later returned to the layout, it will be returned in the same Route layer as the portal. This has possibly always been the case with portals but has not been noticed until the arrival of the Unified Driver Surveyor Interface
For more details see the Trainz Wiki page WikiLink.PNGHow to Use the UDS Interface


The Route Layers Group

Skip Down Skip Up        
BlueDot10x10.png The Route Layer Group should be used for everything that will always appear in Driver Mode regardless of which Session is playing.


There is nothing stopping you from placing everything in the "route-layer" of the Route Layers Group and never having to worry about dealing with layers ever again - some creators prefer to work this way. However, layers do provide you with a way of organising your scenery objects to make them more manageable, particularly in more complicated layouts.


Some examples:-
DotPoint.JPG A Special Objects layer or layers that can be used to hold certain scenery objects. For example all the trees or a particular building. This can be very useful when you need to hide those objects to locate or place other objects. Trackside cameras in particular can be very difficult to find when placed in a forest
DotPoint.JPG A Platform Objects layer can be used to hold all platform items such as seats, luggage, luggage trolleys, people, lamp posts, etc. Because these items are placed on top of a platform object they can be very difficult to move or delete without first moving the platform. The layer containing the platform can be locked allowing these objects to be easily moved or deleted
DotPoint.JPG Hiding and Showing Objects in Driver Mode. There is a Session Rule and a Driver Command that can hide and show layers during the running of a Session. For example: a rail worker can be placed in a separate layer and positioned next to a track lever while shunting operations are underway but can be removed from the scene by hiding that layer when shunting has been completed
DotPoint.JPG A Test Layer for experimenting. Not sure if a particular object is right for your layout? Place it in a temporary layer which you can hide and show to see any differences it makes. This is particularly useful if you are deciding between different types of grasses, for example, placed throughout the layout. If the objects prove to be unsuitable then they can all be deleted by deleting the layer. If they are suitable then the layer can be merged with another or left as a new layer
DotPoint.JPG A Ruler Layer if you are using rulers. Although rulers obey layer behavior (lock and hide) just like all other objects and splines, they have no properties window to show their layer or allow you to change that layer. Consider placing all rulers in a dedicated layer to make their management easier.  NOTE:  Due to a bug in TANE/TRS19, deleting a dedicated Ruler Layer will not delete the rulers but will temporarily hide them from view. Rulers will still have to be deleted individually


PencilTips.PNG
DotPoint.JPG It is a good idea to place ALL the consists in the same layer particularly if they are going to be coupled together during the running of a Session
DotPoint.JPG A very useful development tool is the Bound Layer. See PageLink.PNG The Bound Layer section below


The "route-layer"

BlueDot10x10.png To avoid any confusion over which layer is the original "route-layer", this is one layer that should not be renamed or moved from the top position


While all layers are equal, the "route-layer" is special.

Stop.PNG Track objects, such as signals, junctions and track signs, cannot be placed in any layer that is above the layer containing the track that they are attached to. If the route-layer is used for all the track and track objects and this layer is left as the top layer then this will never be a problem.


PencilTips.PNG It is recommended that the following objects should be placed in the route-layer:-
DotPoint.JPG Track and interactive industries with track
DotPoint.JPG Track infrastructure (turntables, bridges, tunnels, etc)
DotPoint.JPG Signals and track signs (speed limits, warnings, distance, etc)
DotPoint.JPG Junctions and switches
..and that the "route-layer" is at the top of the Route Layers Group

The Session Layers Group

Skip Down Skip Up        
BlueDot10x10.png The Session Layers Group should be used for everything that will only be seen in the currently loaded Session.


If you are creating more than one Session based around a particular Route, then you will probably make use of the Session Layers.

NotePad.PNG Notes:

Session Layers can contain:-

DotPoint.JPG Scenery objects that will only appear in one or some of the Sessions.
For example: If you have placed human figures and equipment for a track work crew alongside the track and want them to be seen in a daylight Session but not in a night Session, then place them in one of the Session Layers of the daylight Session only. Likewise, station staff holding lamps would be placed in one of the Session Layers of the night Session only
DotPoint.JPG Consists used in a Session


PencilTips.PNG
DotPoint.JPG It is a good idea to place ALL the consists in the same Session Layer and this is strongly recommended for Trainz Plus and TRS22 which have the UDS interface. It is also important if different consists are going to be coupled together during the running of a Session
DotPoint.JPG When you first save a Session, give it a distinctive and informative name. Avoid the temptation to use Default as the name of your Session as you can easily end up with several Sessions all called Default


The "session-layer"

An empty session-layer will be automatically created when you:-
DotPoint.JPG load a route without also loading a session, or
DotPoint.JPG create a new route
Stop.PNG WARNING:

If you edit or add anything to the session-layer or add new layers to the Session Layers Group and do not save the session then those changes will be lost when you exit


The Bound Layer

Skip Down Skip Up Top Next Up Next Down Bottom
BlueDot10x10.png In Trainz Plus and TRS22 the Bound Layer is often referred to as the Binding Layer


This is a little used and probably little understood layer feature. It allows you to attach an object to two different layers so it can have the properties (locked/unlocked and show/hide) of both layers. The bound/binding layer was introduced as a development tool, its sole use is as a tool in the building of routes and sessions.

BlueDot10x10.png An object will be LOCKED and cannot be deleted or moved if its layer OR its bound/binding layer is locked.
BlueDot10x10.png An object will be HIDDEN if its layer OR its bound/binding layer is hidden.
BlueDot10x10.png Rulers cannot be bound to another layer.


Assigned
Layer
Bound/Binding
Layer
Object
Status
LayerUnLocked S20.png Unlocked LayerUnLocked S20.png or None LayerUnLocked S20.png Unlocked
LayerLocked S20.png LOCKED LayerLocked S20.png or LayerUnLocked S20.png or None LayerLocked S20.png LOCKED
LayerUnLocked S20.png Unlocked LayerLocked S20.png LOCKED LayerLocked S20.png LOCKED
LayerEyeOpen S20.png Visible LayerEyeOpen S20.png or None LayerEyeOpen S20.png Visible
LayerEyeClosed S20.png HIDDEN LayerEyeOpen S20.png or LayerEyeClosed S20.png or None LayerEyeClosed S20.png HIDDEN
LayerEyeOpen S20.png Visible LayerEyeClosed S20.png HIDDEN LayerEyeClosed S20.png HIDDEN
In Summary:-
DotPoint.JPG If the Assigned Layer or the Bound/Binding Layer of an object is Locked then the object will be Locked
DotPoint.JPG If the Assigned Layer or the Bound/Binding Layer of an object is Hidden then the object will be Hidden


Some applications:-
DotPoint.JPG Temporarily locking an object by binding it to a locked layer while allowing other objects in the same unlocked layer to be moved or deleted. A simple but very effective development technique is to create a Route layer called "Locked" and then lock it. If you need to temporarily stop an object from being deleted or moved then it can be bound to the "Locked" layer
DotPoint.JPG Temporarily hiding an object by binding it to a hidden layer (this will require the hidden layer to be made visible so the object can be unbound)


PencilTips.PNG If you are going to be working with multiple objects that will be bound to a locked or hidden layer then a simple strategy is to:-
Steps: To use a bound layer:-
DotPoint1.JPG Create a new empty layer called "Locked" or "Hidden" and lock or hide that layer, according to your needs
DotPoint2.JPG Bind the individual objects to that layer as required
DotPoint3.JPG When editing, testing or whatever you are doing has been completed simply delete the new layer. All objects that have been bound to that layer will have their Bound Layer property reset to none so the hidden objects will reappear and the locked objects will be unlocked


PencilTips.PNG If you need to remove an object from a route but cannot alter the route (e.g. it is payware or under another users kuid) then create a new hidden session layer and change the bound layer of the object to the hidden layer. This will be treated as a change to the session only and Trainz will not ask you to save the route as well as the session.


Setting an Object to the Bound Layer in Surveyor Classic (S10)

Skip Down Skip Up        
LayersBoundLayer.JPG
Steps: To set a Bound Layer:-
DotPoint1.JPG Left Click the Bounding Layer box or one of its scroll buttons
DotPoint2.JPG Select the layer to be used as the Bound Layer for the object (an object cannot be bound to its own layer)
The effects of the binding can be reversed by setting the Bound Layer back to <none>


BlueDot10x10.png When a layer is deleted any objects bound to that layer will have their Bound Layer reset to <none>


Setting an Object to the Bound Layer in Surveyor 2.0 (S20)

Skip Down Skip Up        
Surveyor 2.0 is only available in Trainz Plus and TRS22 Platinum


Set Binding


Steps: To set the bound layer in Surveyor 2.0:-
Select an object, or a group of objects, using either the Free Move Tool or the Fine Adjustment Tool. In the Info Palette of the object (or the last selected object):-
DotPoint1.JPG Open the Layer properties of the object
DotPoint2.JPG Left Click the Bounding box or one of its scroll buttons
DotPoint3.JPG Select the layer to be used as the Bound Layer for the object (an object cannot be bound to its own layer)
The effects of the binding can be reversed by setting the Bound Layer back to <none>


BlueDot10x10.png When a layer is deleted any objects bound to that layer will have their Bound Layer reset to <none>


Layers in Driver Mode

  Skip Up Top Next Up Next Down Bottom

During the running of a Session in Driver Mode visible layers can be hidden and invisible layers revealled according to the events that occur during the Session.

LayersDriveShow.JPG LayersDriveHide.JPG The two Driver Mode scenes shown on the left illustrate this feature.
DotPoint.JPG In the first image on the left, all layers are visible
DotPoint.JPG In the second image on the left, two of the layers (containing the passengers and the trolley loads) have been hidden
DotPoint.JPG The trigger for this change was the arrival of a train at the platform.


This effect could be achieved in two different ways:-
Ablue.png A Driver Command - specific to a particular driver, or
Bblue.png A Session Rule - specific to a particular driver, consist, or any driver/consist


Using a Driver Command

The driver command WikiLink.PNG Layer Control hides and shows named layers.

LayerControlExample.png
The sequence of events in this example will be:-
DotPoint1.JPG The train will drive to the named station
DotPoint2.JPG It will wait for 30 seconds
DotPoint3.JPG The assets held in or bound to the named layer will be hidden from view (or shown)


Using Session Rules


RulesWiki.PNG Rules Used:


Screenshot.PNG Session Editor Screenshot:

LayersDriveHideRules.JPG


Explanation.PNG Description:

In this example:-
The Trackside Check Rule is triggered when a specific train comes to a stop at a trackmark. This then executes the following rules in order:-
DotPoint1.JPG The Show/Hide Layer Rule is used to hide the layer named "People". Four passengers (three standing and one seated) are hidden
DotPoint2.JPG The Show/Hide Layer Rule is used to hide the layer named "CNJCartsFull". The boxes and mail bags on the three platform trolleys are hidden
DotPoint3.JPG The Message Popup Rule is used to place a message on the screen informing the player that the passengers and mail have been loaded


  Top Next Up    


Trainz Wiki

TrainzWiki.png

More Tutorials and Guides to Using Trainz


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


Personal tools