Консоль
Консоль — это собственное окно движка для диагностики и опытов. Она показывает, что сообщает движок (проблемы в конфигурации, скрипты, завершившиеся ошибкой, плагины, вместо которых пришлось рисовать встроенными средствами), показывает, что выводят ваши скрипты, и содержит редактор, в котором можно сразу написать и выполнить скрипт.
Открытие консоли
Выберите Показать консоль в меню трея (Значок в трее) или выполните встроенную функцию
UIShowConsole из действия — например, привяжите её к горячей клавише. Ничто не открывает консоль
автоматически, если вы не попросите об этом через При сообщении (см. ниже).
Если конфигурация защищена паролем, консоль при открытии запрашивает пароль, если он ещё не запомнен
(Безопасность). Пока консоль открыта, запомненный пароль не истекает. UIShowConsole
ждёт, пока консоль откроется, в том числе пока запрашивается пароль, и даёт false, если она не
открылась, например потому, что запрос пароля был отменён.
Консоль закрывается своей кнопкой закрытия. Закрытие освобождает использованную ею память.
Три раздела
Кнопки вверху ① переключают три раздела, у каждого из которых своя панель инструментов.
| Раздел | Что показывает | Панель инструментов |
|---|---|---|
| Система | Что сообщает движок: замечания о конфигурации при последней загрузке, действия и скрипты, завершившиеся ошибкой, и причины, плагин, который не смог рисовать, из-за чего рисование взяли на себя встроенные средства, и тому подобное. | Копировать, Очистить, При сообщении |
| Пользователь | Всё, что ваши скрипты выводят через UtilityPrint, из всех действий. | Копировать, Очистить, При сообщении |
| Скрипт | Редактор скриптов над панелью вывода. | Выполнить, Остановить все, Скрыть консоль, Справка по скриптам, Копировать, Вставить, Очистить |
Копировать копирует выделенный текст или весь раздел, если ничего не выделено. Очистить очищает раздел.
Пока показан раздел Скрипт, новые строки Система и Пользователь также появляются в его панели вывода, поэтому за выполняющимся скриптом можно следить, не переключая разделы.
Пока консоль закрыта
Строки, поступившие, пока консоль закрыта, не теряются: они хранятся во временных файлах и показываются при следующем открытии консоли. При завершении работы Input.Observer они удаляются, кроме того, что выводит событие Движок завершает работу, — это покажет консоль следующего сеанса.
При сообщении ① на панелях Система и Пользователь выбирает, что делает новая строка, пока консоль закрыта:
| Вариант | Что происходит |
|---|---|
| Ничего не делать | Строка ждёт, пока вы откроете консоль. По умолчанию. |
| Показать UIShowMessageBox | Строка также всплывает в окне сообщения. |
| Открыть консоль | Консоль открывается на этом разделе. |
Если консоль открыта, новая строка просто добавляется; она никогда не вызывает окно сообщения и не переключает разделы. Те же варианты есть на странице Консоль как Новые системные сообщения и Новые пользовательские сообщения.
Выполнение скрипта
- Откройте раздел Скрипт консоли.
- Введите или вставьте скрипт в редактор. Используется язык скриптов Input.Observer (Язык скриптов).
- Выберите Выполнить ② или нажмите F5. Если текст выделен, выполняется только выделенное; иначе выполняется всё содержимое редактора.
- Вывод и ошибки появляются в панели вывода под редактором. Скрыть консоль скрывает или показывает эту панель.
- Скрипт, выполняемый здесь, работает как действие: доступны все встроенные функции, и он выполняется, пока не завершится или не будет остановлен. Остановить все останавливает все выполняющиеся скрипты и действия, а не только этот.
- Это единственное место, где скрипты выполняются в безопасном режиме, поэтому можно исследовать и исправлять что-то, пока больше ничего не работает (Устранение неполадок).
- Редактор дополняет имена встроенных функций по мере ввода; Ctrl+Пробел выводит все, а ввод имени области и точки выводит встроенные функции этой области. После выбора встроенной функции подсказка показывает её параметры с выделенным текущим. В контекстном меню есть Закомментировать и Раскомментировать для выделенных строк.
- Текст редактора сохраняется между сеансами в
console.toml.
Справка по скриптам ③ открывает справочник по языку скриптов в окне справки (Окно справки) на языке, который использует Input.Observer (или на английском, если справки на этом языке нет).
Страница «Консоль»
Расширенный режим. Страница Консоль в простом режиме скрыта. Её параметры продолжают действовать.
Страница Консоль в окне настройки содержит параметры консоли. Они вступают в силу, когда вы выбираете Применить или Сохранить и закрыть.
| Параметр | Что делает | По умолчанию | Диапазон |
|---|---|---|---|
| Ограничение строк консоли | Когда в разделе набирается столько строк, при поступлении новых самые старые удаляются. 0 — хранить всё. Вступает в силу со следующей строкой. | 5000 строк | 0–1000000 |
| Освобождать память при закрытии консоли | Возвращает память консоли Windows сразу после её закрытия. Следующее после этого событие мыши или клавиатуры может обработаться чуть-чуть медленнее. | Вкл. | Вкл. или выкл. |
| Новые системные сообщения | Что делает новая строка Система, пока консоль закрыта: Ничего, Окно сообщения или Открыть консоль (то же, что При сообщении выше) | Ничего | — |
| Новые пользовательские сообщения | То же для строк Пользователь | Ничего | — |
| Шрифт окон движка | Шрифт и размер для подписей и кнопок консоли и для диалоговых окон движка (пароль, лицензия) | Segoe UI, 12 пт | 6–72 пт |
| Шрифт редактора движка | Шрифт и размер для разделов консоли и её редактора скриптов | Consolas, 13 пт | 6–72 пт |
Открытая консоль сохраняет свои шрифты, пока вы её не закроете и не откроете снова.