Attachment point - Revision history

Windwalkr: Windwalkr moved page Attachment Points to Attachment point

2017-10-11T09:44:23Z

Windwalkr moved page Attachment Points to Attachment point

← Older revision	Revision as of 09:44, 11 October 2017
(No difference)

Windwalkr at 10:07, 30 August 2017

2017-08-30T10:07:26Z

← Older revision		Revision as of 10:07, 30 August 2017
Line 1:		Line 1:
	~~Attachments are~~ the ~~means of specifying how sub meshes or~~ other ~~effects are placed or attached~~ in a ~~model.~~		Each mesh file may have zero or more attachment points, which can be used within the game to identify a specific position and orientation in 3D space relative to the mesh. Attachment point names should be prefixed with "a." (eg. "a.light") to avoid confusion with other nodes in the scene hierarchy. Attachment points may be used for a number of purposes, including:

			* From within a [[config.txt file]], to identify where a specific effect is to be attached to a mesh.
			* From within a [[config.txt file]] mesh-table element when attaching to a parent mesh, to specify where on the parent mesh the origin of the child mesh will attach.
			* From within the game code, as one of the [[Vehicle Attachment Points]] predefined for use in Trainz.
			* From within an asset's script for various purposes.

	~~=Attachments=~~		Please note that it is not recommended to use a single attachment point for multiple unrelated purposes, as the game may adjust the exact function of the attachment point to suit its actual use. If two different usages would apply different semantics to the attachment point, the result is undefined. For example, attempting to play a sound or particle effect at a reserved "a.bog0" attachment point might cause the desired effect to fail if the bogey is not visible.
	An attachment point ~~is located in~~ the ~~model and reference is made from~~ the ~~[[Config~~.~~txt_file\|config~~.~~txt]] file~~, to ~~define its use and function~~.

	Attachment points use the '''a.name''' convention, to be recognised in Trainz. For an attachment point to move with an animated dummy, there is a special naming convention for the point in 3dsmax, e.g. '''a.r.dummy/a.name'''.		Attachment points may be present in the root of the mesh file, or may be a child of a sub-node such as an animated bone.

	~~Attachment points should~~ be ~~created~~ in ~~top view, and~~ the ~~orientation~~ of the ~~axis will then be consistent. Sometimes the attachment point~~ may ~~not~~ be facing the correct direction, and has to be rotated (realigned). Refer to other sections for advice on any special orientation required for different attachment points, for track, names, bogeys, coupler points and effects.

	~~'''a.bog''', '''a.limfront''' and '''~~a~~.limback''' are some~~ of ~~the important attachments for rollingstock models. As these have specific placements, it may be helpful to save~~ a ~~file of these points~~ as ~~a template, so you can merge it with your next model. With a few adjustments, you can quickly incorporate the template into the model and be sure the point names and orientation are correct~~.


