# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.incari.com/incari-studio/2023.2/toolbox/events/mouse/on-mouse-move.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.