# MoveBy Action

## Overview

![The MoveBy Action Node.](https://4267723012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEts3pBau6LMamSYhGZp%2Fuploads%2Fgit-blob-affa64e482148060f07ce58d14c73d898ecde495%2Fmovebyactionupdatedimage.png?alt=media)

The **MoveBy Action Node** continuously modifies the `Position` of an [**Object**](https://docs.incari.com/incari-studio/2022.2/objects-and-types/scene-objects) by the values specified in `Offset` for a given period of time, thus creating an **Animation**. Find an [example](#example) of how to use this **Node** and its effect over an **Object** at the end of this page.

Furthermore, visit the [**Actions Nodes**](https://docs.incari.com/incari-studio/2022.2/toolbox/actions) page for a general introduction to these **Nodes**, and [**Position**](https://docs.incari.com/incari-studio/2022.2/objects-and-types/attributes/common-attributes/transformation#position) for more detail about the `Position` **Attribute**.

[**Scope**](https://docs.incari.com/incari-studio/2022.2/overview#scopes): **Scene**, **Function**, **Prefab**.

## Attributes

![The MoveBy Action Node Attributes.](https://4267723012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEts3pBau6LMamSYhGZp%2Fuploads%2Fgit-blob-670d98f05107169c3ec02c45519f01f52f10793c%2Fmovebyactionattributes.png?alt=media)

| Attribute        | Type          | Description                                                                                                                                                                                                                                                                                                                                 |
| ---------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Offset`         | **Vector3**   | The amount to modify the `Position` of an **Object** along the X, Y, Z axes, if none is given in the `Offset` **Input Socket**.                                                                                                                                                                                                             |
| `Duration (sec)` | **Float**     | The total time of the **Action**, if none is given 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*](https://en.wikipedia.org/wiki/Linear_interpolation), [*Sine Ease In*](https://easings.net/#easeInSine), [*Sine Ease In Out*](https://easings.net/#easeInOutSine), or [*Sine Ease Out*](https://easings.net/#easeOutSine). |

## Inputs

| Input         | Type           | Description                                                                                                                                                                                               |
| ------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Instance ID` | **InstanceID** | The assigned [**Instance ID**](https://docs.incari.com/incari-studio/2022.2/toolbox/actions/..#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).                                                                                                                                                                              |
| `Offset`      | **Vector3**    | The amount to move the `Position` of an **Object** along the X, Y, Z axes.                                                                                                                                |

## Outputs

| Output        | Type           | Description                                                                                                                    |
| ------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `Instance ID` | **InstanceID** | The assigned [**Instance ID**](https://docs.incari.com/incari-studio/2022.2/toolbox/actions/..#instance-id) of the **Action**. |
| `OnStart` (►) | **Pulse**      | Flows to the next **Node** following **MoveBy Action** when the **Action** starts.                                             |
| `OnEnd` (►)   | **Pulse**      | Flows to the next **Node** following **MoveBy Action** when the **Action** stops.                                              |

## Example

This section shows a simple example of how to use the **MoveBy Action** **Node** and the effect it has on an **Object**. We start by [configuring the **Scene**](#scene-configuration), then [build the **Logic**](#logic), and finally show the [result](#final-result).

### Scene Configuration

We consider a [**Scene**](https://docs.incari.com/incari-studio/2022.2/objects-and-types/project-objects/scene) with two [**Objects**](https://docs.incari.com/incari-studio/2022.2/objects-and-types/scene-objects): a red arc over a black background, both of which can be easily created in the [**Scene Outliner**](https://docs.incari.com/incari-studio/2022.2/modules/scene-outliner). Then, we set the `Size` **Attribute** of the arc to $$(150, 150, 1)$$. See this configuration in the following image:

![Scene configuration.](https://4267723012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEts3pBau6LMamSYhGZp%2Fuploads%2Fgit-blob-28ecac2f71f6f0fc0dc9bc621f4029aef491677e%2FExampleMoveBy_1.png?alt=media)

### Logic

We then need to configure the **Logic**. This is done in the [**Logic Editor**](https://docs.incari.com/incari-studio/2022.2/modules/logic-editor).

We use the **MoveBy Action** **Node** with the following **Attributes**:

* `To`: $$(-200, -200, 0)$$
* `Duration (sec)`: $$3$$
* `Interpolation`: `Linear`

And we connect to it the [**Object Node**](https://docs.incari.com/incari-studio/2022.2/objects-and-types/scene-objects#objects-in-the-logic) of the red arc and a **Pulse** to the `Start` **Input Socket**. Thus, having the following **Logic** configuration:

![Logic configuration.](https://4267723012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEts3pBau6LMamSYhGZp%2Fuploads%2Fgit-blob-54d162136966b7e283dd33f7daaca931ae4179b2%2FExampleMoveBy_2.png?alt=media)

### Final result

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

![Final result.](https://4267723012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOEts3pBau6LMamSYhGZp%2Fuploads%2Fgit-blob-6e8c06bcfb400fda1c682532c64fc3afbd4aa0b2%2FExampleMoveBy_3.gif?alt=media)

## See Also

* [**MoveTo Action**](https://docs.incari.com/incari-studio/2022.2/toolbox/actions/movetoaction)

## External Links

* [*Position (geometry)*](https://en.wikipedia.org/wiki/Position_\(geometry\)) on Wikipedia.