Revision as of 20:22, 23 February 2023

The information in this Wiki Page applies to Surveyor 2.0 (S20) as found in Trainz Plus. The original refernce material for this document can be found at Surveyor 2.0 Overview

1 The Surveyor 2.0 World
2 The Info Palette
3 The Tools Palette
4 The Tool Options Palette
5 The Assets Palette
6 The Layers Palette
7 The Scrapbook Palette
- 7.1 Creating a New Scrapbook
- 7.2 Painting or Pasting a Scrapbook
8 The Preview Palette
9 The Packages Palette
10 Trainz Wiki

This document is still under construction

S20 Palettes.png

The Surveyor 2.0 World

When you start Trainz in Survayor 2.0 the world presented will look something like the following image, but what you actually see can be highly customised to your own preferences.

S20 SurveyorScreen.png

The grey boxes on the left and right of the screen are Palettes, where selections can be made, information displayed and controls set.

Shown in the image above are 5 Palettes:-
	Assets
	Layers
	Info
	Tools
	Tool Options

Not shown in the image above are 3 Palettes because they are currently hidden from view. They are:-

	Scrapbook
	Asset Preview
	Content Packages

Hiding and Showing Palettes

Palettes are hidden and revealed using the Window Menu on the top Surveyor Menu bar.

The 5 visible and 3 hidden Palettes in the screenshot image shown above have had their visibility set by:-

Steps:

open the Window Menu from the menu icons at the top of the screen

	visible palettes have ticks next to their names
	invisible (hidden) palettes have no ticks next to their names

To make a hidden palette visible or to hide a visible palete simply Left click on its name or on the

or

next to its name

Docking and Undocking Palettes

To Undock a palette from its normal position on either side of the screen:-

Steps:

Move the mouse pointer onto the Title Bar of the palette to be undocked. The pointer will take the shape of a 4 headed arrow

		Left Click and Drag the palette to any position on the screen
		Release the mouse button

To reverse the process and dock a palette:-

Steps:
	Move the mouse pointer onto the Title Bar of the free palette to be docked

	Left Click and Drag the palette to the desired position on a docking area. A light grey area will show the palettes docking position

	Release the mouse button and the palette

The palette does not have to be returned to its original position.

Free floating (Undocked) palettes can be docked together to form a docked group that is still free floating

Resizing Palettes

Only palettes that are undocked can be resized.

Steps:
	Move the mouse pointer onto a corner or an edge of the palette

	Left Click and Drag the pointer to expand or reduce the size of the palette

	Release the mouse button when the palette has reached the required size

	Notes:
If a resized palette is reurned to a docking area its dimensions will return to its default (original) values

Closing Palettes

This is the same as hiding a palette. Once a palette has been undocked it can be closed (hidden) by a Left click on its Close

icon. The palette will not be deleted and can be shown again as described above at

Hiding and Showing Palettes

The Info Palette

If the Info Palette is not visible on the screen then refer to

Hiding and Showing Palettes at the top of this document. Some Info Palette functions will also require the Assets Palette and the Tool Options Palette.

This palette can be easily overlooked but it has some very useful features:-
	providing precise data and control over the "focus" - the position of the cursor
	providing precise data and control over the position and orientation of objects (it can be used instead of the Free Move Tool and the Fine Adjustment Tool)
	identifying and setting the "home" layer and binding layer of a selected object
	used for locking and unlocking a selected objects layer

The Info Palette will appear as shown in the image below.

Each of the small arrowhead icons will open the palette to display more information and some controls.

Notes:

All the positional data and controls in the Info Palette are defined in the following ways:-

X	is ALWAYS the North-South compass direction regardless of the direction that an object is facing
Y	is ALWAYS the East-West compass direction regardless of the direction that an object is facing
Z	is ALWAYS the Vertical direction (perpendicular to the compass directions) regardless of how an object has been rolled or tilted

	distances are measured in metres from the North-West corner of the first baseboard.
	(+) positive distances are in the South and East directions
	(-) negative distances are in the North and West directions. New boards added to the North of the first baseboard will have negative X coordinates and new boards added to the West of the first baseboard will have negative Y coordinates.

Focus Info and Controls

The Focus shows the current position and height of the Cursor object. Open up the Focus by Left clicking on its arrowhead icon.

Before changing the cursor position with the Focus controls, set a Bookmark at its current position.

The current cursor position is shown in the X, Y and Z text boxes. These values can be edited to move the cursor to a new position but CARE will be needed.

Notes:

