# On Mouse Move

## Overview

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

![The On Mouse Move Node with Screen base.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-236d17196c469925b36b39b193217f0339a2de90%2Fnode-on-mouse-move-scrbase.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/2023.2/overview#scopes): **Scene**, **Prefab**.

## Attributes

![The On Mouse Move Node Attributes.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%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/2023.2/toolbox/events/unsubscribe) to unsubscribe from the **Event**. |

## See Also

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