Skip to content

Mouse and touch Reference

Conditions and actions to handle either the mouse or touches on touchscreen. By default, conditions related to the mouse will also handle the touches - so that it's easier to handle both in your game. You can disable this behavior if you want to handle them separately in different events. Read more explanations about it.

Actions

Hide the cursor
Hide the cursor.

Show the cursor
Show the cursor.

De/activate moving the mouse cursor with touches
When activated, any touch made on a touchscreen will also move the mouse cursor. When deactivated, mouse and touch positions will be completely independent.
By default, this is activated so that you can simply use the mouse conditions to also support touchscreens. If you want to have multitouch and differentiate mouse movement and touches, just deactivate it with this action.

Conditions

Cursor X position
Compare the X position of the cursor or of a touch.

Cursor Y position
Compare the Y position of the cursor or of a touch.

A new touch has started
Check if a touch has just started or the mouse left button has been pressed on this frame. The touch identifiers can be accessed using StartedTouchOrMouseId() and StartedTouchOrMouseCount().

A touch has ended
Check if a touch has ended or a mouse left button has been released.

Mouse cursor is inside the window
Check if the mouse cursor is inside the window.

The mouse wheel is scrolling down
Check if the mouse wheel is scrolling down. Use MouseWheelDelta expression if you want to know the amount that was scrolled.

The mouse wheel is scrolling up
Check if the mouse wheel is scrolling up. Use MouseWheelDelta expression if you want to know the amount that was scrolled.

Mouse button pressed or touch held (text expression)
Check if a mouse button, retrieved from the result of the expression, is pressed.

Mouse button released (text expression)
Check if a mouse button, retrieved from the result of the expression, was just released.

Mouse button pressed or touch held
Check if the specified mouse button is pressed or if a touch is in contact with the screen.

Mouse button released
Check if the specified mouse button was released.

Touch X position
Compare the X position of a specific touch.

Touch Y position
Compare the Y position of a specific touch.

Expressions

Expression Description
CursorX(layer name, number) Return the X position of the cursor or of a touch.
🔤 Layer name (String) Layer Optional.
🔢 Number Camera number (default : 0) Optional.
CursorY(layer name, number) Return the Y position of the cursor or of a touch.
🔤 Layer name (String) Layer Optional.
🔢 Number Camera number (default : 0) Optional.
MouseWheelDelta() Mouse wheel displacement
StartedTouchOrMouseCount() The number of touches (including the mouse) that have just started on this frame. The touch identifiers can be accessed using StartedTouchOrMouseId().
StartedTouchOrMouseId(number) The identifier of the touch or mouse that has just started on this frame. The number of touches can be accessed using StartedTouchOrMouseCount().
🔢 Number Touch index
TouchX(number, layer name, number) Return the X position of a specific touch.
🔢 Number Touch identifier
🔤 Layer name (String) Layer Optional.
🔢 Number Camera number (default : 0) Optional.
TouchY(number, layer name, number) Return the Y position of a specific touch.
🔢 Number Touch identifier
🔤 Layer name (String) Layer Optional.
🔢 Number Camera number (default : 0) Optional.

This page is an auto-generated reference page about the Mouse and touch feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.