Revision as of 20:54, 24 August 2023

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

	Driver Characters are avatars that can be assigned to locomotives in sessions. They play the role of train drivers and can be moved between locomotives
	Driver Character Icons are small graphic icons or images that can be selected to represent locomotive drivers in the Driver Setup Rule

Create the Driver Image

The final image must be reduced to 64 pixels by 64 pixels in size

The image can be easily created and resized using your favourite image editor. It can start with a photograph, as shown in the example below, a piece of clip art or a drawing. Make sure that there will be no copyright issues so something of your own creation, such as a photograph, would be ideal.

If possible use a photograph with a simple background behind the subject, as shown in the image on the left. This keeps the icon simple and can avoid unnecessary "clutter". Most image editors will have tools for removing unwanted backgrounds but this can be time consuming.

You may choose to add some clipart - in this case a train drivers cap and a "traditional" red scarf. Copyright free clipart is strongly recommended.

Driver clip art

The clip art can be added as layers to the image which makes them easier to manipulate (resize and move).

Crop the image to a square with the same number of pixels on each side with the minimum size being 64 pixels. Multiples of 64 (such as 128, 256, 512) would be ideal but not absolutely necessary as long as both the height and the width are the same size.

After cropping, reduce the image size to 64 pixels wide and 64 pixels high.

Save the final resized image with a suitable name and in a suitable file format:-

	.png (best choice)
	.tga (2nd best choice but do not use compression)
	.jpg (3rd best choice)

Create Driver Character Asset

Steps:

Create the Asset:

Steps: From the Trainz Launcher:-

1

select Manage Content

2

in Content Manager open the Developer menu

3

select New Content

	This will create a new asset and open it for editing.
	A message window will appear that will (hopefully) report on the successful creation of a new asset

4

Close the message window

Find the New Asset:

5	Set the Content Manager Search Filter to Open for Editing
This will display only those assets that have been opened for editing (hopefully only your new and as yet unnamed asset will be shown)

Open the Asset in Windows File Explorer:

6	Right Click on the entry New Asset
7	Select Open...
8	Select Show in Explorer

Open Config.txt File in Notepad:

There will only be a single item in the asset, its config.txt file
9	Double Left Click on the file to open it in Notepad

Edit the Config.txt File:

You will need to edit the contents of this file.
10	The next section, The Config.txt File, identifies the changes you will need to make. The new name you give to the asset will not take effect until after it has been Submitted
11	After editing, save the changes and exit Notepad

Warning:
	Unless you know exactly what you are doing, DO NOT ALTER THE KUID NUMBER that has been added to the file but even if you do, think twice before you change it !

Add Any Extras:

12

You will need to add:-

	a thumbnail image as described in the section The Thumbnail Image
	the icon image as described in the section The Icon Image
	texture text file as described in the section The Texture File

THIS IS AN EXAMPLE ONLY

This is the minimum number of files needed for a Driver Character

Finish Up:

13

Close the Asset window

14

Commit the asset in Content Manager

	Right Click on the asset
	Select Submit Edits Hopefully there will be no errors.

Because you still have the Search Filter Open for Editing in operation, the now closed and Submitted asset will vanish from the Content Manager display. To check that your asset has been correctly created and renamed, set the Search Filter to Today.

Some of the most common errors that can occur when creating and Submitting a new asset are:-

	no thumbnail image in the asset
	typing errors in the config.txt file
	poorly formatted tags in the config.txt file
	incorrect file types added to the asset folder
	files missing from the asset folder
	an incorrect kuid value (despite the warning you changed it in Step 5)

The Config.txt File

All assets must have a config.txt file

Settings:

The Driver Character asset must have a config.txt text file that must include the following tags:-

	kind set to "drivercharacter"
	username set to the asset title or name
	kuid a unique ID code
	thumbnails set to a 240 by 180 pixel JPG image

While not mandatory, the following tag is useful:-

category-class set to "OHD"

This file should follow the same (or a similar) format as the example below.
	entries in red must not be changed
	the indenting of the lines and the spacing ("tabbing") between the "tags" on the left and their contents on the right are purely to make it easier for humans to read
	the use of the {} braces is to group tags into common "containers". These containers must not be broken up and the number of { characters must match the number of } characters
	the order of the "tags" is not important

