"Thumbnails" container

Revision as of 07:06, 10 June 2013

Any asset may specify a thumbnail or preview image. The exact usage of this image may vary depending on the asset kind and the build of Trainz, but the following usages are historically common:

• 32x32 - standard icon representation for display in lists.
• 128x64 - ‘kind traincar’ list icon in Surveyor.
• 512x512 - ‘kind traincar’ preview image in Surveyor.
• 240x180 - Download Station thumbnail image - mandatory, and must be in JPEG format.

Note: The Art files directory used in old versions of Trainz should no longer be used- the Thumbnails container replaces and extends this functionality.

Any number of thumbnail entries may be present, however it is recommended that no more than 3 images are used. The specified width and height must match the actual width and height of the image file in pixels.

Supported image formats include:

• 32-bit uncompressed targa (.tga) - this supports an alpha channel
• 24-bit windows bitmap (.bmp)
• JPEG (.jpg)
• Texture file (.texture.txt) - strongly recommended.

When displaying an image, the closest-sized image required by the function (in terms of pixel dimensions) will generally be used in Trainz. The container numbers are simply identifiers and have no meaning in themselves.

thumbnails
{
  0
  {
    width 32
    height 32
    image "thumbnail-32.texture"
  }
}