Документация Beam Bench

.bbart: библиотеки графики

Управляемые пользователем коллекции многоразовой графики. На основе JSON, с устранением дубликатов содержимого, самодостаточные.

Файл .bbart представляет собой коллекцию фрагментов графики, которую вы хотите повторно использовать в разных проектах: логотипов, декоративных элементов, стандартных фигур, сохраненных выделений. Панель библиотеки графики загружает их и позволяет редактировать.

В отличие от проектов .lzrproj, которые представляют один дизайн в процессе работы, файлы .bbart являются упорядоченными библиотеками, предназначенными для совместного использования, контроля версий и повторного применения.

Содержимое

ПолеПримечания
library_idUUID. Однозначно идентифицирует библиотеку, а не имя файла.
nameОтображаемое имя. Можно изменить.
items[]Каждый элемент имеет собственные идентификатор, тип, геометрию, миниатюры, теги и категорию.

Типы элементов

  • Внешний файл: ссылается на исходный файл изображения или векторной графики. Элемент содержит исходные байты, для которых внутри библиотеки устраняются дубликаты по хешу содержимого.
  • Снимок выделения: уплощенная версия выделения, сохраненная из проекта. Текст преобразуется в геометрию, поэтому получателю не требуется шрифт. Включает source_text_metadata для последующего редактирования исходного текста.

Миниатюры

Для каждого элемента в файл включается миниатюра, созданная во внешнем интерфейсе. При загрузке библиотеки не требуется выполнять рендеринг в реальном времени.

Устранение дубликатов

В одном файле .bbart идентичные растровые байты, определяемые по хешу содержимого, сохраняются один раз и используются несколькими элементами. Это уменьшает размер файла, когда вы повторно импортируете одно и то же изображение как несколько элементов.

Чтение и запись

  • Графический интерфейс: панель библиотеки графики создает, загружает, сохраняет, импортирует и экспортирует библиотеки.
  • CLI: в настоящее время не предоставляется.

Файл .bbart открывается в Beam Bench и остается в памяти во время редактирования. Сохранение с немедленной записью на диск: каждое изменяющее действие сразу записывается на диск. Если запись на диск завершается ошибкой, изменение в памяти сохраняется, библиотека получает save_error, а деструктивные операции блокируются до повторной попытки.

Миграция из устаревшего формата JSON

Библиотеки *.json из данных приложения автоматически преобразуются в соседние файлы .bbart при первом запуске. Исходный файл .json остается на месте.

Совместное использование библиотек

Файл .bbart является переносимым. Отправьте его по электронной почте или загрузите, а получатель откроет его с помощью панели библиотеки графикиЗагрузить.

Если два файла .bbart имеют одинаковый library_id, например если вы скопировали один файл, при загрузке второго идентификатор будет заменен: будет создан новый идентификатор, файл перезаписан, а пользователь увидит предупреждение. Это предотвращает скрытое возникновение конфликтов идентификаторов.

Особые случаи

  • Если сохранение завершается ошибкой из-за прав доступа к файлу, блокировки файла или переполнения диска, библиотека показывает ошибку сохранения и отключает деструктивные операции до успешного следующего сохранения. Состояние не откатывается незаметно.
  • Переименование файла .bbart на диске изменяет только отображаемое имя. library_id и содержимое остаются неизменными.
  • Одинаковое отображаемое имя у двух файлов допустимо, если их library_id различаются.

Связанные материалы

On this page