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
| Campo | Observações |
|---|---|
library_id | UUID. Identifica exclusivamente a biblioteca (não pelo nome do arquivo). |
name | Nome 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_metadatapara 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
- GUI: o painel Biblioteca de Arte cria, carrega, salva, importa e exporta.
- CLI: no momento, não está disponível.
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 Arte → Carregar.
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
.bbartno disco altera apenas o nome de exibição. Olibrary_ide o conteúdo permanecem intactos. - O mesmo nome de exibição em dois arquivos não é problema, desde que seus
library_idsejam diferentes.
Relacionado
Arquivos de projeto do Beam Bench
O formato de arquivo de projeto .lzrproj. Arquivo zip independente que contém tudo o que a tela de trabalho mostra, além das configurações.
Saída de G-code
O que o Beam Bench emite quando um trabalho é executado. Como lê-lo, salvá-lo e enviá-lo a uma máquina fora do Beam Bench.