Line 41:		Line 40:
	The next step is to open each 3dsmax file you have just created (of the movable objects), and move the object to 0,0,0 and make the rotational values 0,0,0 (press and right click these 3dsmax icons). This makes the object (and it’s pivot) aligned correctly to the origin of the scene.		The next step is to open each 3dsmax file you have just created (of the movable objects), and move the object to 0,0,0 and make the rotational values 0,0,0 (press and right click these 3dsmax icons). This makes the object (and it’s pivot) aligned correctly to the origin of the scene.

	~~Now is the time to export the object to a Trainz mesh file (.im).~~

	~~=Naming=~~

	==~~Moving attachment points for other models~~==		==Animated Attachment Points in IM==
	~~Attachments use~~ the '''a.name''' ~~convention and allow the attachment of a submesh to a specific point in a mesh~~. If the attachment point in the main mesh is to move with an animation of that mesh, the special naming convention above must be used for the point to follow the animation, and allow the submesh to then follow the point.
			For an attachment point in an [[IM file]] to move with an animated dummy, there is a special naming convention for the point in 3dsmax, e.g. '''a.r.dummy/a.name'''.

			If the attachment point in the main mesh is to move with an animation of that mesh, the special naming convention above must be used for the point to follow the animation, and allow the submesh to then follow the point.
	For example, a submesh is to be attached to a main mesh using the attachment name '''a.lever'''. This attachment point in the main mesh must be linked to a helper point called '''b.r.pivot''', that is animated.		For example, a submesh is to be attached to a main mesh using the attachment name '''a.lever'''. This attachment point in the main mesh must be linked to a helper point called '''b.r.pivot''', that is animated.
	The attachment point in the 3dsmax model must be named '''a.r.pivot/a.lever'''. In the [[Config.txt_file\|config.txt]] file the attachment point will be entered as '''a.lever'''. Note the helper point in 3dsmax will be called '''b.r.pivot''', '''not a.r.pivot'''!		The attachment point in the 3dsmax model must be named '''a.r.pivot/a.lever'''. In the [[Config.txt_file\|config.txt]] file the attachment point will be entered as '''a.lever'''. Note the helper point in 3dsmax will be called '''b.r.pivot''', '''not a.r.pivot'''!
	The submesh will now follow any animation in the main mesh. It can be useful for moving coronas, and animated nightwindow meshs.		The submesh will now follow any animation in the main mesh. It can be useful for moving coronas, and animated nightwindow meshs.

	==~~Level Of Detail Meshes~~==
	~~From~~ a ~~'''~~.lm.txt~~''' configuration~~ file:		=Animated Attachment Points in FBX=
			Animated Attachment points in [[FBX file]]s do not require a name prefix. The standard "a.name" convention is used. The parent bone is determined by the attachment point's parent node in the scene hierarchy.

			=LM.txt Attachment Culling=
			The [[LM.txt file]] LOD format allows attachments to be culled at a fixed distance from the camera. There are two requirements for this technique.

			1. The following line must be added in the [[LM.txt file]] with the value tuned to the appropriate "fraction of screen space" at which to cull the attachment point(s):
	attachmentCutOff = 0.1;		attachmentCutOff = 0.1;
	~~Attachment cutoff specifies the level where attachments with the flag ''':Cull''' are dropped.~~

	~~ie To stop drawing the bogeys of the trains at a specific level of detail, append '''~~:Cull~~'''~~ to ~~the bogie~~ attachment point. ~~(ie '''a~~.~~bog0:Cull''' )~~		2. A ":Cull" suffix (case insensitive) must be added to any attachment point name which is to be dropped. This suffix should be kept consistent across all sub-meshes which comprise the LM mesh.


	~~Where~~ the ~~above applies~~ (~~bogeys culled~~) ~~the~~ body mesh ~~will~~ need a low poly representation of the bogeys.		For example, to stop drawing the bogeys of a train vehicle at a specific level of detail, append ''':Cull''' to the bogie attachment point. (ie '''a.bog0:Cull''' ) The body mesh may need a low poly representation of the bogeys to be burned in at this detail level to avoid an obvious change in the mesh's silhouette. Note that many meshes (eg. animated fans) can be dropped without needing an alternative to be burned in due to their positioning and lack of effect on the silhouette.


	~~==Special Attachment Points==~~
	~~A number of [[Vehicle Attachment Points]] are reserved for predefined use in Trainz.~~

	[[Category:Modeling]]		[[Category:Modeling]]

Mjolnir: /* 3D Studio Max Guidelines */

2017-04-06T08:20:58Z

3D Studio Max Guidelines

← Older revision		Revision as of 08:20, 6 April 2017
Line 28:		Line 28:
	[[image:3dsmaxpivotpoint.jpg]]		[[image:3dsmaxpivotpoint.jpg]]

	Be aware that the point itself must be rotated correctly, not the axis of the point. The '''~~Hirerachy~~'''...'''Affect Pivot Only''' option may be turned on to determine the orientation of the point, it must then be turned off before rotating the point (click on the Affect Pivot Only box to toggle on/off). Turn on the axis information again to verify the rotation of the point has been done correctly.		Be aware that the point itself must be rotated correctly, not the axis of the point. The '''Hierachy'''...'''Affect Pivot Only''' option may be turned on to determine the orientation of the point, it must then be turned off before rotating the point (click on the Affect Pivot Only box to toggle on/off). Turn on the axis information again to verify the rotation of the point has been done correctly.

	Once the pivot points have been set for all your new objects, now is the time to start adding attachment points. Add these through the 3dsmax create panel (see image below). Remember to use the '''a.name''' naming convention. Attachment points are simply points in 3D space where another mesh can inserted (through [[Config.txt_file\|config.txt]] reference).		Once the pivot points have been set for all your new objects, now is the time to start adding attachment points. Add these through the 3dsmax create panel (see image below). Remember to use the '''a.name''' naming convention. Attachment points are simply points in 3D space where another mesh can inserted (through [[Config.txt_file\|config.txt]] reference).
Line 42:		Line 42:

	Now is the time to export the object to a Trainz mesh file (.im).		Now is the time to export the object to a Trainz mesh file (.im).


	=Naming=		=Naming=

Retro00064: /* Special Attachment Points */ added Category:Modeling.

2011-09-03T23:57:17Z

Special Attachment Points: added Category:Modeling.

← Older revision		Revision as of 23:57, 3 September 2011
Line 64:		Line 64:
	==Special Attachment Points==		==Special Attachment Points==
	A number of [[Vehicle Attachment Points]] are reserved for predefined use in Trainz.		A number of [[Vehicle Attachment Points]] are reserved for predefined use in Trainz.

			[[Category:Modeling]]

Windwalkr (legacy 2550) at 09:34, 25 March 2010

