Vehicle Attachment Points

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(Automatic driver placement.)
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
These are ''points'' in 3D space giving information on various aspects of the train as follows:
+
These are [[Attachment Points]] in 3D space giving information on various aspects of the train. Attachment Points with these reserved names should be used only for the purposes specified here. You should not attempt to re-use the attachments for other purposes, as behaviours beyond those described here may differ between Trainz builds.
  
 
=Special Points=
 
=Special Points=
Line 15: Line 15:
  
 
==a.bog0==
 
==a.bog0==
* Front bogey attachment
+
* Front bogey attachment.
* Used for positioning the train on the track
+
* Used for positioning the train on the track.
* Positioned at absolute centre of front bogey
+
* Positioned at absolute centre of front bogey.
* Must be on the forward side of the origin (a.limfront side)
+
* Must be on the forward side of the origin (a.limfront side.)
 +
* Must match an actual physical bogey placement that the user can see. This should not be used as a placeholder for non-bogey purposes.
  
 
==a.bog1==
 
==a.bog1==
* Rear bogey attachment
+
* Rear bogey attachment.
* Used for positioning the train on the track
+
* Used for positioning the train on the track.
* Positioned at absolute centre of rear bogey
+
* Positioned at absolute centre of rear bogey.
* Must be on the rearward side of the origin (a.limback side)
+
* Must be on the rearward side of the origin (a.limback side.)
 +
* Must match an actual physical bogey placement that the user can see. This should not be used as a placeholder for non-bogey purposes.
  
 
==a.bog (2, 3, etc)==
 
==a.bog (2, 3, etc)==
* Any other bogey attachments
+
* Any other bogey attachments.
 +
* Must match an actual physical bogey placement that the user can see. This should not be used as a placeholder for non-bogey purposes.
  
 
==a.exhaust (0, 1, etc..)==
 
==a.exhaust (0, 1, etc..)==
* Smoke generator attachments (where needed)
+
* Smoke generator attachments (where needed.)
 +
 
 +
==a.ditch* (0, 1, etc..)==
 +
* Ditch lights '''a.ditch0''', '''a.ditch2''' The odd numbered light points flash together, alternating with the even numbered light points.
  
 
==a.light* (0, 1, etc..)==
 
==a.light* (0, 1, etc..)==
* Light “corona” attachments. On a locomotive use '''a.light0''', '''a.light2''' (even numbers) for the forward lights, and '''a.light1''', '''a.light3''' (odd numbers) for the rear lights. Thsi allows the correct lights to show depending on running direction.
+
 
 +
* Attachment points for locomotive headlights.  
 +
 
 +
* These must be numbered consecutively starting with a.light0 which can be at front or rear. Attachments fore of the origin will display when the loco 'heading' is set to forward. Attachments aft of the origin will display when the heading is reversed. For simplicity it's good practise to use e.g. a.light0 and a.light1 at the front and a.light2 and a.light3 at rear though this is not critical as long as they are numbered consecutively.
 +
 
 +
* For all headlight points (front and rear) the Y axis points toward the loco rear.
 +
 
 +
* If you only want a light on the rear of the vehicle place a.light0 at the rear.
  
 
==a.cabfront==
 
==a.cabfront==
* Attachment point for the front cabin of a loco
+
* Attachment point for the front cabin of a loco.
* Located at the centre of cabin
+
* Located at the centre of cabin.
  
 
==a.cabback==
 
==a.cabback==
Line 45: Line 58:
  
 
==a.pant (0, 1, etc..)==
 
==a.pant (0, 1, etc..)==
* Attachment point for pantographs (where needed, i.e. Electric locos)
+
* Attachment point for pantographs (where needed, i.e. Electric locos.)
  
 
==a.driver (0, 1, etc..)==
 
==a.driver (0, 1, etc..)==
* Attachment point for driver mesh (0 is used for the first driver, 1 for the second driver in dual cab for instance). Currently, only '''a.driver''' 0 is supported.  
+
* Attachment point for driver mesh (0 is used for the first driver, 1 for the second driver in dual cab for instance.) Currently, only '''a.driver0''' is supported.  If this attachment point exists in the mesh but is not used for an attached mesh in the asset's config.txt file, then the driver selected by the user in Driver mode will be placed at this attachment point.
  
 
==a.outsideview (0, 1, etc..)==
 
==a.outsideview (0, 1, etc..)==
 
* These are located external of the loco body mesh.
 
* These are located external of the loco body mesh.
 
* The camera is positioned to face the negative Y direction of the attachment.
 
* The camera is positioned to face the negative Y direction of the attachment.
* Toggled using [ and ] using the internal camera mode after default interior camera view(s).
+
* Toggled using [ and ] using the internal camera mode after default interior camera views.
  
 
==a.r.pivot/a.lever (sample names used only)==
 
