Skip to content

Версии документации

Изменение объектов и создание экранов ​

В одном BGIN может быть несколько экранов. Экран состоит из объектов: текста, картинок, кнопок и контейнеров — групп, которые размещают вложенные объекты. Это устройство показано деревом слева.

Изменить существующий объект ​

  1. Нажмите кнопку с именем экрана над деревом, найдите экран в окне выбора и нажмите Open.
  2. Раскройте нужную группу стрелкой слева от её названия и нажмите на объект.
  3. Под деревом появятся его Properties — свойства. Измените нужное поле. Name меняет имя объекта, Type — его тип.
  4. Нажмите 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.

У карточек типов в окне создания есть значок справки справа сверху. Нажмите его, чтобы прочитать о типе перед выбором. Поле поиска отбирает карточки по названию.

Создать новый файл и первый экран ​

  1. Нажмите Ctrl+Shift+P → BGIN: New File → Enter и выберите папку, имя .bgin и режим формата BGIN.
  2. В окне Name this BGIN document задайте название документа, выберите формат BGIN и нажмите Start editing. Это внутреннее название, оно не подставляется из имени файла.
  3. Нажмите New screen…. Для обычного интерфейса выберите Interface screens.
  4. Задайте имя экрана, выберите тип контейнера и нажмите Create.
  5. Добавляйте объекты через правую кнопку по контейнеру → New child object….

При создании первого экрана также доступны Sprite library — библиотека картинок и анимаций, и Widget templates — шаблоны и стили текста. Выбирайте их для соответствующих файлов; после начала работы вид документа фиксируется. Для обычного экрана нужны Interface screens и контейнер в качестве основы.

Названия документа и экрана — разные вещи. Имена экранов в одном документе должны быть непустыми и разными. Пустой файл можно оставить на диске: он отмечается предупреждением. Для сохранения именованного BGIN создайте хотя бы один экран. После удаления последнего экрана добавьте или вставьте новый перед сохранением.

Редактировать как текст ​

Кнопка JSON вверху показывает тот же документ в текстовом виде. Hierarchy возвращает дерево. Отдельный файл JSON для этого не создаётся.

Если в JSON пропущена запятая, кавычка или скобка, исправьте ошибку перед сохранением. Сообщения видны в View → Problems. Редактор также проверяет, можно ли записать указанные значения в BGIN. Отдельный JSON можно получить через боковую панель, если он нужен для обмена.