If you enter an X or Y value that is "out in empty space" (beyond the edge of a boundary baseboard) then the cursor will be refocussed at a point on the baseboard edge that is the closest to the entered co-ordinates.

On the right of each box is a pair of Up/Down controls. Left Click and Drag up or down on these to adjust the cursor position in smaller increments down to centimetres

Next to the Z co-ordinate is a small white down arrowhead. Left click on the arrow to open its menu.

There is only one item in the sub-menu. Use Height for Brush
Left click on the option to copy the current cursor height (Z) value from the Info Palette to the Tool Options Palette Height entry.

Asset Name Menu

You must have an object (or objects) selected for a name to be shown and the menu to be available.

If the selected objects are different then a count of the additional objects will be added. The (+2) shown in the object name in the image on the left indicates that "2" additional different objects are in the group of selected objects. The name and position data shown will be for the last selected object.

Next to the objects name is a small white Down Arrowhead. Left click on the arrowhead to open its menu.

The menu options are:-

Copy	NOT WORKING (a known bug) - this option copies the objects details as text for pasting into a text editor
Show Asset Details	opens a new window showing the image and description of the selected object
List Assets in New Window	opens up Content Manager and lists all the selected objects
Add to Picklist	adds selected objects to a Picklist
Remove from Picklist	removes selected objects from a Picklist (objects must already be in a Picklist)
Select in Assets Palette	highlights the selected object in the Assets Palette

Position Info and Controls

You must have an object (or objects) selected for the position data to be shown and edited. Open up the position data by Left clicking on its Pos: arrowhead icon.

The position of the selected object (or the last object if more than one is selected) is shown in the X, Y and Z text boxes. These values can be edited to move the object or objects to a new position but CARE will be needed.

Notes:

If you enter an X or Y value that is "out in empty space" (beyond the edge of a boundary baseboard) then the objects will be moved to that position and may vanish from view. The Undo command can be used to reverse the move or the Marquee Tool can be used to add a baseboard under the "floating" objects.

On the right of each box is a pair of Up/Down controls. Left Click and Drag up or down on these to adjust the position in smaller increments down to centimetres

Next to the Z co-ordinate is a small white down arrowhead. Left click on the arrow to open its menu.

There is only one item in the sub-menu. Use Height for Brush
Left click on the option to copy the height (Z) value for the selected object from the Info Palette to the Tool Options Palette Height entry.

Rotation Info and Controls

You must have an object (or objects) selected for the rotation data to be shown and edited. Open up the rotation data by Left clicking on its Rot: arrowhead icon.

The rotational orientation of the selected object (or the last object if more than one is selected) is shown in the R, P and Y text boxes. These values can be edited to rotate the object or objects in 3D space BUT not all objects can be rotated in certain directions.

On the right of each box is a pair of Up/Down controls. Left Click and Drag up or down on these to adjust the rotation angle in increments of 1°.

Notes:

The rotation data and controls are defined in the following ways:-

R	ALWAYS rotates in the vertical plane around the North-South compass direction regardless of the object or objects orientation
P	ALWAYS rotates in the vertical plane around the East-West compass direction regardless of the object or objects orientation
Y	ALWAYS rotates in the horizontal plane around the Vertical direction (perpendicular to the compass directions) regardless of how the object or objects have been rolled or tilted

	all angles are measured in degrees
	(+) positive angles are clockwise when facing the primary direction ( North or East ) and around the Vertical axis
	(-) negative angles are anti-clockwise when facing the primary direction ( North or East ) and around the Vertical axis
	angles greater than ±360° can be entered but will give the same result as the corresponding angle less than 360°. For example: 450° is exactly the same angle as 90° (450-360=90)
	clockwise and anti-clockwise angles are complementary. For example: entering -270° (anti-clockwise) will give the same angle as entering 90° (clockwise)

Layer Info and Controls

You must have an object (or objects) selected for the layer data to be shown and edited. Open up the layer data by Left clicking on its Layer: arrowhead icon.

	Notes:
	the Info Palette is best used to show and edit the layer and binding layer assignments of individual selected objects
	operations such as creating, deleting, merging, renaming, moving and hiding layers are performed using the Assets Palette
	layers can be Locked and Unlocked using the Info Palette or the Assets Palette but the Assets Palette is often the better choice for this

This will show the:-

	current layer assigned to the selected object
	its assigned Binding Layer (if any)
	the Locked/Unlocked status of the assigned layer
	Layer is currently Unlocked. Click this button to Lock the layer
	Layer is currently Locked. Click this button to Unlock the layer
	Using this button will also change the Locked/Unlocked padlock icon shown next to the layer name in the Assets Palette

