Trainz/Glossary

From Wikibooks, open books for an open world
< Trainz(Redirected from Trainz/Trainz Objectz)
Jump to: navigation, search
logo
Fundamentals for Trainz Trainees
Trainz | Introductory Trainz  | Trainz AM&C | Creation  | Appendixes  |  References  • Containers • Kinds • Tags • Index
 Glossary
 HKeys-CM
 HKeys-DVR
 HKeys-SUR
 HKeys-WIN
 Mouse use
 Notations
This glossary includes terms related to using Trainz. For general real railway terminology and computer/Internet terminology not found here we suggest using resources such as Wikipedia, and the TrainzOnline reference page Terminology.

See also File Types (File Extensions).

Yard Panorama view from cab of Driver #2 (Left bar of stacked AI Driver faces); TRS2006 bottom line shows "Driver Command" Icons of a scripted task for the AI Driver. The leftmost icon is "Wait for Trigger" event, at which case the next Driver Command becomes active.

Aa to Bz[edit]

AI Train OR AI Driver
Artificial Intelligence 'Driver' manned Train. A train which is controlled by a program, script, commands, scenario, etc and not by the user. In many ways AI trains are the Trainz equivalent of the supporting NPC's (Non-Player Characters) found in many computer games.
  • AI Drivers are programmed by Driver Commands, a type of Trainz Rule which the session creator programs.
  • Many AI Drivers can be controlled by users hopping the consist and issuing such Commands Commands, if the session writer allows. In particular, Dispatcher Sessions rely on your ability to organize and command AI Drivers to do tasks by giving a series of such commands.

 

Asset (or also 'Content')
Any object used in Trainz, for example a layout, a tree, a signal, a locomotive or a pantograph; each has their own defining folder and Config.txt file ini file defining how the data in the folder is to be processed and classified by Trainz run-time software. There are many more types of assets. Each asset has a KUID unique to its build level and attributes.

 