kuid                                    <kuid: this is an auto-generated number >
kind                                    "drivercharacter"
face-texture                            "DriverLillian.texture"
username                                "Driver Lillian"
category-class                          "OHD"
trainz-build                            4.3

thumbnails
{
  Default
  {
    width                               240
    height                              180
    image                               "thumbnail.jpg"
  }
  01
  {
    width                               64
    height                              64
    image                               "driverlillian.texture"
  }
}
description             "Icon for train driver Lillian"

Settings:

For the above example:

The kuid is unique to every asset so it is not a good idea to choose your own . This will be automatically generated by the Content Manager program when a new asset is created
The kind identifies the type of asset and the types of files that Trainz will expect to find in the asset. It also tells Trainz how to render and error check the asset. A list of asset kinds can be found at KIND Hierarchy
The face-texture is the name of the assets texture file. This will be a simple text file and will have the name asset_name.texture where asset_name will be a name you have selected for this asset - e.g. "driverlillian". The actual texture file itself will be named asset_name.texture.txt (e.g. "driverlillian.texture.txt") but the filename ending ".txt" is not added to the name in the face-texture tag so it would appear as "driverlillian.texture"
The username is your name for the asset and the name that other users will see. It is also the name that will appear in the Driver Setup Rule when the driver is being selected. It is a good idea to make it short and meaningful.
The category-class identifies the intent of the asset and is important in classifying it for filtering and searching. For driver character assets, the category class is "OHD". A list of category classes can be found at Category-class
The trainz-build identifies the minimum Trainz version needed for this asset. A list of asset trainz-build numbers and their corresponding Trainz versions can be found at "Trainz-build"_number
The thumbnails container holds the preview images of the asset shown by the Content Manager program, the Web version of the DLS and, for some assets, the Surveyor main menu image(s) and in this case the asset texture itself. Information on thumbnails can be found at Thumbnails
- The first thumbnail Default is the container ID or placeholder for the thumbnail used by CM and the Web based DLS. While its exact label (or number - eg. "Default", "00", "01", etc) is not important, it must be different from any other labels. Default and 0 are commonly used placeholder labels for the 240 x 180 thumbnail image
  - The image is the name of the thumbnail image. It does not have to be called thumbnail.jpg but it must be a JPG format image
  - The width of the image in pixels must be 240
  - The height of the image in pixels must be 180
- The second thumbnail 01 is the placeholder label for the 64 x 64 icon image used by the Driver Character for this asset. Its exact label does not matter but it must be different from the first thumbnail image placeholder label
  - The image is the assets asset_name.texture.txt file (but without the ".txt" at the end)
  - The width of the image in pixels must be 64
  - The height of the image in pixels must be 64
The description provides more details for users than the username

	Language Options:
	All Trainz assets have a language facility built into their config.txt files that allows other language translations to be added for certain tags, such as the username and description tags. A full description of the process can be found on the Trainz Wiki at Localize an Asset and a list of all the supported languages with their two character codes at Localization (country) Codes. At the very basic level any creator can easily provide other language translations for the username and description tags in the assets they create. Examples are shown below for this sample asset.
username "Driver Lillian" username-c2 "司机莉莲" username-es "Conductor Liliana" username-de "Fahrer Lilian" username-fr "Chauffeur Lilianen" username-nl "Chauffeur Lillian" username-ru "Драйвер Лилиан"
	Translations to Chinese (simplified), Spanish, French, German, Dutch and Russian, perfect or not, were provided by Google Translate.

The Thumbnail Image

A thumbnail image MUST be present in the asset

Notes:

The thumbnail image:-

must be in JPG format.
must be 240 pixels wide by 180 pixels tall.
does not have to be named thumbnail.jpg as long as the name used is in the Thumbnails container in the config.txt file.

The Icon Image

	You will need image editing software to create the icon image or to change an existing image to the required dimensions and format
	See the Create the Driver Image section at the top of this page for an example

(not to scale)

Settings:

The image must meet the following specifications:-