If multiple objects from different layers have been selected then no layer name will be shown in the Layer and Binding boxes. Instead they will be left "blank" as shown in the image on the left.

Both boxes can still be opened to assign layers to objects.

Assigning Objects to a Different Layer

A selected object or group of selected objects can be assigned to a different layer. If multiple objects have been selected then they do not have to all be in the same layer.

Notes:

Before changing any objects to another layer, make sure that the source layer (or source layers for multiple objects) and the destination layer are unlocked.

	unlocked layers are shown in the Assets Palette with an open padlock icon
	locked layers are shown in the Assets Palette with a closed padlock icon. Left click the icon to unlock the layer

This operation will TOTALLY FAIL if the destination layer is locked and it will FAIL for any object in a source layer that is locked

Steps: To change the assigned layer of an object or group of objects:-
	Left click on the Layer drop down box. The layer containing the object (for a single selected object only) will be shown with a in front of its name
	Select the destination layer name from the drop down list
The layer reassignment will start the instant the destination layer is selected
	If you see a Debugging Window on the screen as the task is processed, it will inform you when the task has been completed. You can then close the window

Once a target layer has been selected then the Select Layer button, which sets the Active Layer, may become active.

The Active Layer is the layer used by the Placement Tool when objects are added to a route (or session). This button gives you the opportunity to set the Active Layer to the same layer that you just used to assign to an object. Its use is optional.

You can also set the Active Layer by selecting its name from the list in the Layers Palette.

If the Select Layer button is greyed out
	then the selected object is now assigned to the current Active Layer so there is no need to use this option
If it is NOT greyed out
	then the selected object is now assigned to a layer that is not the current Active Layer. You have the option to Left click on this button to switch the Active Layer to the same layer as the object

Assigning Objects to a Binding Layer

The Binding Layer, or Bound Layer as it is also called, is a tool used in the development of a route or session. It allows you to temporarily assign an object to a second layer while it is still in its original layer. The object will then take on the properties (Locked/Unlocked, Hidden/Visible) of both layers.

So if the original layer or the binding layer of an object is:-
	LOCKED then the object will be LOCKED
	HIDDEN then the object will be HIDDEN

Some examples of using the Binding Layer:- Example 1:
The problem:	You need to stop an object from being selected so that you can you move other objects on or around it
The solution:	The easiest solution is to use the Layers Palette to create a new empty layer and lock it. Set the Binding Layer of the object to the new locked layer. The object will then be locked so it cannot be selected or moved even though its original layer is unlocked. When the edit has been completed delete the empty locked layer you just created to unlock all its bound objects and remove all their bindings
Example 2:
The problem:	A group of objects (e.g trees) are blocking access to another object.
The solution:	The easiest solution is to use the Layers Palette to create a new empty layer and hide it. Set the Binding Layer of the blocking objects to the new hidden layer. The blocking objects will no longer be visible and cannot be selected even though their original layer is still visible. When the edit has been completed delete the empty hidden layer you just created to make all its bound objects visible and remove all their bindings

Steps: To change the assigned binding layer of an object or group of objects:-
	Left click on the Binding drop down box. If the object is already bound to a layer (for a single selected object only) the binding layer will be shown with a in front of its name
	Select the Binding layer name from the drop down list
The layer reassignment will start the instant the layer is selected
	If you see a Debugging Window on the screen as the task is processed, it will inform you when the task has been completed. You can then close the window

As an example, the image below shows what you will see for a single object that has had:-

	its assigned layer changed (in the example from "route-layer" to "Station Buildings")
	its binding layer set (in the example to "Multi Industries")
	the newly assigned layer is not locked so you have the option to lock it
	the newly assigned layer is not the Active Layer so you have the option to make it the Active Layer

More information on creating, editing and using Layers can be found on the Trainz Wiki at:-

How to Use Layers

The Tools Palette

If the Tools Palette is not visible on the screen then refer to

Hiding and Showing Palettes at the top of this document

The Tools Palette is at the core of the new interface and takes the place of all the Tool Flyouts that have been the standard for Trainz Surveyor for many years. Some of the tools are new while others have been given a makeover and new abilities. The tools manipulate the Surveyor World you see in many different ways.


	The Context Tool is attached as an icon to a selected or newly placed object. The icon and its Context menu will vary according to the type of object.

For a detailed description of all the tools in the Tools Palette see the Trainz Wiki page How to Use the Surveyor 2.0 Tools

