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...

Přizpůsobení kurzoru myši

Možná ve své hře budete chtít změnit vzhled kurzoru myši, aby vyhovoval celkovému designu. Toho lze docílit dvěma způsoby:

Pomocí nastavení projektu. Toto je jednodušší, ale také omezenější varianta.
Pomocí skriptu. Toto je více přizpůsobitelné, ale zahrnuje skriptování.

Poznámka

"Softwarový" kurzor myši můžete zobrazit skrytím skutečného kurzoru myši a přesunem Sprite2D na jeho pozici v metodě _process(). To nicméně přidá alespoň jeden snímek latence ve srovnání s "hardwarovým" kurzorem myši. Proto se doporučuje používat zde popsaný přístup, kdykoli je to možné.

Pokud musíte použít "softwarový" přístup, zvažte přidání extrapolačního kroku pro lepší zobrazení skutečného vstupu myši.

Použití nastavení projektu

Otevřete Nastavení projektu a přejděte na Zobrazení > Kurzor myši. Uvidíte nastavení Vlastní obrázek, Hotspot vlastního obrázku a Offset nápovědy.

../../_images/cursor_project_settings.webp

Vlastní obrázek je obrázek, který chcete nastavit jako kurzor myši. Hotspot vlastního obrázku je bod v obrázku, který se má použít jako detekční bod kurzoru.

Varování

Vlastní obrázek musí mít maximálně 256×256 pixelů. Abyste předešli problémům s vykreslováním, doporučuje se velikost 128×128 nebo menší.

Na webové platformě je maximální povolená velikost obrázku kurzoru 128×128.

Použití skriptu

Vytvořte uzel a připojte k němu následující skript.

extends Node


# Load the custom images for the mouse cursor.
var arrow = load("res://arrow.png")
var beam = load("res://beam.png")


func _ready():
    # Changes only the arrow shape of the cursor.
    # This is similar to changing it in the project settings.
    Input.set_custom_mouse_cursor(arrow)

    # Changes a specific shape of the cursor (here, the I-beam shape).
    Input.set_custom_mouse_cursor(beam, Input.CURSOR_IBEAM)

using Godot;

public partial class MyNode : Node
{
    public override void _Ready()
    {
        // Load the custom images for the mouse cursor.
        var arrow = ResourceLoader.Load("res://arrow.png");
        var beam = ResourceLoader.Load("res://beam.png");

        // Changes only the arrow shape of the cursor.
        // This is similar to changing it in the project settings.
        Input.SetCustomMouseCursor(arrow);

        // Changes a specific shape of the cursor (here, the I-beam shape).
        Input.SetCustomMouseCursor(beam, Input.CursorShape.Ibeam);
    }
}

Viz také

Podívejte se na dokumentaci Input.set_custom_mouse_cursor() ("nastavit vlastní kurzor myši"), kde najdete další informace o použití a také upozornění pro konkrétní platformy.

Seznam kurzorů

Můžete definovat několik kurzorů myši, které jsou zdokumentované ve výčtu Input.CursorShape ("tvar kurzoru"). Které z nich použijete záleží na vašich potřebách.