64 pixels wide and 64 pixels tall
bit depth should be 24 (no alpha channel or transparency) or 32 (if an alpha channel is used)
image file format can be any of:-
- bmp
- jpg (jpg does not support transparency)
- png
- tga (tga compression should not be used)

If your image will have a transparency, such as a transparent background, it is usually a lot easier to save the image in a format that supports an alpha channel (bmp, png or tga) and either

convert the background to a transparency or
remove the background and add a transparent layer to the image as its background

than it is to use a format that does not support an alpha channel and have to create a second image for the alpha channel. See The Texture File below.

The Texture File

The .texture.txt file controls how an image icon is displayed, particularly its Alpha Channel (or transparency) data. The file must be present even if no transparency is used in the icon.


	Settings: the Texture File is a standard text file the filename is composed of:- a user selected asset_name followed by a period (.) the word texture followed by a period (.) the letters txt

A sample Texture File, "driverlillian.texture.txt", is shown below:-

primary=Lillian64.png
alpha=Lillian64.png
tile=st


	Settings: primary - this is the name of the icon image file that contains the RGB colour image. Any alpha channel in this file will be ignored alpha - this is the name of the icon image file that contains the Alpha Channel (transparency) image (see Notes: below) tile=st - instructs Trainz to tile the image both horizontally and vertically. This has no effect on the Driver Character icon but must be included for validation purposes No "white spaces" between the text characters is allowed.

Notes:

There are 3 general "scenarios" for the structure of the Texture File in a Driver Character asset.

If the icon has a transparency (an alpha channel) and is saved in a format that supports the alpha channel

Then:-

primary=Lillian64.png
alpha=Lillian64.png
tile=st

the primary and alpha images are the same file, as in the example shown left
the image must contain both the RGB colour data and the Alpha Channel (transparency) data (it must have a depth of 32 bits)

If the icon needs to have transparency (an alpha channel) but an alpha channel is not available (e.g. it is saved in the jpg file format) or is not suitable

Then:-

primary=Lillian64.jpg
alpha=Lillian64_alpha.jpg
tile=st

two different files (different file names or different image file formats) must be used as in the example shown left
both images must be the same size (64 pixels x 64 pixels)
both images must have a depth of 24 bits - so no alpha channel must be present in either image
the alpha image file should be a greyscale image or even just black and white

If the icon image does not have a transparency and no alpha channel is needed

Then:-

primary=Lillian64.jpg
tile=st

the alpha= line in the .texture.txt file is not needed, as in the example shown left
the primary file contains the RGB colour data and can be in any supported image format. If it also has alpha channel data then the alpha channel data will be ignored so the icon will be shown without any transparency

Image file formats supported by Trainz that have an alpha channel are:-

bmp
png
tga

Image file formats supported by Trainz that DO NOT have an alpha channel are:-

jpg

A detailed description of the .texture file format can be found on the Trainz Wiki Page at:-

Texture File

Using the Asset

Once the new asset has been committed it will be available for use in a Driver Setup Rule.

Steps:

Open the Session Editor (see Session Editor) and open it for editing.

Select the Driver Setup Rule and Left Click the Edit button
Select a driver icon to change to your new wicon, or add a new driver
Left Click on the icon for the selected (or new) driver
Scroll down the list to find your newly created driver character
Select the driver name and Left Click the icon
Left Click the on the Driver Setup Rule window to accept the selection

The finished product as a Driver.

Trainz Wiki

More Tutorials and Guides to Using Trainz

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