Various brush tools make use of the Tool Options Palette, the Assets Palette, the Info Palette, the Layers Palette and the Scrapbook Palette. If a palette required by one of the brush tools is not visible on the screen then refer to

Hiding and Showing Palettes at the top of this document.

The Brush Tool

Keyboard Shortcut: W

The Brush Tool "paints" the ground height, ground textures, effect layers and scrapbook scenes in a route

The Brush Tool has two drop down menu lists.

The first drop down menu will set the "Brush Target" which is the type of brush.
The Targets are:-

	Ground Height
	Ground Texture
	Scrapbook Data
	*<List of Effect Layers>*
	Edit Effect Layers

If you have any Effect Layers then they will appear as Targets in this drop down list. Select an Effect Layer to use the brush to paint with that layer.

The Brush Targets Ground Height , Scrapbook Data and Effect Layers have a second drop down menu that controls the Brush Action.

For a more detailed information on using the Brush Tool see the Trainz Wiki page

How to Use the Surveyor 2.0 Tools

The Placement Tool

Keyboard Shortcut: E

The Placement Tool adds objects to a route

For detailed information on using the Placement Tool see the Trainz Wiki page

How to Use the Surveyor 2.0 Tools

The Eyedropper Tool

Keyboard Shortcut: R

The Eyedropper Tool identifies and selects objects in a route

An Eyedropper is inside all the tools so you can quickly identify any object without having to switch to the Eyedropper Tool and back again.
Just hold down the Alt key as you move your selected tool onto an object to reveal its name. Left click on the object while holding down the key to select it in the Assets Palette list.

For detailed information on using the Eyedropper Tool see the Trainz Wiki page

How to Use the Surveyor 2.0 Tools

The Free Move Tool

Keyboard Shortcut: S

The Free Move Tool moves objects around a route

For detailed information on using the Free Move Tool see the Trainz Wiki page

How to Use the Surveyor 2.0 Tools

The Fine Adjustment Tool

Keyboard Shortcut: D

The Fine Adjustment Tool makes 3D adjustments (XYZ position and rotations) to objects in a route

For detailed information on using the Fine Adjustment Tool see the Trainz Wiki page

How to Use the Surveyor 2.0 Tools

The Marquee Tool

Keyboard Shortcut: F

The Marquee Tool selects the content in areas of a route, creates and deletes baseboards and sets their properties. It can also used in creating Scrapbooks

For detailed information on using the Marquee Tool see the Trainz Wiki page

How to Use the Surveyor 2.0 Tools

The Tool Options Palette

This palette is used by various tools to set controls and parameters. For a detailed description of all the options presented by the Tools Palette for the different tools, see the Trainz Wiki page

How to Use the Surveyor 2.0 Tools

The Assets Palette

This palette is used by various tools and other palettes to select and identify assets and objects. It includes a filter function to narrow down the search and selection process.

The Layers Palette

This palette is used to manage layers, both object (route and session) and effect (TurfFX, clutter and water) layers. It can create, rename, delete, move, hide/show and lock/unlock layers and set the Active Layer.

The Layers Palette will show all the layers in their groups (Effect, Route and Session) plus the Ground Height and Ground Textures special "layers". In the image on the left all the layer groups have been minimised (the "arrow" symbol to the left of each group name is pointing to the right).

	The Route Layers Group, along with the Ground Height, Ground Textures and Effect Layers, are saved and loaded with the Route
	The Session Layers Group are saved and loaded with the Session

Lock the Route Layer Group

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 (unlocked).
	Left click on the unlocked (open padlock) icon to lock ALL the layers in the Route Layer Group
	The icon will change to (locked)
	Left click on the locked (closed padlock) icon to unlock all its layers.
	The icon will change to (unlocked)

Open a Layer Group

To the left of each Layer Group name is a small arrowhead pointing to the right. Left click on the arrowhead to open up the group.

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 arrowhead again.

The image shows that the Session Layers Group contains 3 individual layers:-

	the top layer in the Session Layers Group is always named session-layer and is always present even in a new route where you have not yet added anything. It is possible to rename this layer and move it to a new position but those actions are NOT recommended for the session-layer.
	likewise, the top layer in the Route Layers Group is always named route-layer and is also always present
	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

You cannot create new layer groups but you can add new layers to a existing group.
Each Layer Group has a 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

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

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.

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

Moving a Layer

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

	Notes:
	moving a layer between the Session Layers and the Route Layers 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
	there is no advantage in moving a layer within the same layer group except if you are preparing for a layer merge operation (see Merging a Layer below)
	layers in the Effect Layers cannot be moved
	layers from the other groups cannot be moved into the Effect Layers
	the Ground Height and Texture layers are actually special single layers and cannot be moved or have other layers added

