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

Вихідна панель

Панель виведення знаходиться внизу екрана. Натисніть Вихід, щоб відкрити його.

../../../_images/overview_output.webp

Панель виведення надає кілька функцій, які полегшують перегляд тексту, надрукованого проектом (і редактором).

Примітка

Панель виведення автоматично відкривається під час запуску проекту за замовчуванням. Ви можете керувати цією поведінкою, змінивши налаштування редактора Виконати > Нижня панель > Дія під час гри.

Категорії повідомлень

Доступні чотири категорії повідомлень:

  • Журнал: Стандартні повідомлення, надруковані проектом. Відображається білим або чорним кольором (залежно від теми редактора).

  • Помилка: Повідомлення, що виводяться проектом або редактором і вказують на певний збій. Відображаються червоним кольором.

  • Попередження: Повідомлення, що друкуються проектом або редактором, містять важливу інформацію, але не вказують на помилку. Відображаються жовтим кольором.

  • Редактор: повідомлення, надруковані редактором, як правило, призначені для слідів дій скасування/повторення. Відображається сірим кольором.

Фільтрування повідомлень

Натискаючи кнопки праворуч, ви можете приховати певні категорії повідомлень. Це може полегшити пошук конкретних повідомлень, які ви шукаєте.

Ви також можете фільтрувати повідомлення за їх текстовим вмістом за допомогою поля Фільтрувати повідомлення внизу панелі «Вивід».

Очищення повідомлень

Під час запуску проекту наявні повідомлення автоматично очищаються за замовчуванням. Це контролюється параметром редактора Виконати > Вивід > Завжди очищати вихід під час відтворення. Крім того, ви можете вручну очистити повідомлення, натиснувши піктограму «щітки для очищення» у верхньому правому куті панелі «Вивід».

Друк повідомлень

Для друку повідомлень доступно кілька способів:

  • print(): Друкує повідомлення. Цей метод приймає кілька аргументів, які об'єднуються під час друку. Цей метод має варіанти, що розділяють аргументи відповідно табуляцією та пробілами: printt() and prints().

  • print_rich(): Те саме, що print(), але BBCode можна використовувати для форматування тексту, який друкується (див. нижче).

  • push_error(): друкує повідомлення про помилку. Коли помилка друкується у запущеному проекті, вона відображається на вкладці Debugger > Errors.

  • push_warning(): друкує попереджувальне повідомлення. Коли попередження друкується у запущеному проекті, воно відображається на вкладці Debugger > Errors.

Для більш складних випадків використання можна використовувати:

  • print_verbose(): Те саме, що й print(), але друкує лише тоді, коли в налаштуваннях проекту ввімкнено детальний режим або проект запущено з аргументом командного рядка --verbose.

  • printerr(): Те саме, що й print(), але друкує у стандартний потік помилок замість стандартного рядка виводу. У більшості випадків перевагу слід надавати push_error().

  • printraw(): Те саме, що й print(), але друкує без порожнього рядка в кінці. Це єдиний метод, який не друкує в панелі виводу редактора. Він друкує лише в стандартний потік виводу, що означає, що він все ще включений у файл журналу.

  • print_debug(): Same as print(), but adds the current stack frame on a new line at the end. Only supported when running from the editor, or when the project is exported in debug mode.

  • print_stack(): Друк трасування стека з поточного розташування. Підтримується лише під час запуску з редактора або коли проект експортовано в режимі налагодження.

  • print_tree(): Виводить дерево сцени відносно поточного вузла. Корисно для налагодження структур вузлів, створених під час виконання.

  • print_tree_pretty(): Те саме, що й print_tree(), але з використанням символів Unicode для більш деревоподібного вигляду. Це залежить від символів для малювання рамок, тому може не відображатися коректно з усіма шрифтами.

Щоб отримати розширені можливості форматування, подумайте про використання Форматований текст GDScript разом із наведеними вище функціями друку.

Дивись також

Можливості логування двигуна описані в документації logging.

Друк форматованого тексту

Використовуючи print_rich(), ви можете друкувати форматований текст на панель виводу редактора та стандартний вивід (видимий, коли користувач запускає проект із терміналу). Це працює шляхом перетворення BBCode на вихідні коди ANSI, які розуміє термінал.

У вихідних даних редактора всі теги BBCode розпізнаються як зазвичай. У виводі терміналу працюватиме лише підмножина тегів BBCode, як описано в пов’язаному описі методу print_rich() вище. У терміналі кольори виглядатимуть по-різному залежно від теми користувача, а кольори в редакторі використовуватимуть ті самі кольори, що й у проекті.

Примітка

Підтримка ANSI-кодів керування відрізняється залежно від емулятора терміналу. Точні кольори, що відображаються у виводі терміналу, також залежать від теми терміналу, обраної користувачем.