CCG/MOSignal

Latest revision as of 15:37, 7 June 2011

[edit] KIND: MOSIGNAL

[edit] Description

A train signal with lights (coronas). It specifies the aspects the signal is capable of displaying, the light points activated when each state is displayed, and the corona details. The signal may be offset a specified distance from the track.

[edit] Container Structure

A well formed mosignal kind has the following container structure:

See Chapter 7 for an example asset of this kind.

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

mosignal
  
kuid                       kuid
trainz-build               data
category-class             data
category-region            data
category-era               data
username                   data
kind                       data
function                   data
trackside                  data
signals
0
light                      data
lights
0
corona                     data
mesh-table
default
mesh                       file
auto-create                data
thumbnails
0
image                      file
width                      data
height                     data

[edit] 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 "WX" - Accessories. See the "Wayside" 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.

trackside

This is a value that is the distance in meters the object is placed relative to the center of the track. Negative values will put the object on the left side of the track, and positive values will appear on the right.

kind

Must be "mosignal".

mesh-table

Default - Contains the default mesh. Auto-create should be set to true in order to make the mesh visible.

[edit] Additional Containers

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

[edit] Signal Container

When adding a signal, the user is presented with a choice of 12 separate signal containers:

Signal 1, Signal 2, Signal 3, Signal 4, Signal 5, Signal 6,Signal 7, Signal 8, Signal 9, Signal 10, Signal 11, Signal 12

The numbering of these is meaningful in that each numeric is assigned to a particular signalling state. The states are as follows:

0 STOP

1 STOP THEN PROCEED

2 CAUTION AND LEFT DIVERGE

3 CAUTION AND RIGHT DIVERGE

4 CAUTION

5 PROCEED AND LEFT DIVERGE

6 PROCEED AND RIGHT DIVERGE

7 ADVANCED CAUTION

8 PROCEED

The following two aspects are only used for scenarios....

9 SLOW

10 MEDIUM SPEED

light

Sets lighting to be used for object to be ambient or directional. 0 sets ambient lighting and object is lit by general light value, (uniformly lit). 1 sets directional light which is affected by the position of the sun, and the asset shows shaded faces, but not ground shadows.

[edit] Lights Container

Each light point needs to have a corona associated with it. Coronas are stored in each signal object's directory alongside it's textures.

corona

A corona is a `glow' light effect.

[edit] Additional Tags

function

Must be set to TrackSignal.

[edit] THIS KIND SUPPORTS THE FOLLOWING:

CONTAINERS

Mesh Table, queues Container, Smoke Container, SoundScript 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, Signals, Lights.

TAGS

kuid, trainz-build, category-class, category-region, category-era, username, kind, function, alias, author, autoname, buffer-speed, category-keyword, class, contact-email, contact-website, description, description-

cn, description-cz, description-de, description-es, description-fr, description-it, description-pl, description-ru, dighole, floating, height-range, icon-texture, icon0, icon1, icon2, icon3, license, light, nightmode, organisation, passenger-height, preview-mesh-kuid, preview-scale, rgb, rollstep, rotate, rotate-yz-range, rotstep, script, snapgrid, snapmode, speedlimit, surveyor-name-label, surveyor-only, trackmark, trackside, trigger, username-cn, username-cz, username-de, username-es, username-fr, username-it, username-nl, username-pl, username-ru.

[edit] Return to CCG Index

Content Creator's Guide