@@ Line 1: / Line 1: @@
+<table width=1000>						<!-- BEGIN Nav Buttons Table NO SKIPS -->
+<tr valign="top">
+<td width=729>&#160;</td>
+<td width=50>&#160;</td>
+<td width=50>&#160;</td>
+<td width=46>&#160;</td>
+<td width=75>&#160;</td>
+<td width=75>[[image:NextDown.png|link=#stepCreateImage|alt=Next Down|Next Down]]</td>
+<td width=75>[[image:BackToBottom.png|link=#bottom|alt=Bottom|Bottom]]</td>
+</tr>
+</table>								<!-- END Nav Buttons Table -->
 The information in this Wiki Page applies to '''TANE''', '''TRS19''', '''Trainz Plus''' and '''TRS22'''.<br>
-<table cellpadding=4 bgcolor=#c1e7e7>
+<table width=1000 bgcolor="lightcyan" cellpadding=2>
 <tr valign="top">
-<td>[[file:DotPoint.JPG|link=]]</td>
+<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 <td>'''Driver Characters''' are '''avatars''' that can be assigned to locomotives in sessions. They play the role of train drivers and can be moved between locomotives</td>
 </tr>
 <tr valign="top">
-<td>[[file:DotPoint.JPG|link=]]</td>
+<td>[[image:BlueDot10x10.png|link=]]</td>
 <td>'''Driver Character Icons''' are small graphic icons or images that can be selected to represent locomotive drivers in the [[file:WikiLink.PNG|link=]] '''[[How to Use Driver Setup Rule|Driver Setup Rule]]'''</td>
 </tr>
 </table>
 <br>
-<table>
+<table width=1000>
 <tr valign="top">
 <td>
@@ Line 21: / Line 33: @@
 </table>
-<table>						<!-- BEGIN Nav Buttons Table -->
+<table width=1000>						<!-- BEGIN Nav Buttons Table -->
 <tr valign="top">
 <td width=729><span id="stepCreateImage"></span>&nbsp;</td>
@@ Line 32: / Line 44: @@
 ='''Create the Driver Image'''=
-<table cellpadding=4 bgcolor=#c1e7e7>
+<table width=1000 bgcolor="lightcyan" cellpadding=2>
 <tr valign="top">
-<td>[[image:DotPoint.JPG|link=]]</td>
+<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 <td>'''The final image must be reduced to 64 pixels by 64 pixels in size'''</td>
 </tr>
 </table>
-<table>
+<table width=1000>
 <tr valign="top">
 <td>The image can be easily created and resized using your favourite image editor. It can start with a photograph, as shown in the example below, a piece of clip art or a drawing. Make sure that there will be no copyright issues so something of your own creation, such as a photograph, would be ideal.</td>
@@ Line 45: / Line 57: @@
 </table>
 <br>
-<table>
+<table width=1000>
 <tr valign="top">
 <td>[[image:DriverIconOriginal.png|link=|alt=Original photo of a cat]]</td>
@@ Line 67: / Line 79: @@
 </table>
-After cropping, reduce the image size to 64 pixels wide (and therefore 64 pixels high).
+After cropping, reduce the image size to '''64''' pixels wide and '''64''' pixels high.
 <table>
@@ Line 91: / Line 103: @@
 </table>
-<table>						<!-- BEGIN Nav Buttons Table -->
+<table width=1000>						<!-- BEGIN Nav Buttons Table -->
 <tr valign="top">
 <td width=729><span id="stepCreateAsset"></span>&nbsp;</td>
@@ Line 456: / Line 468: @@
 </table> 																<!-- END Steps table -->
 <br>
-<table>						<!-- BEGIN Nav Buttons Table -->
+<table width=1000>						<!-- BEGIN Nav Buttons Table -->
 <tr valign="top">
 <td width=729><span id="stepConfig"></span>&nbsp;</td>
@@ Line 574: / Line 586: @@
   '''description             "Icon for train driver Lillian"'''
-<table cellpadding=4 bgcolor=#eeeeee>
+<table width=1000 cellpadding=4 bgcolor=#eeeeee>
 <tr>
 <td colspan="2">
@@ Line 607: / Line 619: @@
 </table>
-<table bgcolor=#ffffe0>
+<table width=1000 bgcolor=#ffffe0>
 <tr valign="top">
 <td>[[file:PencilTips.PNG|link=]]</td>
@@ Line 638: / Line 650: @@
 </table>
 <br>
-<table>						<!-- BEGIN Nav Buttons Table -->
+<table width=1000>						<!-- BEGIN Nav Buttons Table -->
 <tr valign="top">
 <td width=729><span id="stepThumbIcon"></span>&nbsp;</td>
@@ Line 650: / Line 662: @@
 ='''The Thumbnail Image'''=
-<table cellpadding=4 bgcolor=#c1e7e7>
+<table width=1000 bgcolor="lightcyan" cellpadding=2>
 <tr valign="top">
-<td>[[image:DotPoint.JPG|link=]]</td>
+<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 <td>'''A thumbnail image MUST be present in the asset'''</td>
 </tr>
@@ Line 685: / Line 697: @@
 ='''The Icon Image'''=
-<table cellpadding=4 bgcolor=#c1e7e7>
+<table width=1000 bgcolor="lightcyan" cellpadding=2>
 <tr valign="top">
-<td>[[file:DotPoint.JPG|link=]]</td>
+<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 <td>You will need image editing software to create the icon image or to change an existing image to the required dimensions and format</td>
 </tr>
 <tr valign="top">
-<td>[[file:DotPoint.JPG|link=]]</td>
+<td>[[image:BlueDot10x10.png|link=]]</td>
 <td>See the [[file:PageLink.PNG|link=]] '''[[#Create the Driver Image|Create the Driver Image]]''' section at the top of this page for an example</td>
 </tr>
 </table>
 <br>
-<table>
+<table width=1000>
 <tr valign="top">
 <td>[[file:Texture64Pixels.PNG|link=]]<br>
@@ Line 726: / Line 738: @@
 </table>
 <br>
-<table bgcolor=#000000>
+<table width=1000 bgcolor=#000000>
 <tr valign="top">
 <td>
@@ Line 743: / Line 755: @@
 </table>
 <br>
-<table>						<!-- BEGIN Nav Buttons Table -->
+<table width=1000>						<!-- BEGIN Nav Buttons Table -->
 <tr valign="top">
 <td width=729><span id="stepTexture"></span>&nbsp;</td>
@@ Line 754: / Line 766: @@
 ='''The Texture File'''=
-<table cellpadding=4 bgcolor=#c1e7e7>
+<table width=1000 bgcolor="lightcyan" cellpadding=2>
 <tr valign="top">
-<td>[[file:DotPoint.JPG|link=]]</td>
+<td width=10>[[image:BlueDot10x10.png|link=]]</td>
 <td>The '''.texture.txt''' file controls how an image icon is displayed, particularly its '''Alpha Channel''' (or transparency) data. The file must be present even if no transparency is used in the icon.</td>
 </tr>
@@ Line 782: / Line 794: @@
 <br>
 A sample '''Texture File''', "driverlillian.texture.txt", is shown below:-
-<table cellpadding=5>
+<table width=1000 cellpadding=5>
 <tr>
 <td>
@@ Line 810: / Line 822: @@
 </tr>
 </table>
-<table cellpadding=4 bgcolor=#ffffb0>
+<table width=1000 cellpadding=4 bgcolor=#ffffb0>
 <tr valign="top">
 <td>[[file:NotePad.PNG|link=]]</td>
@@ Line 893: / Line 906: @@
 </table>
 <br>
-<table>						<!-- BEGIN Nav Buttons Table -->
+<table width=1000>						<!-- BEGIN Nav Buttons Table -->
 <tr valign="top">
 <td width=729><span id="stepUsing"></span>&nbsp;</td>
@@ Line 907: / Line 920: @@
 Once the new asset has been committed it will be available for use in a '''Driver Setup Rule'''.
-<table>
+<table width=1000>
 <tr valign="top">
-<td>[[file:DriverIconSelect.png|link=]]</td>
+<td width=500>[[file:DriverIconSelect.png|500px|link=]]</td>
 <td>
 <table cellpadding=4 bgcolor=#ffffff>
@@ Line 938: / Line 951: @@
 [[image:DriverIconLillian.png|link=]]
-<table>						<!-- BEGIN Nav Buttons Table -->
+<table width=1000>						<!-- BEGIN Nav Buttons Table -->
 <tr valign="top">
 <td width=729><span id="bottom"></span>&nbsp;</td>

How to Create a Driver Character

Revision as of 20:54, 24 August 2023

Contents

Create the Driver Image

Create Driver Character Asset

The Config.txt File

The Thumbnail Image

The Icon Image

The Texture File

Using the Asset

Trainz Wiki

Views

Personal tools

Navigation

Search

Toolbox