Revision as of 15:07, 21 December 2014

Repairing assets for Trainz:A New Era (T:ANE)

Purpose

The purpose of this page is to assist content creators correct errors and warnings found in TS12 compliant assets for T:ANE.

Discussion

TS12 compliant assets are supposed to be equally compliant for T:ANE. However, T:ANE has introduced stricter compliance and that may throw up errors and warnings not previously seen in TS12.

This page is not intended to identify or correct issues with T:ANE itself. Bugs, deficiencies or any other problems should be reported via the T:ANE reporting system or via Trainz T:ANE forums.

Contributions

This is a WiKi so anyone can contribute. If you do not have N3V WiKi write/create access or don't wish to edit yourself, either contact PCAS1986 via this forum thread http://forums.auran.com/trainz/showthread.php?116296-Creating-Content-for-CE-and-beyond&p=1351600#post1351600 or get someone else, who does have access, to do it for you.

Sunset Clause

This is not intended to be a permanent page. Request it be removed when T:ANE content creation documentation is available on the WiKi or when it has outlived its usefulness.

Errors

Texture Errors

Texture cannot be loaded:

Typical error message:

- failed to open binary texture 'bb_main_bogey.texture' for 'd:/tane/tane-ce-userdata/original/hash-C0/kuid2 186372 110002 3'

- Texture 'bb_main_bogey.texture' is missing or could not be loaded in mesh 'bb_bogey_export_lopo_v1.im', material 'bb.m.reflect'.

Solutions:

1. AssetX has a command called "Repair/Repair Textures" that should clear most problems. See notes below regarding AssetX and T:ANE.

2. Option 1 didn't work for a bogey asset for the author (PCAS1986) although it was cleared by increasing the kuid number and recommitting the asset. However, this doesn't seem like a valid solution.

Invalid MIP count:

Typical error message:

- binary texture file 'carriage-normal.texture' has invalid mip count for 'd:/tane/userdata/local/hash-92/kuid 186372 100298'

Solution:

One or more of the texture dimensions exceeds 2048. You may have to resize. Currently, it is not known if this will be a T:ANE limitation.

Warnings

LOD

Typical warning:

! The low-detail meshes total more than 500 polygons. This may have a negative impact on performance.

Solution:

The lowest level mesh should be reduced to a simple box form with as little detail as possible. Guidelines on LOD can be found at Modeling_Guidelines#Level_Of_Detail.

AssetX and T:ANE

Currently, AssetX is not optimised for T:ANE (build 3.9) and particularly for newer tags such as those used for procedural track.

You can use the current version of AssetX with TANE for most repairs.

To do this you should:

1. Set your build number in AssetX to 3.7 or 3.8

2. Set one of your Home Folders to (TANE-Path)\UserData\editing

3. Use the T:ANE Content Manager to open the asset for edit, this should make the asset appear in AssetX

4. Carry out your repairs.

5. Use T:ANE Content Manager to commit the asset.

Uploading revised assets to the DLS

As at 17 Dec 14, N3V have not enabled uploading of T:ANE content (build 3.9) to the DLS. See this post http://forums.auran.com/trainz/showthread.php?116296-Creating-Content-for-CE-and-beyond&p=1351757#post1351757