Librerie di elementi grafici .bbart

Raccolte di elementi grafici riutilizzabili gestite dall'utente. Basate su JSON, con deduplicazione dei contenuti e autonome.

Un file .bbart è una raccolta di clip grafici che vuoi riutilizzare in più progetti: loghi, decorazioni, forme comuni, selezioni acquisite. Il pannello Libreria grafica li carica e modifica.

A differenza dei progetti .lzrproj (che rappresentano un singolo progetto in corso), i file .bbart sono librerie organizzate, progettate per la condivisione, il controllo versione e il riutilizzo.

Contenuto

Campo	Note
`library_id`	UUID. Identifica la libreria in modo univoco (non in base al nome file).
`name`	Nome visualizzato. Modificabile.
`items[]`	Ogni elemento ha il proprio id, tipo, geometria, miniature, tag e categoria.

Tipi di elemento

File esterno: fa riferimento a un'immagine sorgente o a un file vettoriale. L'elemento contiene i byte originali (deduplicati in base all'hash del contenuto all'interno della libreria).
Istantanea della selezione: una versione appiattita di una selezione acquisita da un progetto. Il testo viene appiattito in geometria, senza dipendenza dai font per il destinatario. Include source_text_metadata per una futura nuova creazione.

Miniature

Ogni elemento ha una miniatura generata dal frontend e inclusa nel file. Non è necessario alcun rendering in tempo reale quando si carica la libreria.

Deduplicazione

All'interno di un singolo file .bbart, byte raster identici (in base all'hash del contenuto) vengono archiviati una sola volta e referenziati da più elementi. Riduce le dimensioni del file quando reimporti la stessa immagine come più elementi.

Come leggere e scrivere

GUI: il pannello Libreria grafica crea, carica, salva, importa ed esporta.
CLI: attualmente non disponibile.

Un file .bbart viene aperto da Beam Bench e rimane in memoria durante la modifica. Persistenza write-through: ogni azione di modifica viene scritta immediatamente su disco. Se la scrittura su disco non riesce, la modifica in memoria viene mantenuta e la libreria riceve un save_error; le operazioni distruttive vengono bloccate fino al nuovo tentativo.

Migrazione dal JSON legacy

Le librerie *.json legacy dei dati dell'app vengono migrate automaticamente in file .bbart affiancati al primo avvio. Il file .json originale viene lasciato al suo posto.

Condivisione delle librerie

Un file .bbart è portabile. Invialo via email o caricalo; il destinatario lo apre con il pannello Libreria grafica → Carica.

Se due file .bbart condividono lo stesso library_id (ad esempio perché ne hai copiato uno), il secondo a essere caricato viene rimappato, viene generato un nuovo id, il file viene riscritto e viene visualizzato un avviso. Questo impedisce silenziosamente le collisioni di id.

Casi limite

Se il salvataggio non riesce (permessi del file, file bloccato, disco pieno), la libreria mostra un errore di salvataggio e disabilita le operazioni distruttive finché il salvataggio successivo non riesce. Lo stato non viene annullato silenziosamente.
Rinominare un file .bbart sul disco modifica solo il nome visualizzato. Il library_id e i contenuti restano invariati.
Lo stesso nome visualizzato in due file è valido purché il loro library_id sia diverso.