# On Mouse Move

## Overview

![The On Mouse Move Node with Object Base and Left Button.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-cbff6ae405a8583663f15e0a8904fcfcac8bfcbd%2Fnode-on-mouse-move-objbase.png?alt=media)

![The On Mouse Move Node with Screen Base and Left Button.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-4043e2cee68549c8f69caeb3fde689fdf1aa5ee3%2Fonmousemovenode20241screen.png?alt=media)

**On Mouse Move** is an **Event Listener** **Node** used for executing a **Logic Branch** when the cursor moves either within an **Object** or anywhere in the **Screen**.

The **Attributes** allow the user to choose whether the `Event Base` is a specific **Object** or the entire **Screen**.

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

## Attributes

![The On Mouse Move Node Attributes.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-92eb360f0d8e6c22a9452d19294ef0e7164d1aed%2Fnode-on-mouse-move-attri.png?alt=media)

### Event Base

| Attribute    | Type          | Description                                                                                               |
| ------------ | ------------- | --------------------------------------------------------------------------------------------------------- |
| `Event Base` | **Drop-down** | Whether the **Logic** will be triggered when the cursor enters a particular **Object** or the **Screen**. |

## Inputs

Note: **Input Sockets** only available when `Event Base` is set to `Object`.

| Input           | Type         | Description                                                                        |
| --------------- | ------------ | ---------------------------------------------------------------------------------- |
| `Object ID`     | **ObjectID** | The **Object** in which moving with the cursor triggers the **Logic Branch**.      |
| `Subscribe` (►) | **Pulse**    | An **Input Pulse** that needs to be triggered to start listening to the **Event**. |

## Outputs

| Output             | Type         | Description                                                                                                                                                                                   |
| ------------------ | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse**    | A standard **Output Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution.                                                        |
| `Position`         | **Vector2**  | **Vector** containing the XY-coordinates of the points through which the cursor passes with respect to the bottom left of the **Screen**.                                                     |
| `Object ID`        | **ObjectID** | The **Object ID** of the **Object** where the cursos moves. If there is no **Object** on that part of the **Screen**, the output is the **Object ID** `00000000-0000-0000-0000-000000000000`. |
| `Event ID`         | **ObjectID** | The ID of the current **Event**. This can be connected to the [**Unsubscribe Node**](https://docs.incari.com/incari-studio/toolbox/events/unsubscribe) to unsubscribe from the **Event**.     |

## See Also

* [**Events**](https://docs.incari.com/incari-studio/toolbox/events)
* [**Mouse**](https://docs.incari.com/incari-studio/toolbox/events/mouse)