Steps: To move a layer:-
	Left Click and Drag the layer name up or down to its new position.
	release the layer in its new position.
	depending on the contents of the layer and the size of the route, the process may take some time. You will be shown a progress bar in a message window during the move operation
	at the conclusion, hopefully, you will be shown a message "Operation complete"
	close the progress message window
The move can be reversed (after it has completed) by using the Ctrl Z keys

Notes: Moving Layers - What Could Possibly Go Wrong?

Well, a great deal it seems. You may get a different message during the layer move operation.
LayersMoveFailure S20.png

The most common error when moving layers is, as the message above states, an invalid hierarchy. This occurs when a layer is moved to an incorrect level for the type of objects it contains and it is Track Splines and Track Objects (e.g. signals, switches, speed signs, etc) that usually cause this problem.

The situation that created the error messages shown above is shown in the image below left:-

all the track splines, the parent track identified in the message, are in the route-layer

track objects, in this case signals but any track objects could have been used, have been placed in the Signals layer. This layer, according to the order of the layers from the top to the bottom, is one layer below the route-layer that contains the track where the signals are attached.

the Signals layer is being moved to a position shown by the dashed red line. The new position, again according to the order of the layers from the top to the bottom, is one layer above the route-layer.

The error message shown is confusing.

Trackside objects cannot be in a layer below the layer their track is in.
Best Advice: Ignore the word below and replace it with the word above so the message reads
Trackside objects cannot be in a layer above the layer their track is in.

Solutions to This Problem:

	use the route-layer to hold the track splines and never move any layer containing track objects, or any layer at all, above this layer OR
	use the route-layer to hold the track splines and ALL track objects
Track objects such as Trackmarks and Triggers that are needed for a session but not the route can still be placed in a Session Group Layer as long as it remains in the Session Group

Merging a Layer

Right click on a layer name and select Merge Layer Up from the popup menu.

the selected layer will be merged with the layer immediately above it
you may need to move the layer being merged into the correct position before the merge (see Moving a Layer above)
depending on the contents of the layer, the process may take some time. You will be shown a progress bar during the merge operation
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
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

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

open then layer is visible in both Surveyor and Driver

closed then layer is hidden in both Surveyor and Driver

Locking Layers

Each individual layer has a Padlock icon that controls the state (locked or unlocked) of that layer. Left click on the icon to toggle its state between locked and unlocked.
If the Padlock is:-

open then the layer is unlocked and can be edited

closed then the layer is locked and cannot be edited

Notes:

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

Setting the Active Layer

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

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 arrowhead.

Info palette

Layer control

link=	Left click the small arrowhead next to the layer name. This will open the layer properties for the selected object
link=	Left click the Layer drop down box to select a new layer for the object
link=	if required, click the Binding drop down box to select a new binding layer for the object
link=	if required, 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

The Scrapbook Palette

If the Scrapbook Palette is not visible on the screen then refer to

Hiding and Showing Palettes at the top of this document.

This palette manages the Scrapbooks that you have created yourself, installed from other sources (such as the DLS) or came installed with Trainz. It also controls which parts of a scrapbook are pasted or painted into a route.

	Notes:
Scrapbooks, when created, will contain:-
	Ground Heights
	Ground Textures
	Effect Layers - if present
	Selected Objects - scenery items, splines, track, signals, etc
But NOT Rolling Stock (Trains)
Ground heights, textures and effect layers are always included in a scrapbook but you can control which visible objects are added by manually selecting them or using the filter controls in the Assets Palette

	Notes:
Scrapbooks, when painted or pasted, can contain any combinations of:-
	Ground Heights
	Ground Textures
	Effect Layers
	Scenery Objects (Meshes) - individual buildings, trees, signals, etc
	Scenery Splines - roads, track, fences, etc
You have options that will control which of these data categories are transferred and how they are transferred from the scrapbook into a route.

	Left click on the pin icon to Lock (blue pin) and Unlock (white pin) the scrapbook. Locked scrapbooks are permanent (but can still be deleted). Unlocked scrapbooks will "expire" (self delete) after 5 days
	Left click on the delete icon to delete the current scrapbook - most scrapbooks can be deleted (see Notes: Deleting Built-in Scrapbooks below for the exceptions to this)
	Identifies the currently displayed scrapbook (the first number) and the total number of stored scrapbooks (the second number)
	Left click on the < or > to move forwards or backwards through the stored scrapbooks to select the scrapbook that will be added to the route
	The scrapbook name can be edited. Simply Left click inside the name box to edit or replace the current name. Left click on the image to make the name change permanent and pin (lock) the scrapbook

	Notes: Deleting Built-in Scrapbooks
