[<< wikibooks] Trainz/containers/attached-track container
= attached-track container =
The Attached-track container is used by kind SceneryWithTrack to identify a list of track subcontainers. Each track derives its name from the subcontainer's tag name. These names are used from script.
Each track is auto-generated spline track through attachment points located within the default mesh.

Attached-tracks update automatically to the spline track connected to it in Surveyor. You may over-ride this auto-update feature by adding useadjoiningtracktype 0 (see below).
Correct track end attachment orientation is essential. The Y axis must point ‘out’ at the correct angle. The Z axis must point ‘up’.


== Track subcontainer ==
Each track subcontainer supports the following tags and subcontainers. Each tag is shown here with its default value.

track                   (no default value, this must be track kuid)
useadjoiningtracktype   1
vertices                {}


=== track ===
Type: Kuid
Desc: Kuid of the track or spline to be used.


=== useadjoiningtracktype ===
Type: Boolean
Desc: If true (1) then the track type will change to match that of the first track joined to the object.


=== vertices ===
Type: Vertices container
Desc: This is a list of attachment points of where the track will be attached.  Each entry must have a name.


== Standard Config defines ==


=== TBS Standard definitions ===
These tags and containers are standard definitions which are likely found in nearly all assets. Some tags are optional, and may not be defined by content creators, as their choice.
Tags are keywords, and have a single assigned key-value or containers such as a string-array or '{' ... '}' bounded enclosed tag-value pairs or sub-containers. (Everything declared in Trainz config files is in pairs, for even '{' ... '}' is considered a 'key-value'.

Containers are collections of 'key' and 'key-value' pairs and  'upper-level containers' in the TBS (as opposed to sub-containers such as those within the thumbnails container) are generally suffixed by '-table'. 


== Example-1 brief Config.txt ==
Sample config.txt file for an industry asset, with the Standard Tags:

{
 kind industry
 attached-track {
   slc-spur {
     vertices {
       0                                   "a.track0a"
       1                                   "a.track0b"
       2                                   "a.track0c"
       3                                   "a.track0d"
       4                                   "a.track0e"
     }
     track                                 
     useadjoiningtracktype                 1
   }
 }
 attached-trigger {
   unload-trigger {
     att                                   "a.unload-trigger"
     radius                                2.00
     track                                 "slc-spur"
   }
   load-trigger {
     att                                   "a.load-trigger"
     radius                                2.00
     track                                 "slc-spur"
   }
   gate-trigger {
     radius                                10.00
     att                                   "a.gate-trigger"
     track                                 "slc-spur"
   }
 }
}


== Example-2 ==
This expandable below is a full kind buildable (industry):

 light                                   1
 height-range                            -10,10
 
 attached-track
 {
   track_0
   {
     track                               
     useadjoiningtracktype               1
     
     vertices
     {
       0                                 "a.track0a"
       1                                 "a.track0b"
     }
   }
 }
 
 smoke0
 {
   attachment                            "a.smoke0"
   mode                                  "time"
   color                                 25,25,25,255
   accel                                 0,0,0.25
   start                                 0
   rate                                  4
   period                                -1
   velocity                              1
   lifetime                              2
   minsize                               0.25
   maxsize                               2
 }
 
 smoke1
 {
   attachment                            "a.smoke1"
   mode                                  "time"
   color                                 255,255,255,150
   accel                                 0,0,0.25
   start                                 0
   rate                                  4
   period                                -1
   velocity                              1
   lifetime                              2
   minsize                               0.25
   maxsize                               2
 }
 
 obsolete-table
 {
 }
 
 mesh-table
 {
   default
   {
     mesh                                "Brewery.im"
     auto-create                         1
   }
 }
 
 thumbnails
 {
   A-fmMeshViewer
   {
     image                               "$screenshot (240).jpg"
     width                               240
     height                              180
   }
   B-Original
   {
     image                               "$Thumbnail.jpg"
     width                               240
     height                              180
   }
 }
 username                                "business wood frame Brewery-aRus"
 trainz-build                            2.9
 kuid                                    
 kind                                    "buildable"
 category-class                          "BB"
 category-region						    "CA;US"
 category-era						    "1840s;1850s;1860s;1870s;1880s;1890s;1900s;1910s;1920s;1930s"
 
 description                             "username= 'business wood frame Brewery-aRus'
 
 
 Original description:
 Upgraded for TS2012/SP1 compatibility.
 Original username: Brewery 
 
 Key Data:
 trainz-build                            2.9
 kind                                    'buildable' (scenery-w-track)
 useadjoiningtracktype                   1
 kuid                                    
 
 --------- --------- 
 Rev-A 2014-1016 - by Fabartus - Massage description, replace thumb with Mesh-viewer generated version, adjust smoke mode from 'constant' to 'time' (legal enumerated value), added category region and era sorting string arrays and lastly, rename asset and foldername of library per NAMCON to unified format adopted 2014-0612. 
 --------- --------- 
 
 Asset foldername: kuid2 210518 1021 2;v2-9;scenery-w-track business;business wood frame Brewery-aRus
 Original folder:  F:\TS12\UserData\editing\brewery
 *****************************************************************************************************
   "
 
 author                                  "Benjamin R. Dorsey (bendorsey)"
 contact-email                           "withheld & deleted"
 license                                 "This item is released free of charge for your enjoyment. 
 You may use, redistribute, and re-skin the model as long as you do not do so for profit or include it in any package for profit."
 
 kuid-table
 {
   1_track_wood                          

  }