2010-03-25T09:34:44Z

Windwalkr: 1 revision

2010-02-03T13:58:24Z

1 revision

← Older revision	Revision as of 13:58, 3 February 2010
(No difference)

Windwalkr: /* Special Attachment Points */

2008-11-25T03:18:16Z

Special Attachment Points

New page

Attachments are the means of specifying how sub meshes or other effects are placed or attached in a model.

=Attachments=
An attachment point is located in the model and reference is made from the [[Config.txt_file|config.txt]] file, to define its use and function.

Attachment points use the '''a.name''' convention, to be recognised in Trainz. For an attachment point to move with an animated dummy, there is a special naming convention for the point in 3dsmax/gmax, e.g. '''a.r.dummy/a.name'''.

Attachment points should be created in top view, and the orientation of the axis will then be consistent. Sometimes the attachment point may not be facing the correct direction, and has to be rotated (realigned). Refer to other sections for advice on any special orientation required for different attachment points, for track, names, bogeys, coupler points and effects.

'''a.bog''', '''a.limfront''' and '''a.limback''' are some of the important attachments for rollingstock models. As these have specific placements, it may be helpful to save a file of these points as a template, so you can merge it with your next model. With a few adjustments, you can quickly incorporate the template into the model and be sure the point names and orientation are correct.

=3D Studio Max Guidelines=
In 3dsmax & gmax: ‘Create’ tab, ‘Helpers’, ‘Point’.

[[Image:attachmentpointcreation.jpg]]

To maintain correct alignment, attachment points should be created in the TOP viewport. The front end of the train body should be on the Left hand side when displayed in the RIGHT viewport in 3dsmax/gmax (ie, in TOP view, the loco should face down the page).

Any object in the scene that has to move (ie. levers and dials), or animate, will need to be ‘detached’ from the main model. To do this, select the polygons or elements you want detached and through the 3dsmax modify panel, press the detach button and name the new object.

To make life a heck of a lot easier later on, it pays to move the pivot point of each new object to it’s logical position. Ie. For needles and levers the pivot point should be the centre of rotation (with the rotation around the Z axis). Align lever shaft in the Positive Y direction.

To do this, access the 3dsmax Hierarchy panel, and press Affect Pivot Only. From here you can centre and align the pivot to the object and move it to the preferred
location.

[[image:3dsmaxpivotpoint.jpg]]

Be aware that the point itself must be rotated correctly, not the axis of the point. The '''Hirerachy'''...'''Affect Pivot Only''' option may be turned on to determine the orientation of the point, it must then be turned off before rotating the point (click on the Affect Pivot Only box to toggle on/off). Turn on the axis information again to verify the rotation of the point has been done correctly.

Once the pivot points have been set for all your new objects, now is the time to start adding attachment points. Add these through the 3dsmax create panel (see image below). Remember to use the '''a.name''' naming convention. Attachment points are simply points in 3D space where another mesh can inserted (through [[Config.txt_file|config.txt]] reference).

Since you have already worked out the pivot points of all your objects, all you have to do is align the attachment points to your object pivot points. Press the icon (above) and select the object to align to....

These attachments are exported as part of the default mesh (or the main mesh). Objects for attachment must not be included in the export as they are each exported from their own 3dsmax files and attached to the default mesh separately (through [[Config.txt_file|config.txt]] reference).

''Remember to save a backup of the 3dsmax file!!'' Select each object from the scene and save each one as its own 3dsmax file, (command panel, file - save selected). You may delete the object from the main mesh scene after you save it.

[[Image:3dsmaxmoveandrotate.jpg]]
The next step is to open each 3dsmax file you have just created (of the movable objects), and move the object to 0,0,0 and make the rotational values 0,0,0 (press and right click these 3dsmax icons). This makes the object (and it’s pivot) aligned correctly to the origin of the scene.

Now is the time to export the object to a Trainz mesh file (.im).

=Naming=

==Moving attachment points for other models==
Attachments use the '''a.name''' convention and allow the attachment of a submesh to a specific point in a mesh. If the attachment point in the main mesh is to move with an animation of that mesh, the special naming convention above must be used for the point to follow the animation, and allow the submesh to then follow the point.
For example, a submesh is to be attached to a main mesh using the attachment name '''a.lever'''. This attachment point in the main mesh must be linked to a helper point called '''b.r.pivot''', that is animated.
The attachment point in the 3dsmax/gmax model must be named '''a.r.pivot/a.lever'''. In the [[Config.txt_file|config.txt]] file the attachment point will be entered as '''a.lever'''. Note the helper point in 3dsmax/gmax will be called '''b.r.pivot''', '''not a.r.pivot'''!
The submesh will now follow any animation in the main mesh. It can be useful for moving coronas, and animated nightwindow meshs.