Some scrapbooks are installed with Trainz and cannot be deleted. These scrapbooks have the label Prefab at the front of their names (you may have to scroll to the front of the name to see it). While they cannot be deleted they can be "disabled" so that they won't appear as an installed scrapbook. Unlocking them will not cause them to "expire" - after 5 days they will just become locked again.
Steps:
	Open Content Manager and locate the "permanent" scrapbook or scrapbooks. Search Tips: Name: starts with "Prefab"; Status: is Built-in; Type: is Misc
	Highlight (select) the Scrapbook assets
	Open the Content menu and select Disable
You can reverse this and Enable any or all of these scrapbooks later if you need them.

Creating a New Scrapbook

A new scrapbook can be created by:-

Selecting one or more assets and pressing Ctrl C OR

Drawing a Marquee Selection Area around one or more assets and either:-

	press Ctrl C OR
	open the Trainz Edit Menu and select Cut or Copy

You don't have to use the Marquee Tool to create a new Scrapbook. You can use the Free Move Tool or the Fine Adjustment Tool to select any number of objects and then press Ctrl C . The selected objects, along with the ground height, ground textures, and any effect layers, will be copied into a new Scrapbook

When a new Scrapbook is created by a Cut or Copy , it will appear in the Scrapbook palette with some basic details.

The newly created scrapbook will be given:-

a name consisting of the date and time of its creation

a thumbnail

The thumbnail image will be taken using the current camera POV (point of view). To get a better image adjust the camera position and view to give the best possible shot of the Scrapbook objects before giving the Cut or Copy command

a scrapbook number (it will be inserted as №1 scrapbook)

an expiry date which will be set 5 days after its creation - this will countdown each day until 0 when the new scrapbook will be deleted

Notes:

Scrapbooks use very little memory so there is no real limit to how many you can store in the palette but finding the one you want will be more difficult as the list grows longer

Most scrapbooks, old and new, can be deleted at any time by clicking the Delete

icon. See Notes: Deleting Built-in Scrapbooks in the section above for the exceptions

Deleting a Scrapbook after it has been pasted does not delete the objects that it pasted into the route

There are two changes that can be made to the new scrapbook:-

	Give it a name - Left click inside the Name Text Box and type a new name
	Make it permanent - Left click the white Pin icon (). The scrapbook will no longer expire but it can still be deleted at any time
Pinned scrapbooks are always shown with a blue pin icon and the words "pinned, no expiry" displayed next to their scrapbook №

The Pinning of any scrapbook can be reversed so that it will then expire in 5 days time. Simply Left click the blue pin icon.

Once a scrapbook has been Pinned it becomes an asset and will appear in Content Manager

ScrapbookEntryCM S20.png

The scrapbook can be uploaded to the DLS and saved as a CDP file.

You can archive your scrapbooks as CDP files to keep the number of installed scrapbooks to a minimum. If an archived scrapbook is needed then you can use the Import Content Files option in Content Manager to add it to the Scrapbook Palette. It can be deleted from the palette later, when no longer needed.

Painting or Pasting a Scrapbook

Existing Scrapbooks can be painted into a route using the Brush Tool (see the Trainz Wiki page How to Use the Surveyor 2.0 Tools) or Pasted into a route.

The current Scrapbook can be Pasted into a route at the cursor (the Compass Rose) position by:-
	pressing Ctrl V , OR
	selecting Paste from the Context Menu of a selected object
In both cases the scrapbook contents will be pasted using the original scrapbooks size. It will be pasted inside a Marquee Selection Area that can be moved and resized. The objects that are pasted and how they are pasted is controlled by the current Scrapbook Palette filter settings

Left click on the arrowhead next to the Filters: label below the scrapbook image to open the scrapbook filter controls. These filters will control which elements in the scrapbook will be added to the route and how thay will be added.

For example: To paint a scrapbook asset onto a route with certain conditions set:-
Ground Height:	None	ground height data will not be pasted and the ground heights already in the target area will be used
Ground Texture:	Overwrite	textures present in the scrapbook will replace those already in the target area
Meshes:	Add	scenery objects in the scrapbook will be added to those already in the target area
Splines:	Add	scenery splines in the scrapbook will be added to those already in the target area
Effect Layers:	None	effect layers in the scrapbook will not be pasted and any already in the target area will be used

