CCG/Fixed-Track

From TrainzOnline
< CCG
Revision as of 09:24, 7 June 2011 by Pev (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Contents

KIND: FIXEDTRACK

Description

A fixedtrack asset can be likened to a model trains sectional track system. The models may be straight or curved and snap into position when moved on to another track in Surveyor.

CCG Arrow on Fixed track.jpg


Container Structure

A well formed fixedtrack kind has the following container structure:

CCG fixedtrack dir.jpg

See Chapter 7 for an example asset of this kind.


A TYPICAL ASSET OF THIS KIND MAY HAVE THE FOLLOWING TAGS:

fixedtrack
username                   data
kind                       data
kuid                       kuid
preview-mesh-kuid          kuid
trainz-build               data
category-class             data
category-region            data
category-era               data
mesh-table
default
mesh                       file
auto-create                data
effects
arrow0
att                        data
default-mesh               kuid
surveyor-only              data
kind                       data
arrow1
att                        data
default-mesh               kuid
surveyor-only              data
kind                       data
attached-track
track0
track                      kuid
vertices
0                          data
1                          data
2                          data
thumbnails
0
image                      file
width                      data
height                     data


TAGS AND CONTAINERS

The following tags are further defined in Chapter 5:

kuid
Generated automatically by Content Manager.
trainz-build
Automatically set to 2.9 for 2009 assets.
category-class
Should be "TF" - Fixed Track. See the "Track" section of Category Class.

'category-region

See Category Region for a list of valid category-region values.
category-era
See Category Era for a list of valid category-era values.
username
Asset username. This will be the name that appears in the surveyor menu.
kind
Must be "fixedtrack".
preview-mesh-kuid
The mesh to be used in the surveyor preview area. This is useful when an asset has a large bounding box, i.e. the "Airport" with it's jet animation - also see below.
Mesh Table
Default - Contains the default mesh.
Effects
arrow0, arrow1 - These attachment effects place an arrow mesh at each end of the Default Mesh according to the attachmentpoints stored in the mesh file (and referenced in the vertices container). These arrows are used as guides and only shown in surveyor.


Additional Containers

As well as containing all of the common tags and containers detailed in Chapter 5 , the fixedtrack kind also contains additional containers and tags that are specialised to the requirements of the kind.

Attached Track Container

Auto-generated spline track. Generated through attachment points located within the default mesh. Attached-tracks update automatically to the spline track connected to it. You may over-ride this auto-update feature by adding useadjoiningtracktype 0

Note. Correct track end attachment orientation is essential. The Y axis must point `out' at the correct angle. The Z axis must point `up' - see Page 75 .

The Attached Track Container has the following tags and containers:

track
Kuid of the track to be used.
useadjoiningtracktype
Indicates whether the track type should change to match that of the first track joined to the object or not.
vertex
Attachment points at which to place track.

Junction-Vertices Container

The Junction-Vertices Container contains the tags needed to handle the lever portions of a fixed track.

The Junction-Vertices Container has the following tags:

junction-lever-mesh
The mesh (selected from the mesh table) to be used as a junction lever.
junction-vertex
The attachment point (located in mesh file) at which to place the lever.


Additional Tags

preview-mesh-kuid
Each fixedtrack asset needs a preview-mesh as spline tracks will not render in the Preview window.A preview-mesh can simply be setup as a kind mesh. This way the preview-mesh will never be selectable or seen in Surveyor.
use-gradient-track
Uses the spline gradient rather than following the ground height.

A fixedtrack comprises a mesh asset with an attached track (or tracks) and surveyor only rendered arrows so the user knows where the fixedtrack starts and ends.

The model has attachment points (using the a.name naming convention) set-up accurately in Max or Gmax, and a single invisible polygon to allow exporting, and for in-game asset selection. Note. Correct track end attachment orientation is essential. For the end attachment points, the axis must point `out' at the correct angle. The Z axis must point `up'. Mid points just need to be in the correct spline path. See diagram below. TRS2004 released fixedtracks comprise of only curved and straight sections.


Crossings and junctions are created in TC using the attached-track set-up. For crossings, create two attached-track fields. For junctions do the same but use one of the attachments twice as shown below (where a.track0b is used as the common connection point).

For example:

CCG fixedtrack junction atts.jpg

attached-track
track0
track                     <KUID:-1:15>
useadjoiningtracktype     0
vertices
0                         a.track0a
0                         a.track0b
0                         a.track0c
0                         a.track0d
0                         a.track0e
track1
track                     <KUID:-1:15>
useadjoiningtracktype     0
vertices
0                         a.track0b
0                         a.track0a
0                         a.track1b
junction-vertice
0
junction-lever-mesh       "lever0"
junction-vertex           "a.track0b"
1
junction-lever-mesh       "blades"
junction-vertex           "a.track0b"


See additional information on Page 383.


THIS KIND SUPPORTS THE FOLLOWING:

CONTAINERS
Mesh Table, queues Container, Smoke Container, SoundScript Container, Attached Track Container, Attached Trigger Container, String Table, Chinese String Table, Czech String Table, Dutch String Table, French String Table, German String Table, Italian String Table, Polish String Table, Russian String Table, Spanish String Table, KUID Table, Obsolete Table, Thumbnails, Privileges, Extensions, Junction-Vertices Container.
TAGS
kuid, trainz-build, category-class, category-region, category-era, username, kind, alias, author, autoname, category-keyword, class, contact-email, contact-website, description, description-cn, description-cz, description-de, description-es, description-fr, description-it, description-pl, description-nl, description-ru, dighole, floating, height-range, icon-texture, icon0, icon1, icon2, icon3, license, light, nightmode, organisation, preview-mesh-kuid, preview-scale, rgb, rollstep, rotate, rotate-yz-range, rotstep, script, snapgrid, snapmode, surveyor-name-label, surveyor-only, user-gradient-track, username-cn, username-cz, username-de, username-es, username-fr, username-it, username-nl, username-pl, username-ru.


Return to CCG Index

Content Creator's Guide

Personal tools