How to Use Bulk Asset Update/Replace Tool

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
m (What is the Bulk Asset Update/Replace Tool?)
Line 27: Line 27:
 
<tr valign="top">
 
<tr valign="top">
 
<td>[[file:DotPoint.JPG]]</td>
 
<td>[[file:DotPoint.JPG]]</td>
<td>'''When objects are being replaced they must be replaced by objects of the same general type''' - e.g. both must be spline objects, or both must be non-spline objects, or both must be textures, etc</td>
+
<td>'''When objects are being replaced they must be replaced by objects of the same general type''' - both must be spline objects, or both must be non-spline objects, or both must be textures, or both must be track objects, etc</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
 
----
 
----
 +
 +
If you attempt to replace ''one type'' of object with a ''different type'' you will receive an error message.
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:BulkAssetReplaceError.JPG]]</td>
 +
<td>This will indicate that at least one of the objects in the two lists is not of the same type as the other objects.</td>
 +
</tr>
 +
</table>
  
 
==Things it Will Not Do==
 
==Things it Will Not Do==
Line 38: Line 46:
 
*tunnel spline objects
 
*tunnel spline objects
  
It cannot be used to replace a non-spline scenery object with a spline scenery object, and visa-versa. Likewise, signal objects cannot be replaced with switch or lever objects.
+
='''Selecting the Assets'''=
 
+
='''Using the Asset Replacement Options'''=
+
  
 
<table>
 
<table>
Line 86: Line 92:
 
</table>
 
</table>
  
 +
='''Setting the Scope'''=
 +
 +
='''Setting the Options - for Non Texture Objects'''=
 +
 +
==Option 1: Random Rotation==
 +
 +
The first option controls the rotation or orientation of the replacement objects.
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:BulkAssetRandomRotate.JPG]]</td>
 +
<td>
 +
*Tick the check box to randomly rotate each replacement object as it is placed in the layout
 +
*Untick the check box to keep the original orientation of each object as it is replaced
 +
</td>
 +
</tr>
 +
</table>
 +
 +
==Option 2: Move to Another Layer==
 +
 +
The second option allows the replacement objects to be moved to another layer when they are placed in the layout.
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:BulkAssetMoveLayer.JPG]]</td>
 +
<td>
 +
*Tick the check box to randomly move a % of replacement objects to another layer
 +
**You must select a percent figure from 5% to 100% in steps of 5%. Values other than 0% and 100% will be approximate, not exact
 +
**You must select the layer to move the objects to
 +
*Untick the check box to keep all the replacement objects in the same layer as the original objects
 +
</td>
 +
</tr>
 +
</table>
 +
 +
The objects do not all have to start in the same layer.
  
 
----
 
----
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:DotPoint.JPG]]</td>
 +
<td>'''Option 1 and Option 2 can both be checked ON at the same time''' to produce a combined effect</td>
 +
</tr>
 +
</table>
 
----
 
----
<br>
 
  
 +
==Option 3: Delete Objects==
 +
 +
The third option allows the deletion of objects from the layout.
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:BulkAssetDelete.JPG]]</td>
 +
<td>
 +
*Tick the check box to randomly delete a % of the objects
 +
**You must select a percent figure from 5% to 100% in steps of 5%. Values other than 0% and 100% 100% will approximate, not exact
 +
</td>
 +
</tr>
 +
</table>
 +
 +
----
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:DotPoint.JPG]]</td>
 +
<td>'''Option 2 and Option 3 cannot both be checked ON at the same time'''</td>
 +
</tr>
 +
</table>
 +
----
 +
 +
='''Setting the Options - for Texture Objects'''=
 +
 +
The tool cab replace one texture with another. The only setting allowed controls the scale and rotation of the new texture.
 +
 +
The image below shows a region textured with one texture asset but with different scaling and rotation settings when the texture was laid.
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:BulkAssetTextureReplaceOriginal.JPG]]</td>
 +
</tr>
 +
</table>
 +
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:BulkAssetTextureReplaceOption.JPG]]</td>
 +
<td>With the check box ticked, the following is the result.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan="2">[[file:BulkAssetTextureReplaceScaleRot.JPG]]<br>
 +
The scale and rotation settings that were used in the original have not been used with the replacement texture.</td>
 +
</tr>
 +
</table>
 +
 +
<table>
 +
<tr valign="top">
 +
<td>[[file:BulkAssetTextureReplaceOptionOFF.JPG]]</td>
 +
<td>With the check box unticked, the following is the result.</td>
 +
</tr>
 +
<tr valign="top">
 +
<td colspan="2">[[file:BulkAssetTextureReplaceNoScaleRot.JPG]]<br>
 +
