Mouse e coordenadas de entrada¶

Sobre¶

A razão para este pequeno tutorial é esclarecer muitos erros comuns sobre coordenadas de entrada, obtenção da posição do mouse e resolução da tela, etc.

Coordenadas de exibição de hardware¶

O uso de coordenadas de hardware faz sentido no caso de escrever UIs complexas destinadas a rodar no PC, como editores, MMOs, ferramentas, etc. No entanto, não faz tanto sentido fora desse escopo.

Coordenadas de exibição da janela de visualização¶

Godot usa janelas de exibição para exibir conteúdo, e as viewports podem ser dimensionadas por várias opções (consulte o tutorial Resoluções múltiplas). Utilize, então, as funções em nós para obter as coordenadas do mouse e o tamanho do viewport, por exemplo:

func _input(event):
   # Mouse in viewport coordinates.
   if event is InputEventMouseButton:
       print("Mouse Click/Unclick at: ", event.position)
   elif event is InputEventMouseMotion:
       print("Mouse Motion at: ", event.position)

   # Print the size of the viewport.
   print("Viewport Resolution is: ", get_viewport_rect().size)

public override void _Input(InputEvent @event)
{
    // Mouse in viewport coordinates.
    if (@event is InputEventMouseButton eventMouseButton)
        GD.Print("Mouse Click/Unclick at: ", eventMouseButton.Position);
    else if (@event is InputEventMouseMotion eventMouseMotion)
        GD.Print("Mouse Motion at: ", eventMouseMotion.Position);

    // Print the size of the viewport.
    GD.Print("Viewport Resolution is: ", GetViewportRect().Size);
}

Como alternativa, é possível solicitar à viewport a posição do mouse:

get_viewport().get_mouse_position()

GetViewport().GetMousePosition();

Nota

Quando o modo do mouse é definido como Input.MOUSE_MODE_CAPTURED, o valor event.position de InputEventMouseMotion é o centro da tela. Use event.relative em vez de event.position e event.speed para processar o movimento do mouse e as mudanças de posição.