Версии документации
Изменение объектов и создание экранов
В одном BGIN может быть несколько экранов. Экран состоит из объектов: текста, картинок, кнопок и контейнеров — групп, которые размещают вложенные объекты. Это устройство показано деревом слева.
Изменить существующий объект
- Нажмите кнопку с именем экрана над деревом, найдите экран в окне выбора и нажмите Open.
- Раскройте нужную группу стрелкой слева от её названия и нажмите на объект.
- Под деревом появятся его Properties — свойства. Измените нужное поле. Name меняет имя объекта, Type — его тип.
- Нажмите Refresh, чтобы проверить изображение, затем Ctrl+S для сохранения. Ctrl+Z отменяет правку, Ctrl+Y возвращает отменённое действие.
Набор свойств определяется типом объекта. Значения выбираются из списков или вводятся в подписанные поля. Пустое поле означает, что явное значение не задано и используется значение по умолчанию. Неизвестные редактору свойства сохраняются и показываются только для чтения.
Если назначение свойства непонятно, нажмите Documentation возле названия объекта. Откроется справка его типа. Reveal in tree рядом с этой кнопкой раскрывает путь до объекта и показывает его строку в дереве.
Размеры дерева, области свойств и предпросмотра меняются перетаскиванием тонких границ между ними. Наведите на линию: курсор покажет направление перетаскивания.
Найти экран
Кнопка с именем текущего экрана над деревом открывает окно Choose screen. Поиск отбирает экраны по имени и типу. Представления All и By prefix показывают общий список или группы по префиксам; отдельный фильтр позволяет оставить нужную группу. Префиксы вычисляются из имён, включая разделители и CamelCase: например template_card и screenGarage дают template и screen. Редактор не ограничивает список этими двумя префиксами.
Рядом с типом показано Objects — число объектов в экране, включая сам корень и все вложенные объекты из children и tracks. Ссылки на определения в других BGIN и отдельные кадры анимации не считаются дополнительными объектами. Выберите строку и нажмите Open, дважды щёлкните по строке или нажмите Enter. Переключение экрана не запускает рендер: после выбора нажмите Refresh.
Найти объект
Нажмите Find object… над деревом и введите часть имени или типа. В открывшемся окне останутся совпадения и группы, в которых они находятся. Нажмите нужный результат: редактор переключится на его экран и покажет его в основном дереве.
Clear selection снимает выделение. Это также возвращает показ всего экрана, если предпросмотр настроен на выбранный объект.
Добавить, скопировать или удалить
Нажмите правой кнопкой по строке дерева. То же меню открывается через Shift+F10.
| Пункт | Действие |
|---|---|
| New child object… | Добавить объект внутрь выбранного контейнера. В окне выберите тип и подтвердите создание. |
| New screen… | Создать ещё один экран в этом файле. |
| Rename… | Переименовать выбранное; также работает F2. |
| Change type… | Выбрать другой тип. Контейнер с вложенными объектами нельзя превратить в объект без вложений. |
| Copy JSON | Скопировать объект со всем содержимым как текст JSON. |
| Cut | Скопировать объект со всем содержимым и убрать из текущего места. |
| Paste into container | Вставить скопированное внутрь выбранного контейнера. При совпадении имён редактор добавит суффикс к имени копии. |
| Paste as screen | Вставить скопированное как отдельный экран подходящего типа. |
| Duplicate | Сразу создать копию рядом с исходным объектом. Содержимое буфера обмена не меняется. |
| Move up / Move down | Переместить выше или ниже среди соседей; кнопки ↑/↓ над деревом делают то же самое. |
| Expand all / Collapse all | Раскрыть или свернуть дерево текущего экрана. |
| Delete | Удалить выбранный объект вместе с содержимым или целый экран. |
Когда выбрана строка дерева: Ctrl+C — копировать, Ctrl+X — вырезать, Ctrl+V — вставить в контейнер, Ctrl+Shift+V — вставить экран, Ctrl+D — создать копию, Delete — удалить. Изменения попадут в файл на диске после Ctrl+S.
У карточек типов в окне создания есть значок справки справа сверху. Нажмите его, чтобы прочитать о типе перед выбором. Поле поиска отбирает карточки по названию.
Создать новый файл и первый экран
- Нажмите Ctrl+Shift+P → BGIN: New File → Enter и выберите папку, имя
.bginи режим формата BGIN. - В окне Name this BGIN document задайте название документа, выберите формат BGIN и нажмите Start editing. Это внутреннее название, оно не подставляется из имени файла.
- Нажмите New screen…. Для обычного интерфейса выберите Interface screens.
- Задайте имя экрана, выберите тип контейнера и нажмите Create.
- Добавляйте объекты через правую кнопку по контейнеру → New child object….
При создании первого экрана также доступны Sprite library — библиотека картинок и анимаций, и Widget templates — шаблоны и стили текста. Выбирайте их для соответствующих файлов; после начала работы вид документа фиксируется. Для обычного экрана нужны Interface screens и контейнер в качестве основы.
Названия документа и экрана — разные вещи. Имена экранов в одном документе должны быть непустыми и разными. Пустой файл можно оставить на диске: он отмечается предупреждением. Для сохранения именованного BGIN создайте хотя бы один экран. После удаления последнего экрана добавьте или вставьте новый перед сохранением.
Редактировать как текст
Кнопка JSON вверху показывает тот же документ в текстовом виде. Hierarchy возвращает дерево. Отдельный файл JSON для этого не создаётся.
Если в JSON пропущена запятая, кавычка или скобка, исправьте ошибку перед сохранением. Сообщения видны в View → Problems. Редактор также проверяет, можно ли записать указанные значения в BGIN. Отдельный JSON можно получить через боковую панель, если он нужен для обмена.