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