Scrapbook Painting/Pasting Options
What Data to Transfer
	Ground Height	terrain height(s) used in the scrapbook
	Texture	textures used in the scrapbook
	Meshes	scenery objects (e.g. trees, buildings) used in the scrapbook
	Splines	spline objects used in the scrapbook
	Effect Layers	effect layers (TurfFX, Clutter) used in the scrapbook
How to Transfer the Data
	None	do not paste this feature
	Add	add this feature to those already present
	Overwrite	use this feature to replace those already present
For the Ground Height:-
	Absolute	use the ground heights in the scrapbook to replace the existing ground heights
	Relative	modify the existing ground heights according to those used in the scrapbook (to ignore the scrapbook ground heights completely select the option None)

The Preview Palette

This palette gives a rotating 3D view of a selected asset

The Packages Palette

This palette

Trainz Wiki

More Tutorials and Guides to Using Trainz

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

@@ Line 1,384: / Line 1,384: @@
 =='''Moving a Layer'''==
-Layers can be individually moved up and down within the same layer group or between the '''Route Layers Group''' and the '''Session Layers Group'''. <br>
+Layers can be individually moved up and down within the same layer group or between the '''Route Layers''' and the '''Session Layers'''. <br>
 <table bgcolor=#000000 width=900 cellpadding=2>
@@ Line 1,397: / Line 1,397: @@
 </tr>
 <tr valign="top">
-<td>[[image:DotPoint.JPG|link=]]</td>
+<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
-<td>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</td>
+<td>moving a layer between the '''Session Layers''' and the '''Route Layers'''  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</td>
 </tr>
 <tr valign="top">
-<td>[[image:DotPoint.JPG|link=]]</td>
+<td>[[image:DotPoint.JPG|10px|link=]]</td>
-<td>There is no advantage in moving a layer '''within''' the same layer group except if you are preparing for a layer merge operation (see '''Merging a Layer''' below)</td>
+<td>there is no advantage in moving a layer '''within''' the same layer group except if you are preparing for a layer merge operation (see '''Merging a Layer''' below)</td>
 </tr>
 <tr valign="top">
-<td>[[image:DotPoint.JPG|link=]]</td>
+<td>[[image:DotPoint.JPG|10px|link=]]</td>
-<td>layers in the '''Effect Layers Group''' cannot be moved</td>
+<td>layers in the '''Effect Layers''' cannot be moved</td>
 </tr>
 <tr valign="top">
-<td>[[image:DotPoint.JPG|link=]]</td>
+<td>[[image:DotPoint.JPG|10px|link=]]</td>
-<td>layers from the other groups cannot be moved into the '''Effect Layers Group'''</td>
+<td>layers from the other groups cannot be moved into the '''Effect Layers'''</td>
+</tr>
+<tr valign="top">
+<td>[[image:DotPoint.JPG|10px|link=]]</td>
+<td>the '''Ground Height''' and '''Texture''' layers are actually special single layers and cannot be moved or have other layers added</td>
 </tr>
 </table>
@@ Line 1,427: / Line 1,431: @@
 <table width=732 bgcolor=#ffffff cellpadding=2>
 <tr valign="top">
-<td colspan=2><span style="font-weight: 700; font-height: 15px;">Steps:</span> To move a layer:-</td>
+<td colspan=2><span style="font-weight: 700; font-size: 15px;">Steps:</span> To move a layer:-</td>
 </tr>
 <tr valign="top">
@@ Line 1,462: / Line 1,466: @@
 </table>
 <br>
-<table bgcolor=#000000 width=XXX cellpadding=2>
+<table bgcolor=#000000 width=900 cellpadding=2>
 <tr valign="top">
 <td>
-<table bgcolor=#ffffb0 width=XXX-4 cellpadding=2>
+<table bgcolor=#ffffb0 width=896 cellpadding=2>
 <tr valign="top">
 <td>
@@ Line 1,471: / Line 1,475: @@
 <tr valign="top">
 <td width=25>[[image:NotePad.PNG|link=]]</td>
-<td><span style="font-size: 17px; font-weight: 700;">Notes: What Could Possibly Go Wrong?'''</span><br>
+<td><span style="font-size: 17px; font-weight: 700;">Notes: Moving Layers - What Could Possibly Go Wrong?'''</span><br>
 ----
 </td>
 </tr>
 </table>
-<table>
+<table width=896>
 <tr valign="top">
