Beam Bench-dokumentation

.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ältAnmärkningar
library_idUUID. Identifierar biblioteket unikt (inte utifrån filnamnet).
nameVisningsnamn. 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_metadata fö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 BildbibliotekLä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_id och innehållet är oförändrade.
  • Samma visningsnamn i två filer är helt i sin ordning så länge deras library_id skiljer sig åt.

Relaterat

On this page