.bbart-bibliotek
Användarhanterade samlingar med återanvändbara bilder. JSON-baserade, innehållsdeduplicerade och fristående.
En .bbart-fil är en samling bilder och bilddelar som du vill återanvända i olika projekt: logotyper, dekorationer, vanliga former och sparade markeringar. Panelen Bildbibliotek läser in och redigerar dem.
Till skillnad från .lzrproj-projekt (som representerar en enskild pågående design) är .bbart-filer organiserade bibliotek som är utformade för delning, versionshantering och återanvändning.
Innehåll
| Fält | Anmärkningar |
|---|---|
library_id | UUID. Identifierar biblioteket unikt (inte utifrån filnamnet). |
name | Visningsnamn. Redigerbart. |
items[] | Varje objekt har ett eget id, typ, geometri, miniatyrbilder, taggar och kategori. |
Objekttyper
- Extern fil: refererar till en källbild eller vektorfil. Objektet innehåller originalbyten (deduplicerade utifrån innehållshash inom biblioteket).
- Ögonblicksbild av markering: en förenklad version av en markering som sparats från ett projekt. Text omvandlas till geometri, så mottagaren är inte beroende av något teckensnitt. Innehåller
source_text_metadataför framtida redigering av texten.
Miniatyrbilder
Varje objekt har en miniatyrbild som genereras i frontend och paketeras i filen. Ingen live-rendering behövs när biblioteket läses in.
Deduplicering
I en och samma .bbart-fil lagras identiska rasterbytesekvenser (utifrån innehållshash) en gång och refereras från flera objekt. Det minskar filstorleken när du importerar samma bild igen som flera objekt.
Läsa och skriva
- Grafiskt gränssnitt: panelen Bildbibliotek skapar, läser in, sparar, importerar och exporterar.
- CLI: exponeras inte för närvarande.
En .bbart-fil öppnas av Beam Bench och ligger kvar i minnet medan den redigeras. Skrivning direkt till disk: varje ändrande åtgärd skrivs omedelbart till disk. Om diskskrivningen misslyckas behålls ändringen i minnet, biblioteket får ett save_error och destruktiva åtgärder blockeras tills ett nytt försök görs.
Migrering från äldre JSON
Äldre *.json-bibliotek i appdata migreras automatiskt till intilliggande .bbart-filer vid första starten. Den ursprungliga .json-filen lämnas kvar.
Dela bibliotek
En .bbart-fil är portabel. Mejla eller ladda upp den; mottagaren öppnar den med panelen Bildbibliotek → Läs in.
Om två .bbart-filer har samma library_id (till exempel om du kopierade en av dem) mappas id:t i den andra filen som läses in om, ett nytt id skapas, filen skrivs om och en varning visas. Detta förhindrar att id-kollisioner uppstår obemärkt.
Specialfall
- Om sparandet misslyckas (filbehörigheter, låst fil eller full disk) visar biblioteket ett sparfel och inaktiverar destruktiva åtgärder tills nästa sparning lyckas. Tillståndet återställs inte i tysthet.
- Om du byter namn på en
.bbart-fil på disk ändras endast visningsnamnet.library_idoch innehållet är oförändrade. - Samma visningsnamn i två filer är helt i sin ordning så länge deras
library_idskiljer sig åt.