Documentação do Beam Bench

Bibliotecas de arte .bbart

Coleções de arte reutilizável gerenciadas pelo usuário. Baseadas em JSON, com conteúdo deduplicado e independentes.

Um arquivo .bbart é uma coleção de clipes de arte que você deseja reutilizar em vários projetos: logotipos, decorações, formas comuns e seleções capturadas. O painel Biblioteca de Arte os carrega e edita.

Diferentemente dos projetos .lzrproj (que representam um único design em andamento), os arquivos .bbart são bibliotecas organizadas, projetadas para compartilhamento, controle de versão e reutilização.

O que contém

CampoObservações
library_idUUID. Identifica exclusivamente a biblioteca (não pelo nome do arquivo).
nameNome de exibição. Editável.
items[]Cada item tem seu próprio id, tipo, geometria, miniaturas, tags e categoria.

Tipos de item

  • Arquivo externo: faz referência a uma imagem de origem ou arquivo vetorial. O item contém os bytes originais (deduplicados pelo hash de conteúdo na biblioteca).
  • Instantâneo de seleção: uma versão achatada de uma seleção capturada de um projeto. O texto é achatado em geometria, sem dependência de fonte para o destinatário. Inclui source_text_metadata para futura reautoria.

Miniaturas

Cada item tem uma miniatura gerada pelo frontend e incluída no arquivo. Não é necessária renderização ao vivo ao carregar a biblioteca.

Deduplicação

Em um único arquivo .bbart, bytes rasterizados idênticos (pelo hash de conteúdo) são armazenados uma única vez e referenciados por vários itens. Reduz o tamanho do arquivo quando você reimporta a mesma imagem como vários itens.

Como ler e gravar

Um arquivo .bbart é aberto pelo Beam Bench e permanece na memória durante a edição. Persistência por gravação imediata: toda ação que modifica algo é gravada no disco imediatamente. Se a gravação no disco falhar, a modificação na memória é mantida, a biblioteca recebe um save_error e as operações destrutivas são bloqueadas até nova tentativa.

Migração do JSON legado

Bibliotecas *.json de dados legados do aplicativo são migradas automaticamente para arquivos .bbart adjacentes na primeira inicialização. O .json original é mantido no local.

Compartilhamento de bibliotecas

Um arquivo .bbart é portátil. Envie-o por e-mail ou faça upload; o destinatário o abre no painel Biblioteca de ArteCarregar.

Se dois arquivos .bbart compartilharem o mesmo library_id (por exemplo, se você copiou um deles), o segundo a ser carregado é remapeado, recebe um novo id, o arquivo é regravado e um aviso é exibido. Isso impede silenciosamente colisões de id.

Casos extremos

  • Se o salvamento falhar (permissões do arquivo, arquivo bloqueado ou disco cheio), a biblioteca exibirá um erro de salvamento e desativará as operações destrutivas até que o próximo salvamento seja bem-sucedido. O estado não é revertido silenciosamente.
  • Renomear um arquivo .bbart no disco altera apenas o nome de exibição. O library_id e o conteúdo permanecem intactos.
  • O mesmo nome de exibição em dois arquivos não é problema, desde que seus library_id sejam diferentes.

Relacionado

On this page