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

Настроювання курсора мишки

Можливо, ви захочете змінити зовнішній вигляд курсора мишки у вашій грі, щоб він відповідав загальному дизайну. Існує два способи оформлення курсора мишки:

Використання налаштувань проекту. Це простіше, але більш обмежено.
Використання сценарію. Це більш настроюваний, але передбачає виконання сценаріїв.

Примітка

Ви можете відобразити «програмний» курсор миші, сховавши курсор миші та перемістивши Sprite2D у позицію курсору в методі _process(), але це додасть принаймні один кадр затримки порівняно з «апаратним» курсором миші. Тому рекомендується використовувати описаний тут підхід, коли це можливо.

Якщо вам потрібно використовувати "програмний" підхід, подумайте про додавання кроку екстраполяції, щоб краще відобразити фактичний ввід миші.

Використання параметрів проекту

Відкрийте Налаштування проекту та перейдіть до Дисплей > Курсор миші. Ви побачите налаштування Custom Image, Custom Image Hotspot та Tooltip Position Offset.

../../_images/cursor_project_settings.webp

Власне зображення – це зображення, яке ви хочете встановити як курсор миші. Спеціальна точка доступу – це точка на зображенні, яку ви хочете використовувати як точку виявлення курсору.

Попередження

Користувальницьке зображення має мати розмір не більше 256×256 пікселів. Щоб уникнути проблем із візуалізацією, рекомендовані розміри 128×128 або менше.

На веб-платформі максимальний дозволений розмір зображення курсора становить 128×128.

Використання скрипта

Створіть вузол Node і вставте наступний скрипт.

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);
    }
}

Дивись також

Перевірте документацію Input.set_custom_mouse_cursor() для отримання додаткової інформації щодо використання та застережень щодо певної платформи.

Список курсорів

Існує кілька курсорів миші, які ви можете визначити, задокументовані в переліку Input.CursorShape. Які з них ви хочете використовувати, залежить від вашого випадку використання.