> For the complete documentation index, see [llms.txt](https://docs.incari.com/incari-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incari.com/incari-studio/2023.2/toolbox/events/mouse/on-mouse-move.md).

# On Mouse Move

## Overview

![The On Mouse Move Node with Object base.](/files/a8OqkprFjU2l9Yx5vsLx)

![The On Mouse Move Node with Screen base.](/files/M381X4EhPSl8NHUmG9F2)

**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**](/incari-studio/2023.2/toolbox/overview.md#scopes): **Scene**, **Prefab**.

## Attributes

![The On Mouse Move Node Attributes.](/files/2JAGFr6G0pzn5SMr0SOw)

### 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**](/incari-studio/2023.2/toolbox/events/unsubscribe.md) to unsubscribe from the **Event**.                  |

## See Also

* [**Events**](/incari-studio/2023.2/toolbox/events.md)
* [**Mouse**](/incari-studio/2023.2/toolbox/events/mouse.md)