attributes
a general computing term that refers to any distinction one might make in describing a data item or process.
A single letter in a Trainz ini file (configs) can radically change how Trainz processes it's associated data. That letter's value is an attribute of the data. (See category-class tag which is an attribute of the allowed enumerated legal and acceptable asset types. (enumerated, meaning specifically specified, listed, pre-defined, and accepted)

 

A passenger car has different attributes from a Locomotive and a freight car, and each has their own set of virtual and physical attributes one wants modeled realistically.

 

Further, realistically and correctly aren't equivalent in modeling, one tries to be as correct as possible, but rendering a coupler in Solidworks CAD/CAE software leaves one with an object so densely defined in graphics polygon meshes, that graphical rendering in real time simulator operating (Driving, Surveyoring) as to take many computations so as to be unusable—it is more correct, but effectively useless. Modeling a Trainz object that is efficient means correct often needs to take a back seat. Heavy Consumption by an object of valuable computing cycles bog the simulation down when detail is used to excess. Many Trainz spline objects (instant forests, grasses, etc. have this issue, for they were not carefully designed to account for rendering loading.)
Also one can 'slide through' a virtual object and see the backside of the traincar or house, so unless a passenger car or loco cab designed with an interior mesh set, the attribute of being 'inside' is an obvious model versus a highly detailed 'roomlike' interior.

 

Auran, Auran Games Pty, Ltd,[1] Auran Holdings Pty, Ltd[1], Auran Developments Pty. Ltd.
The Australian games software company which developed and published Trainz and it's graphics engine Auran JET. Trainz marketing, development, and sales is now controlled by N3V Games Pty Ltd,[2] and Auran[1] is (from 2008 to present) more of a holding company now, but still owns Trainz franchise rights similar to the way the James Bond movie franchise has several levels of organization and ownership rights. We Trainzers deal with N3V games now, and let the Lawyers worry about the rest.

 

Behavior
Another name for a Rule in sessions programming or asset development contexts. Rules are 'scriptlets' which are dynamically loaded when an Session asset uses one.
  • On the technical side, "behavior" is an enumerated type specified of one possible allowed values as the parameter of the kind tag in a config.txt file specifies that the asset is a Rule.

 

Built-in asset or Built-ins (BI)
All the built-in items of your Trainz release version. These are found in .JA files which are configured for rapid upload into the game and tightly organized. Certain items, such as thumbnails are stripped from the JA's which are mandatory for uploading an asset to the DLS, where the thumbnails are used in web pages and/or downloaded to the cache for views in CM. Consequently, such images are not part of any cloned asset.

 

Ca_to_Cbz[edit]

CAB meaning Cabin Mode
The more realistic and more challenging of the two driving modes in Trainz.
Train consists in CAB mode operate very differently for the full physics of each traincar is simulated, as is the delay for the air brakes systems to begin to have effect, wheel slippage on the Locos, and a host of other Real World physical modeling that is one of the attributes of Train simulators where Trainz software separates itself ahead of other competing packages.
In Cab Mode the user can operate the driver's controls inside the 3D virtual cab by Click-N-Drag with the mouse, as well as use a superset of the hotkeys that are available in DCC mode; a few of which operate similarly but with important differences.

 

CAB files
A software publishers standard Compressed Asset Base (CAB) system files (which includes all the optional built-in items of it's release version), and are usually hidden away somewhere you don't think to look. Think of them as a Bank you can access to get money (features).
  • Windows applications which are optional (accessibility add ons, Language extensions, Windows Media Player, Disk defrag and Disk checking utilities, etc.) are kept in the Windows CAB files.
  • JA files are Auran/N3V's semi-compiled analog of CABs configured for rapid upload into the game and tightly organized. Your releases built-in assets are in the JA files.

 

Camera view, Camera position, Camera mode
Camera location, directional angles from that co-ordinate axis, and zoom are how we see inside the Trainz virtual world—they define a viewpoint from which we observe, all generated by the graphics engine. They place us within the game graphics.

Driver has four camera viewpoints or 'camera modes':

  1. 1 selects an Internal camera— there most often will be more than one; you know you're in an early loco model when there aren't at least five. Use [+] to select by toggling between them.
  2. 2 selects an External camera, this is attached to the consist somewhere and moves with the train, use + / - to select which traincar the camera follows by scan-toggling between them. This mode normally starts on the engine so - will move the camera towards the rear of the Train. This is also the camera mode in Railyard.
  3. 3 selects the Tracking Camera mode. This is a camera in a fixed location the route designer places in the world with a viewpoint to showing the Train externally either at a fixed direction & angle, or which stays in place, but stays focused on the train and rotates (tracks) to stay locked on the targeted car. Use ++- as in camera mode 2 to view a different anchor car.
  4. 4 selects the Free Camera mode, and is arguably the feature which lead to Trainz successful growth. This is also the Camera mode used in Surveyor and it's focal point is always at the center of your display.
     • The Mouse, mouse wheel, and keyboard arrow keys , , , & are used to position, zoom, and move this camera about including through objects.
     • Use RMBh and drag the tool pointer (cursor) right, left, up or down screen away from screen center to slide the camera around, or rotate the view angle. (Surveyor Options settings dependent, customize to suit self: two controls pan and rotation)
     • This lets us use LMB and clicks using the 'mouse pointer' (tool tip) to operate junctions, turn valves, turn the DCC Mode dial, operate slider controls, and generally toggle or select button options, and like actions.
  • The precise way the keys and mouse pan, rotate, and slide in Free Camera mode are set by two slider (essentially click boxes) in Surveyor options in the run time Driver or Surveyor modules.
  • Which of the four combinations you use are matters of preference or may be selected for superiority during a specific kind of task when world building.

 

Cc_to_Cz[edit]

CC or Content Creator
Those wonderful dedicated people that put in the hard work to make a good looking and often difficult digital model suitable for Trainz. Content Creation can take a highly skilled modeler from an hour for simple assets such as a house to six to eight months for a locomotive.
CCP for Content Creator Plus
This is an asset creation and update utility sometimes run independent of other Trainz run time software. It can be used from within CM to edit a config.txt file, but is relatively unforgiving should you be Error Fixing or just upgrading an asset. Proper use for new Trainzers would be to increment the KUID/kuid2 of a self-created Route or Session with a suffix. Otherwise learn to hand edit in Notepad++ or similar text editor. If you're already so familiar with the nuts and bolts of Trainz so as to be making assets, you'll be more familiar with CCP than most.

 

*.cdp, *.cdpa and *.cdp2 files

Auran/N3V 'Content Dispach Packs', a proprietary compressed file format in which Trainz assets are stored, archived, and transmitted.
All three cdp file types are registry entries in Windows operating systems, and if you run multiple versions of Trainz the one entry that might bite you with a careless click of your mouse (annoying, but not fatal). The *.cdpa files are library assets you have decided to archive in a specific folder; these are tracked and managed by the originating CM/CMP program.
Further information: Trainz/Trainz file management, Trainz first-steps, and Running more than one Trainz version

Cm_to_Cz[edit]

CM or Content Manager formerly CMP.
Since little was changed in 2005's release of CMP within TC1&2, TC3 or TS2009, 'CMP' became 'CM' on the forums long before TS09 was released by N3V with Content Manager 2.0, apparently dropping the 'plus' since it was now four years later.
TS2009 in it's fourth Service pack and in versions since, CM displays the Trainz-build version for which it creates new assets—generally the ceiling limit which can be used in that installation without resorting to fiddling edits like in retrograding content.
The asset management system in Trainz versions which acts as a upload and download manager, data base manager, data base and DLS browser, archive manager, update controller, and editor launcher.

 

CMP and Content Manager
The name of the asset management system introduced as the major change advancing TRS2004 to TRS2006 and also continued in the various TRS2006 spinoff releases such as the three Trainz Classics (TC1, TC2, & TC3), TRS2007, TRS2008 (both Europe only regional releases).

 

Config.txt files, config.txt file, and config.txt files
Main pages: Trainz/config.txt files, Trainz/AM&C/config.txt files, Trainz/references/config.txt file, and Trainz/TrainzBaseSpec
Each asset has a config.txt file holding the TrainzBaseSpec which defines the top level attributes of the asset and specifies many of its properties, including how the software interprets and processes the data linked and controlled by such files. No asset in Trainz exists without a config.txt file. Config files identify how to process the other lines in the file, and may initialize parametric data that is unit or type of asset specific variable. Further, config files provide origination, targeted region and era, licensing, author and contact information within the data set.
CSL lit. - 'Comma-separated list 
— Multiple lines of CSV in a file, so a list of CSVs.
CSV lit. - 'Comma-separated values'
In most contexts, CSV and CSL are equivalent forms of text files which have the ability to mix alphanumeric and numeric data that are usually formatted data records (in a data base sense) of some sort.—wherein one line contains mixed types of data elements.
Example: The usual example of a record is: names, street address, house and unit numbers, postal codes, phone numbers etc. in a address book type of 'record') divided by a text delimiting character, normally a comma.
  • Other character codes can be used to separate elements in such lists, but Trainz outputs CSL's of asset filename and kuids by cut buffer capture from the Content Manager Main View or Download Helper.
  • Further, CSV's that are all kuids is a valuable work around for the much asked for feature to have the ability to import and export the Pick List in Surveyor or CM, thus enabling and enhancing the ability to pre-select or work with a defined list of assets for the route building or session writing that is on the days agenda.
  • CSV lists, or CSLs are often used to port data from one computer application to another as a sort of 'Least common denominator' that virtually all technical software supports in some way. Hence CSLs can often be used to export data from one application to another which won't normally interface well because they are competing products.

For Examples, See references in Trainz.  

Da_to_Ez[edit]

DCC Mode-DCC Mode
(simulated) 'Digital Command Control'. The simpler (and easiest) of the two driving modes in Trainz with less realistic operating physics models.
  • The term 'DCC' comes from the world of model railways where DCC (digital command and control) chip sets automate railcar behaviors, but really applies to the 'dial type controllers used in electric powered Model Railroading, especially H.O. scale model trains retailed in department stores many are exposed to growing up.
  • In Trainz, the term refers to the Driver mode containing a simulated dial controller for the 'power pack' of a Model Railroad that will be somewhat familiar to anyone that has played with a typical (non-Lionel) electric model railroad such as H.O. Scale trainsets from toy & department stores, model shops and Model Railroading specialty stores (see e.g. Trainz.com).

 

TRAINZ RMBH+drag dropdown menu showing asset with Dependencies and Dependent Assets.jpg
DEM or Digital Elevation Map or Digital Elevation Model.
This refers to software generation of terrain of Trainz boards based on national digital data bases such as the USGS topological surveys.

 

Dependent relationships —see also
[[Trainz/concepts {{#replace:Dependent asset||_}}}|Dependent asset]]s and Dependencies
An asset which is required by another asset in order to make it operational is a dependency; the asset (which requires it such as a layout needing a crossing gate or building, track, etc.) is a dependent asset
Examples
  • CM's RMBHd dropdown menu 'View Dependent Assets' reports the crossing gate is used by five routes.
  • A 'dependency of a locomotive' will show it requires (amongst other things) an engine spec. The same asset when using 'View Dependent Assets' may list out 15-30 locomotives needing it be present.

 

DLS or Download Station.
N3V/Auran's huge repository of additional assets for Trainz, most of which has been created by interested third parties (3rd Party Content Creators) — the program's users.

 

Driver Command
A form of Trainz Rule effective only in sessions applying to (usually) a single AI Driver as an instruction (or sequence of such followed one after the other) which can be given to an AI train Driver in a Driver session.
  • Driver commands can be specified when the Session is created in Surveyor to give AI Drivers programming (task instructions), or by the user (to an 'assistant' AI Driver) when the Session is running.
  • In contrast, 'The Rule', "Driver Command" enables the session writer to control which Driver Commands are available in the session to command AI Driver actions.

 

engine-spec
slang but commonly used term meaning the details of how a locomotive behaves. Formally, locomotives are defined using the KIND Engine which is the exact meaning of what is meant by the term in many usages, but the meaning may also be to KIND Steam-engine definitions, and is often applied to containers and Kinds of component assets (dependencies which are independently defined and included by reference (kuids) in higher level assets.

  enumerated

meaning specifically specified, listed, pre-defined, and accepted values. A computer programing term when a constrained set of allowed values is meant and others will cause an error or unpredictable behavior.

 

Fa to Jz[edit]

FCT the Planet Auran 'First Class Ticket'.

An optional license sold by Auran/N3V's Simulator Central which provides unlimited-per-day downloading access to DLS with a much faster (up to 100 Mbps) FTP link than the normal free download speed (ca. x < 50 kbps) and its 100 Megabytes per day allowance restriction.
  DLS Way     Speeds     Data Limits
  No FCT     Slowish   Fd < 30–40 kbps   100 Megabytes daily limit; may be forced to wait for connections;
  FCT     'Guaranteed Fast'     Fd > 50–99 kbps     NO daily limit; priority connections to Server and DLS

 

Freeware
Trainz has a mighty tradition of Content Creators giving generously of their time and effort for the greater good by creating 'Freeware assets'. While access in most cases to good assets is liberal—Trainz content is not unprotected by copyrights, even though an asset is readily shared on the Download Station or other 3rd party Trainz Fan-sites without direct charges. Each asset also has a license tag inside it's config, which most often amounts to a Creative Commons-Share-Alike license of one degree or another. Many prohibit the use of the asset or any of it's components in any Payware, again a Creative Commons classed license. Some are fully copyrighted Payware only. Some is effectively unlicensed, but international law adjudges even those assets intellectual property, and under copyright protections. Bottom line, if you want to use a part of someone's creation as a basis for a new asset, A) obtain permission or don't upload it. B) You must credit those parts used with attribution to the owner.

 

GameScript
The programming language, based on "C" and using a *.gs or *.gse extension, used to create scenarios and script able assets for Trainz. This is not the same as TrainzScript, which is it's parent, before evolving into a more generalized and wide open computer language. TrainzScript is the technology that arrived in Trainz UTC which allowed semi-compiled 'scenarios' that are no longer supported past TS12.

 

Gmax
A third-party 'promotional' program distributed with Trainz 1.0–TRS2004, (bundled, but not freeware) which can be used to create 3D models for use in Trainz and other programs. Gmax and the copyrights thereto are now owned by Autodesk and the full up professional package 3dsMax 3D modeling, animation, and rendering software (Auran/N3V's choice in developer's software) is available for those with several thousand spare dollars to spend.[3]
  • Trainz went away from the limitations of Gmax during the TRS2004 era, converting to the newer more capable IM files standard where textures references can be embedded as part of the mesh index, unburdening the game engine in many respects. Monochromatic textures are represented by RGB values in a proper IM, for example, so one properly made won't generate the warning: "Warning: The texture 'texture name' is a uniform color." in content manager, and such assets load far faster and have less HDD and game memory overhead as well.

 

HOG or Hand Of God.
A utility and associate textures which can be used to import terrain data into Trainz.

 

HUD, or Head Up Display
That part of the screen which displays information such as your current speed.

 

IND
The standard Auran interactive industry system (which includes passenger stations).


 

Install or Installs
A Shorthand notation, meaning a setup for running Trainz software, especially in contexts relative to that version's root (main) folder in the local machine's folder hierarchy. Used here in the Wikibook as a reference to 'a particular Trainz version's 'root folder,' whatever version it may be. Many veteran Trainzer's keep more than one Trainz, and more than one Trainz setup— one with Payware and one without, for example, so assets which are illegal to copy to the DLS aren't mixed in with those that are. Similarly, many long time Trainzer's have more than one Trainz retail release around and up and running.

 

JA files
The standard Auran Compressed Asset Base (CAB system files (which includes all the built-in items of your Trainz release version). JA files are configured for rapid upload into the game and tightly organized. They may be ported version to version within certain limitations. TS09 JAs, TS10 JAs can be added to TS12's bag of tricks. TANE is expected to have similar capability, otherwise route and session assets that took many man-months to create would not be forward-compatible, a hallmark of Trainz since its earliest days.

 

Jet, Jet2, JET3
In the context of Trainz, the game engine developed by Auran and used by Trainz. Unrelated to the Microsoft Jet database system. TS10 and TS12 are said to be running the JET3 engine, which is as far as Auran/N3V can take a 32 bit graphics rendering engine.

 

Just Trains
The company which distributes Trainz in the UK. UK releases by law have to have CD/DVD in the drive locking DRM.

 

Ka to Lz[edit]

KIND - Kinds
The Trainz kind tag or keyword of the TrainzBaseSpec establishes the ground rules for parsing the rest of the terms contained in a Trainz config.txt file and therefore the software operations thereafter invoked in processing the whole data set (i.e. the whole folder contents including the asset's config.txt file) representing a virtual (asset) object.

 

KUID - <kuid:xxxxxx:yyyyyy>
lit. 'Koolthingz Unique IDentifier' - Trainz' unique database reference number for an asset, extended to track multiple versions in the KUID2 form. The heart and soul of Trainz upgradability, and modular design of assets, as each asset has it's own unique kuid code, so one can specify a component (bogeys) or entire Traincar from another, and selectively replace either in a new asset (re-skin or modified truck). Most Trainz assets specify list of dependencies in the mandatory kuid-table config entry—other component assets which are assembled by the various parts of the software suite to make up a renderable and useable asset in a kuid-container.
  • In the above, the xxxxxx represents a content builder's Auran identity number, so all assets by an author have that same code (some few have registered two or three). The 'yyyyyy' is the author's serial number for the assets. Trainz generally starts a new users first asset, normally a route he's cloned by modifying it with a subsequent save as 1001.
  • An author's kuids are not necessarily sequential, nor contiguous. Early in the Trainz era a kuid classification system was promulgated so that a CC's content had a base and range which created groups by type and identified by the number range which type of asset was indexed. This system is still in use today.

 

KUID2 - <kuid2:xxxxxx:yyyyyy:z>
A updated kuid with a built-in update tracking code; a modified version of the KUID format which allows a version number to be specified. A <kuid:xxx:yyy> is the same as saying <kuid2:xxx:yyy:0> (Zero revisions or version zero, meaning the original)
  • This allows data items (Trainz Assets) to carry an inherent version code for the asset, with a limit of 127 revisions. This will not generally match the Trainz-build code identifying the software technology levels, but indicates previous versions history.
  • Assets having a higher suffixed code in the KUID2 override or replace older assets, given both the assets in the data base. Having an early version is not necessary but CM will list the missing chain of revisions as missing dependencies, a software bug to those who resent the contamination of that facility in CM or 'feature' kept as is by the programmers, in any respect reducing the utility of using CM to identify what a user is missing, and causing users to spend time manually figuring out what is really what.

 

LARS
Logistics And Resource System, a commodity/freight transportation system for Trainz created by Lars Ljunberg. The forums at Auran and especially at TrainzProRoutes cover LARS in depth, and many DLS assets these days supports the conventions. The LARS system greatly expanded the variety and types of industrial products or loads available in the game milieu. Many LARS assets will include the LAR abbreviation, and can be reconfigured to incorporate additional product types with minimal config edits.

 

Layout
In the Trainz communities the terms layout and route are synonymous, but "map" is a Trainz Enumerated tag value, identifying a config as a Map Kind definition in a routes' config.txt file. The term 'Layout' is physical scale Model Railroading lingo for a Route.

 

Level crossing
See Mocrossing

 

.LM files or LM.txt files

.LM.txt files are INI files like .texture.txt files in that in the folder, both have the .txt extension and pass processing How-To to the Run time software on rendering the asset. For both, the config.txt 'call' or referencing line's quoted string value MUST NOT have the '.txt' extension—the extension is suppressed unknown reasons (perhaps for speed), and is clear to the parser by context; but if specified, will generate a fault in CM's validation of the asset's files.

  • Both are defacto include file types used by the run time GUIs and Trainz's Game engine (Auran JET && TANE's forthcoming) to build the asset with specific data elements predefined for that aspect of the model.
  • The file LM.txt files (See the link) set forth the programmable parameters of the LOD meshes.

 

..\libraries subfolder

The libraries folder holds the C-like TrainzScript languages standard include 'header' files referenced in user scripts. Asset Kinds, class organization and asset sub-types are closely intertwined in the world of scripted assets, as most rolling stock is now-a-days.

LMB
LMB - Left mouse button (implicit meaning a single click). This abbreviation is widely used in the Auran documentation and beginner's how-to. It is used here in tutorials the same way.

 

LMBH or LMBh
LMBH or LMBh - Left mouse button+Hold down. Usually as part of a drag to move or shape operation in Surveyor, or controls operations in Driver.

 

LMBH-d
LMBHd or LMBhd - Left mouse button+Hold down+Drag.
  • Variants of LMB actions will also sometimes include /pressing+holding the Shifting keys [CRTL] and [SHFT].

 

LOD
Level Of Detail. Trainz preferred and newest system of defining and displaying graphical object's meshes which displays more distant assets with less and less polygon mesh details (model vertices, so less calculations) just as the eye sees them.
  • Trainz versions currently support all three methods and are likely to continue doing so, but new highly detailed assets should be made with LOD technology while individual low poly mesh .IM technology should only be used for assets designed to be viewed at a distance.

 

Ma to Po[edit]

Five track Grade Crossing in Lawrence, MA at head end of a small yard. mainlines are to the right.
Triangular polygons make up most meshes in Trainz.
Merscom
The 3rd party licensed software publishing company which distributed many CDROM/DVD Trainz releases in the USA. Auran typically had a 3rd party company produce and distribute releases on a particular continent.

 

Mesh
(loose, slang, term of art) or more correctly a Polygon mesh: A 3D graphics object representing a mathematical model of a wire frame which when rendered as the visible face provide a virtual surface, on which virtual textures can be applied. Mesh surfaces and polygons are usually combinations of triangles.

   

Mocrossing (Motorcar crossings), Level crossing, Grade crossing
Also — 'most often' abbreviated Xing
Level crossing (US English: grade crossing). Mocrossings like "map" are a defined data (enumerated) type or Kind in Trainz, requiring mandatory definitions of child-tags and containers. (See Kinds).

 

Auran Paintshed
Paintshed.exe is a UTC/TRS2004 standalone asset repainting program that is mostly obsolescent that allowed users to take Gmax or Autodesk's 3dsMax generated mesh objects and in a process known as reskining and apply a different textures to the rolling stock assets faces, which it unwrapped and presented as if laid out in various pane views. This utility allowed a propagation of the number of available livery or heraldry types (appearances, color schemes) to be applied to the same basic widely available traincar classes as soon as someone developed the basic traincar. These class assets will appear in CM/CMP with a paintshed icon indicating there is a base skin covered by the overlying textures. This can sometimes be visibly seen when the game slows as it is redrawing a traincar, the first texture set is momentarily visible, then the paint job reskinned textures. Now dated, the same effects (reskinned assets) can be achieved through a number of manual processes using graphics software to modify the 'wrapping' texture.

 

Placeholder, placeholder parameter, or dummy parameter

All Trainz data is organized in key-word + data value pairs (see ACS Text Format), we call tags and data; at least until an aggregate data type is needed in association with such a key-word. These aggregate-types in Trainz are containers and kinds, and each has characteristic paired curly-braces ( '{' and '}' ) around the internal contents. Within, some key-words are enumerated types, and define particular parameters, others define sub-containers and many are commonly found (by convention) as 0 based number sequences after programming index practices. These are dummy parameters, where their place and order (hence placeholder) matter while their name does not.

For example, consider a short thumbnails container with two placeholder parameters 0, and 1:

thumbnails
{
  0
 {
   width 240
   height 180
   image "$Screenshot (240).jpg"
 }
 1
 {
   width 512
   height 512
   image "$Screenshot (512).jpg"
 }
}

In the above, within each thumbnail sub-container width, height and image identify keyword-data ACS Text Format data pairs. The outer key-word is paired with the whole container, but each subcontainer could be named anything (like 'a' or 'b' and 'first' or 'second' etc.), for it is not used in referencing the data. Hence it is a place-holder parameter, holding it's key-word 'rating' by how it's used, but not used as a handle to access the data itself. In short, such placeholder parameters are throw-aways in the internal processing of the data, and any non-white space string followed by the opening curly brace is all that the parsing software requires to further allocate and put away the values of the image, height and width parameters which have relationships to one another within such sub-containers (which are associated groups of data).  

Polycount
The number of polygons an assets has, which will largely determine its effect on Trainz' performance. The more polygons the computer has to calculate and draw in a given frame, the lower the display speed (frame rate. All the CM/CMPs have a RMBh+drag drop down menu with an entry that will give an assets polycount. Newer assets using LOD meshe sets dramatically reduce the number of drawn polygons and concurrent texture complexities the farther an object occurs, dropping needless calculations for mesh refinements one would never detect at such distances.

 

Pp to Sb[edit]

Product
Anything 'consumed or produced' by an Trainz industry, including passengers which are "consumed" and "produced" by Trainz passenger stations. There are whole families of products and interactive traincars to carry same to enhance the realism of Trainz operations. See TrainzProRoutes' LARS industries for example.
Profile
An 'enumerated value' in a Kind tag denoting a session asset config.txt file and beginning the typing of the related data definitions. This is the name (technical) assigned to the tag kind for a Driver session found in config.txt files.
  • Specifically, the enumerated string value "profile" given as the assigned parameter of the KIND kind tag in a config.txt file specifies that the asset is a Driver session and defines to the software that it should parse looking for other tags and containers within that ini file and data groups within the folder.
Prototypical
A layout or other feature which is intended to fairly accurately depict reality—opposite of a fantasy place or route which is a fictional or fanciful place or route. Full up accurate prototypical modeling is a painstaking and difficult taskmaster. Modeling well generally involves compromises between art and faithfulness to a set of prototypical places, such as trimming down a long distance to make driving more fun on the modeled route. The modeler may strive for accuracy or playability but in the event, not many will drive three hours ot get to the next interesting place, so a good balance is sought most often by the best modelers.

 

PTP or Pro Train Perfect
A European only version of TRS2006, the edition was published in Eastern Europe in a partnership arrangement with Third Party Content creators Blue Sky Interactive, a long established model railroad industry company; sometimes referred to as TRS2008 or TRS2007 (which others, more correctly, may mean the French, Italian, Greek, Spanish language release). Hence, Trainz PTP in English slang means the name under which a Eastern European Language version of TRS2006 was sold in Germany, Poland, Hungary, Russia, and other such Eastern European countries.

 

Rail Driver
A physical control panel manufactured by P.I. Engineering which can be attached to a computer and which mimics that of a real locomotive.

 

ride along
A Ride Along is one style session which does not require operation by the Human Intelligence Driver (You), but is written so everything is automated using the AI Drivers (A misnomer in the dialect of advertising hyperbole: 'Artificial Intelligence' Driver, the simulator, in other words following a script set up by the session writer.

 

RMB, Right Mouse Button
This abbreviation is widely used in the Auran documentation and throughout this document for a single right button click and release.
RMBH, Right Mouse Button and Hold
This abbreviation is widely used in the Auran documentation and throughout this document meaning hold the right mouse mouse button and hold.

 

RMBHd, Right Mouse Button and Hold while dragging
This abbreviation is widely used in the Auran documentation and throughout this document. Many auxiliary operations in Trainz, both in Surveyor and CM use right mouse button drop down menus.

 

RS Part
Rolling Stock Part. A dependency required by a rolling stock asset, such as a bogie (US English: truck), coupler, chassis, or body.

 

Rule
A command in a Driver session encapsulated in a little graphic rectangle with icons representing (fronting for) a re-entrant scriptlet. The scriptlet may be thought of as a subprogram, takes definitions when it needs to associate some route or consist element Test a state), or values such as scoring. The inclusion of Rules and their parameters is specified when a Driver Session is created in Surveyor, and in it's Session Editor.

 

Rule editing
Many Rules open an entry applet when 'edited' (Programmed or specified would be more accurate, but that's the Session editor button's label) after added to or when encountered in a Session sequence. The editing of a Rule is the session designer/editor's way to define parameters to pass into the runtime interface in the Driver GUI Module. See also: Session Editor, List of Driver Rules.

 

SAR, CSAR, GSAR
Computing Terms (Jargon)   lit.:  Search and Replace, (aka, 'Find and Replace'); and Conditional Search and Replace; variant GSAR for Global Search and Replace (An all or nothing SAR, far more risky that you may change something you shouldn't than searching and deciding one by one. Use REGEX to narrow risk significantly.
Junction Switch, switch-stand with Target, the grooved cross-over rail called a frog, and the hinged-tapered track-arm-and-tips called points.
A new Switch Motor on the Mainline x-over, former B&MRR now part of Pan-Am Rail / MBTA trackage, Lawrence, MA yard.
Aerial view of a switch yard in Chicago, Ill.
Notepad's Replace All is GSAR, Notepad++'s File Search and Replace can be, especially if no REGEX conditions are specified.

 

Sc to Sz[edit]

 

Scriptlet
GameScript coding associated with an asset such as a rolling stock item or an industry. Not all assets have scriptlets.

 

String (computing) or string value
Computer term using coding associated with an text standard. Various 'alphabets' code glyphs differently, but most English glyph symbols are representable by ASCII codes and the supersets of unicode which extends the symbols available.

 

String array (or string list)
Trainz uses several semi-colon delimited ASCII enumerated code sets rather than use separate variables. A good example is the category-region tag which takes paired enumerated country codes (possibly ISO two letter codes, or at least very similar) and which 'list' places where that asset might be appropriate. On point, today's (TS09 standards) category-region tag replaced individual tags such as category-region-0, category-region-1, category-region-2, category-region-nn on separate lines.

 

SP or Service Pack
A free software update to an applications program or operating system. Unlike most genre software (games) Trainz has both longevity and complexity so has had a long history of intermediate improvements and bug fixes after the user community thoroughly vetts a new release.

 

Switch or Junction switch (or points), turn-out and frogs
switch motors and/or switch levers.

A junction switch (model railroading's 'Turn out') is the selectable divergence or convergence of one line to two lines where the frog or points is shifted by a manual lever or throw lever at a switch stand and sometimes automated by a switch motor.

  • Switch levers may be indicating or not, meaning they show a different appearance when switched or unswitched—historically in many cases by a semaphore arm, or more often now, an trackside 'switch stand flag' (or target) or 'indicating light' before the junction.
  • A succession of switches forms a diverging ladder, which may or may not re-converge in a merging ladder on the opposite side of a switch yard (Also possibly known as a freight yard, classification yard, marshalling yard, transfer yard or sorting yard, depending upon the local countries railroading sub-culture).

 

Ta to Zz[edit]

   

TBS, KIND_TrainzBaseSpec, or 'The TrainzBaseSpec'
The Trainz Base Specification is a common set of data items which either may or in other items, must be specified to define any and every Trainz asset, including routes and sessions.

 

TDH or the Trainz Download Helper.
A sub-program of Trainz prior to TRS2006's CMP used to download and install additional assets. These tasks are now done in CM's TDH, which is one of the left pane drag and drop data management tools integrated into CM and CMP.

 

Texture files and texture.txt files
A source 2D image which can be wrapped about or applied to the sides of a 3D mesh 'virtual surface' is called a texture (see also: " Texture_mapping). The preferred file type for mapping textures in Trainz is the scalable raster graphics TARGA (TGA file) format, though BMP and JPEG file formats by extensions as textures are also supported.
  • The Dot-texture file's extensions (*.texture) often found when opening an asset for edit are composite binary files containing image processing header instructions and the graphics texture image. These are decodable into the texturename.texture.txt which holds imaging instructions (now editable and mutable once in .txt format) and it's associated source files (*.bmp, *.jpg, or *.tga) using the PEVtool Images2TGA.
  • Newer Trainz technologies utilize advanced mesh rendering-texture mapping techniques and feature instructions such as 'AlphaHint= statements' and other esoterica (unknown in the TRS-Trainz releases) but which have extended the Trainz graphics prettiness since added to the newer Trainz releases in other entries in texture.txt file type ini files.

 

Trainz Objectz
A third-party freeware asset management utility written by famed content creator tafweb (#1942, has 305 built-in items in TS12!) for TRS2004, which didn't have Content Manager Plus to manage asset file management duties. Trainz Objectz performed most of the data management functions for Trainz—TRS2004 releases. In 2005, CMP was integrated in TRS2006, which many believe to be modeled on Trainz Objects, and replaced much of it's functional utility in TR06 and up, but lack some of it's other nice features and capabilities. Now obsolete outside '04 installations. It can be found and downloaded at www.tafweb-trainz.co.uk/trainzobjectz.html#download[4]

 

Trainz Railways
The name used in the UK for the first (regionally released) Trainz Classics which bundled TRS2006 (no Sp, so V2.5) and TRS2004 and Trainz 1.3. Confusingly, Auran reused the title with Trainz Classics 1, 2, and 3 with post TRS2006-SP1 (v2.6) releases (V2.7, v2.7, v2.8)

 

Trainz Railwayz
The name used in the USA release for the original (regionally released) Trainz Classics. (See 'Trainz Railways' above.)

 

TADdaemon
'TADdaemon.exe' is a Trainz transactions manager that gates and manages reading and writing to the TAD (Trainz Asset Data Base) and runs in the background after launching in all versions after TS2010-SP0 and TS2009-SP3 which were under concurrent development. Among other things the TADdaemon allows multiplayer operations, running both CM and the runtime GUIs such as Surveyor (those two together rock!) at the same time (preventing the lock ups and crashes sometimes afflicting the TRS2006 family simulators doing the same dual mode operations).
  • The Launcher MenuOptions Button → Developer TAB → click box: "show data base process windows" will display the ongoings inside the TADdaemon, and this can sometimes be useful in troublshooting.

 

UTC or Trainz UTC
Trainz Ultimate Trainz Collection (v1.5)... An 3CD version of Trainz 1.3, with extra content CD's and PaintShed (v1.4), eventually superceded by TRS2004 (v2.0). UTC introduced Scenario's which later became the more generalized Sessions most commonly seen today. TS12 is the last Trainz release that will support Scenario loading.

 

Virtual Railroader ezine
'Virtual Railroader', under editor/publisher/Trainz-enthusiast Alfred Barten, was an important monthly ezine modeled on various Model Railroader magazines and the Kalmbach Model Railroading books specializing on How-to and informational articles on Trainz railroad simulators, simulator models, resources (prototyping information) and is still a valuable resource to experienced and beginning Trainzers alike. A must perusal for any with ambitions to build a route, or do any content creation![note 1]

Notes and References[edit]

Footnotes[edit]

  1. While editor Alfred Barten ceased monthly publication, the website continues to generate revenue and pay for itself and he intends to maintain the site active so long as his 70s+ health holds up. Per Email discourse with Fabartus, Summer-Winter of 2013, with permission to use contents in this effort as well.

References[edit]

  1. a b c Trainz UTC CDROM box art, 2003, Cosmi Finance, LLC, www.cosmi.com, accessdate=2014-0414
  2. Self-descriptions
  3. Autodesk's 3D modeling, animation, and rendering software from thier website††.
    Buy 3ds Max® 3D modeling, animation, simulation, and rendering solution
    Monthly $ 185 SRP† (Online store only) Quarterly $ 460 SRP† (Reseller only) Annually $ 1470 SRP†
    Choose online store or reseller
    Buy or upgrade
    Buy $ 3675 SRP† Upgrade $ 2575 SRP† Subscribe for $185/month or less
    † Suggested Retail Price SRP (i.e. List price) price / accessdate= 2014-0904 †† Source: Company's Buy Autodesk webpage
  4. www.tafweb-trainz.co.uk/ Site and Downloading validated and checked active summer 2013 -- Fabartus
←   Prev: [  references ]  — ↑Trainz   ]  —   Next: [   AM&C  ]   →
  Previous page: Trainz Next page:    
←    [ references  ] ⇐ Previous  Glossary    Next   ⇒   [ AM&C ]  →