X3DObject.LocalTranslation

Introduced

v3.5.1

Description

Returns or sets the object's local translation. This acts as a shortcut to accessing the translation SIVector3 through Kinematics, local KinematicState, and SITransformation.

C# Syntax

// get accessor
Object rtn = X3DObject.LocalTranslation;
// set accessor
X3DObject.LocalTranslation = Object;

Examples

1. JScript Example

/*
	This example illustrates how to get/set the local translation using two 
	different approaches
*/
NewScene( null, false );
var oNull1 = Application.ActiveSceneRoot.AddNull();
oNull1.posx.Value = 45;
var oNull2 = Application.ActiveSceneRoot.AddNull();
oNull2.posx.Value = 19;
// ACCESSING
// Access the local translation using the KinematicState
var oTransform = oNull1.Kinematics.Local.Transform;
var oTranslation = oTransform.Translation;
// Access the local translation using X3DObject.LocalTranslation
var oTranslation2 = oNull2.LocalTranslation;
Application.LogMessage( "Null1 pos x - " + oTranslation.X );
Application.LogMessage( "Null2 pos x - " + oTranslation2.X );
// SETTING
// Set the translation using the KinematicState
oTransform.SetTranslationFromValues( 2.0, 1.0, 0.0 );
oNull1.Kinematics.Local.Transform = oTransform;
// Set the translation using X3DObject.LocalTranslation
oTranslation2.Set( 2.0, 1.0, 0.0 );
oNull2.LocalTranslation = oTranslation2;
// Expected results:
//INFO : Null1 pos x - 45
//INFO : Null2 pos x - 19

2. VBScript Example

' 
' This example illustrates how to get/set local translation using
' two different approaches
' 
set oNull1 = Application.ActiveSceneRoot.AddNull()
set oNull2 = Application.ActiveSceneRoot.AddNull()
' ACCESSING
' Access the local translation using the KinematicState
set oTransform = oNull1.Kinematics.Local.Transform
set oTranslation = oTransform.Translation
' Access the local translation using X3DObject.LocalTranslation
set oTranslation2 = oNull2.LocalTranslation
' SETTING
' Set the local translation using the KinematicState
oTransform.SetTranslationFromValues 2.0, 1.0, 0.0
oNull1.Kinematics.Local.Transform = oTransform
' Set the local translation using X3DObject.LocalTranslation
oTranslation2.Set 2.0, 1.0, 0.0
oNull2.LocalTranslation = oTranslation2