==a.r.pivot/a.lever (sample names used only)==
Line 61: Line 74:
 
==a.whistle==
 
==a.whistle==
 
* Attachment point for particle effects being emitted when the whistle key is pressed.
 
* Attachment point for particle effects being emitted when the whistle key is pressed.
 +
 +
==a.couple0==
 +
* Front attachment point for ACS couplers, location is (0,Y,0) where Y is 0.46 metres inboard of "a.limfront".
 +
 +
==a.couple1==
 +
* Rear attachment point for ACS couplers, location is (0,Y,0) where Y is 0.46 metres inboard of "a.limback".

Latest revision as of 07:49, 1 October 2019

These are Attachment Points in 3D space giving information on various aspects of the train. Attachment Points with these reserved names should be used only for the purposes specified here. You should not attempt to re-use the attachments for other purposes, as behaviours beyond those described here may differ between Trainz builds.

Contents

[edit] Special Points

[edit] a.limfront

  • Marks the front of the train, used for coupling
  • Should be roughly the same distance from origin as a.limback
  • Bogeys can be further forward than a.limfront if desired
  • Determines the forward headlight position
  • Height above origin (or Z) = 0.89m (2’ 10.8”)

[edit] a.limback

  • Marks the rear of the train, used for coupling
  • See a.limfront
  • Height above origin (or Z) = 0.89m (2’ 10.8”)

[edit] a.bog0

  • Front bogey attachment.
  • Used for positioning the train on the track.
  • Positioned at absolute centre of front bogey.
  • Must be on the forward side of the origin (a.limfront side.)
  • Must match an actual physical bogey placement that the user can see. This should not be used as a placeholder for non-bogey purposes.

[edit] a.bog1

  • Rear bogey attachment.
  • Used for positioning the train on the track.
  • Positioned at absolute centre of rear bogey.
  • Must be on the rearward side of the origin (a.limback side.)
  • Must match an actual physical bogey placement that the user can see. This should not be used as a placeholder for non-bogey purposes.

[edit] a.bog (2, 3, etc)

  • Any other bogey attachments.
  • Must match an actual physical bogey placement that the user can see. This should not be used as a placeholder for non-bogey purposes.

[edit] a.exhaust (0, 1, etc..)

  • Smoke generator attachments (where needed.)

[edit] a.ditch* (0, 1, etc..)

  • Ditch lights a.ditch0, a.ditch2 The odd numbered light points flash together, alternating with the even numbered light points.

[edit] a.light* (0, 1, etc..)

  • Attachment points for locomotive headlights.
  • These must be numbered consecutively starting with a.light0 which can be at front or rear. Attachments fore of the origin will display when the loco 'heading' is set to forward. Attachments aft of the origin will display when the heading is reversed. For simplicity it's good practise to use e.g. a.light0 and a.light1 at the front and a.light2 and a.light3 at rear though this is not critical as long as they are numbered consecutively.
  • For all headlight points (front and rear) the Y axis points toward the loco rear.
  • If you only want a light on the rear of the vehicle place a.light0 at the rear.

[edit] a.cabfront

  • Attachment point for the front cabin of a loco.
  • Located at the centre of cabin.

[edit] a.cabback

  • Attachment point for the rear cabin of a loco. Use this for dual cab locomotives.
  • Located at the centre of cabin
  • Front/back cab toggled using the ‘Alt C’ key when using the internal camera mode.

[edit] a.pant (0, 1, etc..)

  • Attachment point for pantographs (where needed, i.e. Electric locos.)

[edit] a.driver (0, 1, etc..)

  • Attachment point for driver mesh (0 is used for the first driver, 1 for the second driver in dual cab for instance.) Currently, only a.driver0 is supported. If this attachment point exists in the mesh but is not used for an attached mesh in the asset's config.txt file, then the driver selected by the user in Driver mode will be placed at this attachment point.

[edit] a.outsideview (0, 1, etc..)

  • These are located external of the loco body mesh.
  • The camera is positioned to face the negative Y direction of the attachment.
  • Toggled using [ and ] using the internal camera mode after default interior camera views.

[edit] a.r.pivot/a.lever (sample names used only)

  • Special naming convention for attachment points that are to move with the animation of the asset.
  • Refer to the CCG for information.

[edit] a.whistle

  • Attachment point for particle effects being emitted when the whistle key is pressed.

[edit] a.couple0

  • Front attachment point for ACS couplers, location is (0,Y,0) where Y is 0.46 metres inboard of "a.limfront".

[edit] a.couple1

  • Rear attachment point for ACS couplers, location is (0,Y,0) where Y is 0.46 metres inboard of "a.limback".
Personal tools