The same scale and rotation settings that were used in the original have been used the replacement texture.</td>
 +
</tr>
 +
</table>
 +
 +
----
 +
----
 +
<br>
 
='''Trainz Wiki'''=
 
='''Trainz Wiki'''=
 
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''
 
*'''<span class="plainlinks">[http://online.ts2009.com/mediaWiki/index.php/HowTo How to Guides]</span>'''

Revision as of 22:06, 26 June 2018

Contents

What is the Bulk Asset Update/Replace Tool?

DotPoint.JPG The Bulk Asset Update/Replace Tool allows the replacement, deletion and modification of multiple instances of one or more different assets, including textures, throughout an entire layout, a single baseboard or a selected area.

You will find the tool in the Surveyor Main Menu.

The tool automates the tedious process of deleting and replacing objects one at a time, as well as other tasks. It allow the mass simultaneous:-

  • deletion of objects
  • replacement of one or more objects by another object
  • random rotation of objects
  • movement of objects from one layer to another

These processes can be performed over the entire layout, a single baseboard or in a selected area only.

Most of them can also be performed on a randomly selected percentage, from 5% to 95%, of the designated objects.

The replacement operation can be performed on textures.


DotPoint.JPG When objects are being replaced they must be replaced by objects of the same general type - both must be spline objects, or both must be non-spline objects, or both must be textures, or both must be track objects, etc

If you attempt to replace one type of object with a different type you will receive an error message.

File:BulkAssetReplaceError.JPG This will indicate that at least one of the objects in the two lists is not of the same type as the other objects.

Things it Will Not Do

The Bulk Asset Update/Replace Tool cannot be used on:-

  • bridge spline objects
  • tunnel spline objects

Selecting the Assets

BulkAssetWindowReplacementTools.JPG
  • The large data box on the left of the tool window, the Assets to Update list, is used to store the names/kuids of the objects that are going to be replaced
  • The smaller entry box on its right. the Replace with list, is to store a single object that will replace the object or objects in the Assets to Update list


The quickest way of adding objects to the Assets to Update list is to:-

  • click on the Get Tool (shown below), then
  • click on the object in the Surveyor screen.

BulkAssetAddGetTool.JPG
The object will be added to the list, as shown in the example above.

This can be repeated for each object to be replaced.


An alternative method is to Drag and Drop an object from the Object Tool Selection Window as shown below.

BulkAssetAddDrag.JPG


The same method of Drag and Drop is used to add an object to the Replace with list.

BulkAssetAddDragReplace.JPG
DotPoint.JPG Only a single object can be added to the Replace with list. If a second object is dragged into the list it will delete and replace the first object.

Setting the Scope

Setting the Options - for Non Texture Objects

Option 1: Random Rotation

The first option controls the rotation or orientation of the replacement objects.

BulkAssetRandomRotate.JPG
  • Tick the check box to randomly rotate each replacement object as it is placed in the layout
  • Untick the check box to keep the original orientation of each object as it is replaced

Option 2: Move to Another Layer

The second option allows the replacement objects to be moved to another layer when they are placed in the layout.

BulkAssetMoveLayer.JPG
  • Tick the check box to randomly move a % of replacement objects to another layer
    • You must select a percent figure from 5% to 100% in steps of 5%. Values other than 0% and 100% will be approximate, not exact
    • You must select the layer to move the objects to
  • Untick the check box to keep all the replacement objects in the same layer as the original objects

The objects do not all have to start in the same layer.


DotPoint.JPG Option 1 and Option 2 can both be checked ON at the same time to produce a combined effect

Option 3: Delete Objects

The third option allows the deletion of objects from the layout.

BulkAssetDelete.JPG
  • Tick the check box to randomly delete a % of the objects
    • You must select a percent figure from 5% to 100% in steps of 5%. Values other than 0% and 100% 100% will approximate, not exact

DotPoint.JPG Option 2 and Option 3 cannot both be checked ON at the same time

Setting the Options - for Texture Objects

The tool cab replace one texture with another. The only setting allowed controls the scale and rotation of the new texture.

The image below shows a region textured with one texture asset but with different scaling and rotation settings when the texture was laid.

BulkAssetTextureReplaceOriginal.JPG
BulkAssetTextureReplaceOption.JPG With the check box ticked, the following is the result.
BulkAssetTextureReplaceScaleRot.JPG
The scale and rotation settings that were used in the original have not been used with the replacement texture.
BulkAssetTextureReplaceOptionOFF.JPG With the check box unticked, the following is the result.
BulkAssetTextureReplaceNoScaleRot.JPG
The same scale and rotation settings that were used in the original have been used the replacement texture.



Trainz Wiki


Route Creation Tutorials:


Session Creation Tutorials:

Personal tools