## 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