-<td>You may get a different message during the layer move operation.<br>
+<td>Well, a great deal it seems. You may get a different message during the layer move operation.<br>
 [[image:LayersMoveFailure_S20.png|link=]]</td>
+</tr>
+<tr valign="top">
+<td>The most common error when moving layers is, as the message above states, an '''invalid hierarchy'''. This occurs when a layer is moved to an incorrect level for the type of objects it contains and it is '''Track Splines''' and '''Track Objects''' (e.g. signals, switches, speed signs, etc) that usually cause this problem.</td>
+</tr>
+<tr valign="top">
+<td>The situation that created the error messages shown above is shown in the image below left:-
+<table>
+<tr valign="top">
+<td width=260>[[image:LayersMoveFail_S20.png|link=]]</td>
+<td>
+<table>
+<tr valign="top">
+<td width=10>[[image:DotPoint.JPG|10px|link=]]</td>
+<td>all the track splines, the <span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;parent track&#160;</span> identified in the message, are in the '''route-layer'''</td>
+</tr>
+<tr valign="top">
+<td>[[image:DotPoint.JPG|10px|link=]]</td>
+<td>track objects, in this case signals but any track objects could have been used, have been placed in the '''Signals''' layer. This layer, according to the order of the layers from the top to the bottom, is one layer '''below''' the '''route-layer''' that contains the track where the signals are attached.</td>
+</tr>
+<tr valign="top">
+<td>[[image:DotPoint.JPG|10px|link=]]</td>
+<td>the '''Signals''' layer is being moved to a position shown by the dashed red line. The new position, again according to the order of the layers from the top to the bottom, is one layer '''above''' the '''route-layer'''.</td>
+</tr>
+<tr valign="top">
+<td colspan=2>
+<table bgcolor=#ffffe0 cellpadding=2>
+<tr valign="top">
+<td>[[image:PencilTips.PNG|link=]]</td>
+<td>The error message shown is confusing.<br>
+<span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Trackside objects cannot be in a layer below the layer their track is in.&#160;</span><br>
+'''Best Advice:''' Ignore the word <span style="font-weight: 700; font-size: 15px;">below</span> and replace it with the word <span style="font-weight: 700; font-size: 15px;">above</span> so the message reads<br>
+<span style="font-weight: 700; font-size: 15px; color: white; background-color: black;">&#160;Trackside objects cannot be in a layer <span style="color: yellow;">above</span> the layer their track is in.&#160;</span><br>
+</td>
 </tr>
 </table>
@@ Line 1,488: / Line 1,525: @@
 </tr>
 </table>
+<span style="font-weight: 700; font-size: 15px;">Solutions to This Problem:</span>
+<table>
+<tr valign="top">
+<td>[[image:Ablue.png|link=]]</td>
+<td>use the '''route-layer''' to hold the track splines and never move any layer containing track objects, or any layer at all, above this layer <span style="font-weight: 700; font-size: 15px;">OR</span></td>
+</tr>
+<tr valign="top">
+<td>[[image:Bblue.png|link=]]</td>
+<td>use the '''route-layer''' to hold the track splines and '''ALL''' track objects</td>
+</tr>
+<tr>
+<td colspan=2>Track objects such as '''Trackmarks''' and '''Triggers''' that are needed for a session but not the route can still be placed in a '''Session Group Layer''' as long as it remains in the '''Session Group'''</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<br>
 =='''Merging a Layer'''==

How to Use S20 Palettes

Revision as of 20:22, 23 February 2023

Contents

The Surveyor 2.0 World

Hiding and Showing Palettes

Docking and Undocking Palettes

Resizing Palettes

Closing Palettes

The Info Palette

Focus Info and Controls

Asset Name Menu

Position Info and Controls

Rotation Info and Controls

Layer Info and Controls

Assigning Objects to a Different Layer

Assigning Objects to a Binding Layer

The Tools Palette

The Brush Tool

The Placement Tool

The Eyedropper Tool

The Free Move Tool

The Fine Adjustment Tool

The Marquee Tool

The Tool Options Palette

The Assets Palette

The Layers Palette

Lock the Route Layer Group

Open a Layer Group

Add a New Layer

Renaming a Layer

Deleting a Layer

Moving a Layer

Merging a Layer

Hiding Layers

Locking Layers

Setting the Active Layer

Move an Object to a New Layer

The Scrapbook Palette

Creating a New Scrapbook

Painting or Pasting a Scrapbook

The Preview Palette

The Packages Palette

Trainz Wiki

Views

Personal tools

Navigation

Search

Toolbox