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

Іконки редактора

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

Створення значків

Щоб створити нові значки, спочатку потрібно встановити векторний графічний редактор. Наприклад, ви можете використовувати редактор Inkscape з відкритим кодом.

Клонуйте репозиторій godot, що містить усі значки редактора:

git clone https://github.com/godotengine/godot.git

Іконки слід створювати у редакторі векторної графіки у форматі SVG. Необхідно дотримуватися трьох основних вимог:

  • Значки мають бути 16×16. У Inkscape ви можете налаштувати розмір документа в Файл > Властивості документа.

  • Лінії слід прив’язувати до пікселів, щоб залишатися чіткими за нижчої роздільної здатності. Ви можете створити сітку 16 × 16 в Inkscape, щоб полегшити це.

  • Якщо користувач налаштував свій редактор на використання світлої теми, Godot конвертуватиме кольори значка на основі набору попередньо визначених колірних зіставлень. Це потрібно для того, щоб значок завжди відображався з достатньою контрастністю. Спробуйте обмежити колірну палітру вашого значка кольорами зі списку вище. В іншому випадку ваш значок може бути важко читати на світлому фоні.

Коли ви будете задоволені дизайном значка, збережіть його в папці editor/icons клонованого сховища. Назва піктограми має збігатися з запланованою назвою з урахуванням регістру. Наприклад, щоб створити піктограму для CPUParticles2D, назвіть файл CPUParticles2D.svg.

Порада

Ви також можете переглянути всі наявні іконки на веб-сайті Іконки редактора Godot.

Параметри імпорту для власних піктограм

Для користувацьких іконок, що містяться в проектах (на відміну від вихідного коду движка), слід увімкнути два параметри імпорту:

Масштабування для дисплеїв з високою роздільною здатністю

На дисплеях з високою роздільною здатністю (hiDPI) піктограми потрібно правильно масштабувати, щоб вони залишалися чіткими та достатньо великими для зручного перегляду.

Щоб іконка відображалася у правильному масштабі на екранах з високою роздільною здатністю (hiDPI), виберіть файл SVG у панелі «Файлова система», увімкніть опцію Редактор > Масштабувати за масштабом редактора у панелі «Імпорт» і натисніть кнопку Reimport. Зверніть увагу, що ця опція доступна лише для іконок у форматі SVG, оскільки для її роботи необхідний векторний формат.

Перетворення кольорів для тем редактора світла

Щоб кольори іконки перетворювалися, коли користувач використовує світлу тему, виберіть файл SVG у панелі «Файлова система», увімкніть опцію Редактор > Перетворити кольори відповідно до теми редактора у панелі «Імпорт» і натисніть кнопку Reimport Зверніть увагу, що ця опція доступна лише для іконок у форматі SVG, оскільки для її роботи необхідний векторний формат.

Оптимізація значків

Оскільки редактор відображає SVG-файли один раз під час завантаження, вони повинні бути невеликими за розміром, щоб їх можна було ефективно аналізувати. Коли запускається pre-commit hook, він автоматично оптимізує SVG за допомогою svgo.

Примітка

Хоча цей крок оптимізації не вплине помітно на якість піктограми, він усе одно видалить інформацію лише для редактора, наприклад напрямні. Тому рекомендується зберігати вихідний SVG, якщо вам знадобляться подальші зміни.

Інтеграція та спільний доступ до піктограм

Якщо ви робите внесок у сам механізм, вам слід зробити запит на додавання оптимізованих піктограм до editor/icons у головному репозиторії. Перекомпілюйте двигун, щоб він підбирав нові значки для класів.

У модулі також можна створювати власні піктограми. Якщо ви створюєте власний модуль і не плануєте інтегрувати його з Godot, вам не потрібно робити окремий запит на отримання, щоб ваші значки були доступні в редакторі, оскільки вони можуть бути автономними.

Детальні інструкції щодо створення піктограм модулів див. у розділі Створення власних піктограм модулів.

Вирішення проблем

Якщо піктограми не з’являються в редакторі, переконайтеся, що:

  1. Ім'я файлу кожної піктограми відповідає вимогам до іменування, описаним раніше.

  2. Модуль svg увімкнено під час компіляції (він увімкнено за замовчуванням). Без цього модуля іконки взагалі не відображатимуться в редакторі.

Посилання