Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

InputEventMouseMotion

Hereda: InputEventMouse < InputEventWithModifiers < InputEventFromWindow < InputEvent < Resource < RefCounted < Object

Representa un movimiento de ratón o de lápiz.

Descripción

Almacena información sobre el movimiento de un ratón o un lápiz. Esto incluye posición relativa, posición absoluta y velocidad. Véase Node._input().

Nota: Por defecto, este evento solo se emite una vez por fotograma renderizado como máximo. Si necesitas un informe de entrada más preciso, establece Input.use_accumulated_input a false para que los eventos se emitan tan a menudo como sea posible. Si usas InputEventMouseMotion para dibujar líneas, considera usar Geometry2D.bresenham_line() también para evitar huecos visibles en las líneas si el usuario mueve el ratón rápidamente.

Nota: Este evento puede emitirse incluso cuando el ratón no se ha movido, ya sea por el sistema operativo o por el propio Godot. Si realmente necesitas saber si el ratón se ha movido (por ejemplo, para suprimir la visualización de una sugerencia), deberías comprobar que relative.is_zero_approx() es false.

Tutoriales

Propiedades

bool	pen_inverted	`false`
float	pressure	`0.0`
Vector2	relative	`Vector2(0, 0)`
Vector2	screen_relative	`Vector2(0, 0)`
Vector2	screen_velocity	`Vector2(0, 0)`
Vector2	tilt	`Vector2(0, 0)`
Vector2	velocity	`Vector2(0, 0)`

Descripciones de Propiedades

bool pen_inverted = false 🔗

void set_pen_inverted(value: bool)
bool get_pen_inverted()

Devuelve true cuando se usa el extremo de borrador de un lápiz óptico.

Nota: Esta propiedad está implementada en Linux, macOS y Windows.

float pressure = 0.0 🔗

void set_pressure(value: float)
float get_pressure()

Representa la presión que el usuario ejerce sobre el bolígrafo. Va desde 0.0 hasta 1.0.

Vector2 relative = Vector2(0, 0) 🔗

void set_relative(value: Vector2)
Vector2 get_relative()

La posición del ratón relativa a la posición anterior (posición en el último fotograma).

Nota: Dado que InputEventMouseMotion solo se emite cuando el ratón se mueve, no es posible detectar de forma fiable cuándo el ratón ha dejado de moverse comprobando esta propiedad. Puede ser necesario un temporizador corto separado.

Nota: relative se escala automáticamente según el factor de escala de contenido, que se define por la configuración del modo de estiramiento del proyecto. Esto significa que la sensibilidad del ratón parecerá diferente dependiendo de la resolución cuando se use relative en un script que maneje el apuntado del ratón con el modo de ratón Input.MOUSE_MODE_CAPTURED. Para evitar esto, usa screen_relative en su lugar.

Vector2 screen_relative = Vector2(0, 0) 🔗

void set_screen_relative(value: Vector2)
Vector2 get_screen_relative()

La posición del ratón sin escalar relativa a la posición anterior en el sistema de coordenadas de la pantalla (posición en el último cuadro).

Nota: Dado que InputEventMouseMotion solo se emite cuando el ratón se mueve, no es posible detectar de forma fiable cuándo el ratón ha dejado de moverse comprobando esta propiedad. Puede ser necesario un temporizador corto y separado.

Nota: Esta coordenada no se escala según el factor de escala del contenido o las llamadas a InputEvent.xformed_by(). Esto debería preferirse sobre relative para la puntería del ratón cuando se usa el modo de ratón Input.MOUSE_MODE_CAPTURED, independientemente del modo de estiramiento del proyecto.

Vector2 screen_velocity = Vector2(0, 0) 🔗

void set_screen_velocity(value: Vector2)
Vector2 get_screen_velocity()

The unscaled mouse velocity in pixels per second in screen coordinates. This velocity is not scaled according to the content scale factor or calls to InputEvent.xformed_by().

Note: In Input.MOUSE_MODE_CAPTURED mode, screen_velocity returns (0, 0) because the mouse cursor is hidden and locked. Use screen_relative for mouse aiming using the Input.MOUSE_MODE_CAPTURED mouse mode.

Vector2 tilt = Vector2(0, 0) 🔗

void set_tilt(value: Vector2)
Vector2 get_tilt()

Representa los ángulos de inclinación del bolígrafo. El valor positivo de la coordenada X indica una inclinación hacia la derecha. El valor positivo de la coordenada Y indica una inclinación hacia el usuario. Va de -1.0 a 1.0 para ambos ejes.

Vector2 velocity = Vector2(0, 0) 🔗

void set_velocity(value: Vector2)
Vector2 get_velocity()

The mouse velocity in pixels per second.

Note: velocity is automatically scaled according to the content scale factor, which is defined by the project's stretch mode settings. That means mouse sensitivity may appear different depending on resolution.

Note: In Input.MOUSE_MODE_CAPTURED mode, velocity returns (0, 0) because the mouse cursor is hidden and locked. Use screen_relative for mouse aiming using the Input.MOUSE_MODE_CAPTURED mouse mode.