MoveTo Action

This Node has different versions for Scenes and Scene2Ds. Find in the tabs below the documentation for both versions.

Scene

Overview

The MoveTo Action Node.

The MoveTo Action Node continuously modifies the Position of a Scene Object to the values specified in To for a given period of time, thus creating an Animation.

Furthermore, visit the Actions Nodes page for a general introduction to these Nodes, and Position for more detail about the Position Attribute.

Scope: Scene, Function, Prefab.

Attributes

The MoveTo Action Node Attributes.

Attribute	Type	Description
To	Vector3	The desired Position along the X, Y, Z axes, if none is received in the To Input Socket.
Duration (sec)	Float	The total time of the Action, if none is received in the Duration Input Socket.
Interpolation	Drop-down	The Interpolation method to use for calculating the intermediate values of the Position. It can be Linear, Sine Ease In, Sine Ease In Out, or Sine Ease Out.

Inputs

Input	Type	Description
Instance ID	InstanceID	The assigned Instance ID of the Action. If nothing is received, it automatically assigns 0 as the Instance ID.
(►) Start	Pulse	A standard Input Pulse, to trigger the execution of the Node.
Object ID	ObjectID	The ID of the target Object.
Duration	Float	The total time (in seconds).
To	Vector3	The desired final Position along the X, Y, Z axes.

Outputs

Output	Type	Description
Instance ID	InstanceID	The assigned Instance ID of the Action.
OnStart (►)	Pulse	Flows to the next Node following MoveTo Action when the Action starts.
OnEnd (►)	Pulse	Flows to the next Node following MoveTo Action when the Action stops.

Scene2D

Overview

The MoveTo Action Node.

The MoveTo Action Node continuously modifies the Position of an Scene2D Object to the values specified in To for a given period of time, thus creating an Animation.

Furthermore, visit the Actions Nodes page for a general introduction to these Nodes, and Position for more detail about the Position Attribute.

Scope: Scene, Function, Prefab.

Attributes

The MoveTo Action Node Attributes.

Attribute	Type	Description
To	Vector2	The desired Position along the X and Y axes, if none is received in the To Input Socket.
Duration (sec)	Float	The total time of the Action, if none is received in the Duration Input Socket.
Interpolation	Drop-down	The Interpolation method to use for calculating the intermediate values of the Position. It can be Linear, Sine Ease In, Sine Ease In Out, or Sine Ease Out.

Inputs

Input	Type	Description
Instance ID	InstanceID	The assigned Instance ID of the Action. If nothing is received, it automatically assigns 0 as the Instance ID.
(►) Start	Pulse	A standard Input Pulse, to trigger the execution of the Node.
Object ID	ObjectID	The ID of the target Object.
Duration	Float	The total time (in seconds).
To	Vector2	The desired final Position along the X and Y axes.

Outputs

Output	Type	Description
Instance ID	InstanceID	The assigned Instance ID of the Action.
OnStart (►)	Pulse	Flows to the next Node following MoveTo Action when the Action starts.
OnEnd (►)	Pulse	Flows to the next Node following MoveTo Action when the Action stops.

Example

This section shows a simple example of how to use the MoveTo Action Node and the effect it has on an Scene Object. This concept can be applied as well to a Scene2D Object.

We start by configuring the Scene, then build the Logic, and finally show the result.

Scene Configuration

We consider a Scene with two Objects: a red arc over a black background, both of which can be easily created in the Scene Outliner. Then, we set the Size Attribute of the arc to $(150, 150, 1)$. See this configuration in the following image:

Scene configuration.

Logic

We then need to configure the Logic. This is done in the Logic Editor.

We use the MoveBy Action Node with the following Attributes:

• To: $(150, 150, 0)$

• Duration (sec): $3$

• Interpolation: Linear

And we connect to it the Object Node of the red arc and a Pulse to the Start Input Socket. Thus, having the following Logic configuration:

Logic configuration.

Final result

Finally, the effect of the ScaleTo Action Node when triggered is the following:

Final result.

See Also

• MoveBy Action

External Links

• Position (geometry) on Wikipedia.