==Level Of Detail Meshes==
From a '''.lm.txt''' configuration file:
attachmentCutOff = 0.1;
Attachment cutoff specifies the level where attachments with the flag ''':Cull''' are dropped.

ie To stop drawing the bogeys of the trains at a specific level of detail, append ''':Cull''' to the bogie attachment point. (ie '''a.bog0:Cull''' )

Where the above applies (bogeys culled) the body mesh will need a low poly representation of the bogeys.

==Special Attachment Points==
A number of [[Vehicle Attachment Points]] are reserved for predefined use in Trainz.

← Older revision		Revision as of 09:34, 25 March 2010
Line 5:		Line 5:
	An attachment point is located in the model and reference is made from the [[Config.txt_file\|config.txt]] file, to define its use and function.		An attachment point is located in the model and reference is made from the [[Config.txt_file\|config.txt]] file, to define its use and function.

	Attachment points use the '''a.name''' convention, to be recognised in Trainz. For an attachment point to move with an animated dummy, there is a special naming convention for the point in 3dsmax~~/gmax~~, e.g. '''a.r.dummy/a.name'''.		Attachment points use the '''a.name''' convention, to be recognised in Trainz. For an attachment point to move with an animated dummy, there is a special naming convention for the point in 3dsmax, e.g. '''a.r.dummy/a.name'''.

	Attachment points should be created in top view, and the orientation of the axis will then be consistent. Sometimes the attachment point may not be facing the correct direction, and has to be rotated (realigned). Refer to other sections for advice on any special orientation required for different attachment points, for track, names, bogeys, coupler points and effects.		Attachment points should be created in top view, and the orientation of the axis will then be consistent. Sometimes the attachment point may not be facing the correct direction, and has to be rotated (realigned). Refer to other sections for advice on any special orientation required for different attachment points, for track, names, bogeys, coupler points and effects.
Line 13:		Line 13:

	=3D Studio Max Guidelines=		=3D Studio Max Guidelines=
	In 3dsmax ~~& gmax~~: ‘Create’ tab, ‘Helpers’, ‘Point’.		In 3dsmax: ‘Create’ tab, ‘Helpers’, ‘Point’.

	[[Image:attachmentpointcreation.jpg]]		[[Image:attachmentpointcreation.jpg]]

	To maintain correct alignment, attachment points should be created in the TOP viewport. The front end of the train body should be on the Left hand side when displayed in the RIGHT viewport in 3dsmax~~/gmax~~ (ie, in TOP view, the loco should face down the page).		To maintain correct alignment, attachment points should be created in the TOP viewport. The front end of the train body should be on the Left hand side when displayed in the RIGHT viewport in 3dsmax (ie, in TOP view, the loco should face down the page).

	Any object in the scene that has to move (ie. levers and dials), or animate, will need to be ‘detached’ from the main model. To do this, select the polygons or elements you want detached and through the 3dsmax modify panel, press the detach button and name the new object.		Any object in the scene that has to move (ie. levers and dials), or animate, will need to be ‘detached’ from the main model. To do this, select the polygons or elements you want detached and through the 3dsmax modify panel, press the detach button and name the new object.
Line 49:		Line 49:
	Attachments use the '''a.name''' convention and allow the attachment of a submesh to a specific point in a mesh. If the attachment point in the main mesh is to move with an animation of that mesh, the special naming convention above must be used for the point to follow the animation, and allow the submesh to then follow the point.		Attachments use the '''a.name''' convention and allow the attachment of a submesh to a specific point in a mesh. If the attachment point in the main mesh is to move with an animation of that mesh, the special naming convention above must be used for the point to follow the animation, and allow the submesh to then follow the point.
	For example, a submesh is to be attached to a main mesh using the attachment name '''a.lever'''. This attachment point in the main mesh must be linked to a helper point called '''b.r.pivot''', that is animated.		For example, a submesh is to be attached to a main mesh using the attachment name '''a.lever'''. This attachment point in the main mesh must be linked to a helper point called '''b.r.pivot''', that is animated.
	The attachment point in the 3dsmax~~/gmax~~ model must be named '''a.r.pivot/a.lever'''. In the [[Config.txt_file\|config.txt]] file the attachment point will be entered as '''a.lever'''. Note the helper point in 3dsmax~~/gmax~~ will be called '''b.r.pivot''', '''not a.r.pivot'''!		The attachment point in the 3dsmax model must be named '''a.r.pivot/a.lever'''. In the [[Config.txt_file\|config.txt]] file the attachment point will be entered as '''a.lever'''. Note the helper point in 3dsmax will be called '''b.r.pivot''', '''not a.r.pivot'''!
	The submesh will now follow any animation in the main mesh. It can be useful for moving coronas, and animated nightwindow meshs.		The submesh will now follow any animation in the main mesh. It can be useful for moving coronas, and animated nightwindow meshs.