.bbart-kunstbibliotheken

Door gebruikers beheerde collecties herbruikbare illustraties. Op JSON gebaseerd, inhoudelijk ontdubbeld en zelfstandig.

Een .bbart-bestand is een verzameling illustratiefragmenten die je in verschillende projecten opnieuw wilt gebruiken: logo's, decoraties, veelgebruikte vormen en vastgelegde selecties. Het paneel Illustratiebibliotheek laadt en bewerkt deze bestanden.

In tegenstelling tot .lzrproj-projecten (die één ontwerp in uitvoering vertegenwoordigen), zijn .bbart-bestanden georganiseerde bibliotheken, bedoeld om te delen, versiebeheer toe te passen en opnieuw te gebruiken.

Wat het bevat

Veld	Opmerkingen
`library_id`	UUID. Identificeert de bibliotheek uniek (niet op basis van de bestandsnaam).
`name`	Weergavenaam. Kan worden bewerkt.
`items[]`	Elk item heeft een eigen id, soort, geometrie, miniaturen, tags en categorie.

Itemsoorten

Extern bestand: verwijst naar een bronafbeelding of vectorbestand. Het item bevat de oorspronkelijke bytes (binnen de bibliotheek ontdubbeld op basis van de inhoudshash).
Momentopname van selectie: een afgevlakte versie van een selectie die uit een project is vastgelegd. Tekst wordt afgevlakt tot geometrie; de ontvanger heeft geen afhankelijkheid van lettertypen. Bevat source_text_metadata voor toekomstige bewerking van de bron.

Miniaturen

Elk item heeft een door de frontend gegenereerde miniatuur die in het bestand is opgenomen. Bij het laden van de bibliotheek is geen live-rendering nodig.

Deduplicatie

Binnen één .bbart-bestand worden identieke rasterbytes (op basis van de inhoudshash) één keer opgeslagen en vanuit meerdere items verwezen. Dit verkleint de bestandsgrootte wanneer je dezelfde afbeelding opnieuw importeert als meerdere items.

Lezen en schrijven

GUI: het paneel Illustratiebibliotheek maakt bibliotheken aan en laadt, slaat op, importeert en exporteert ze.
CLI: momenteel niet beschikbaar.

Een .bbart-bestand wordt geopend door Beam Bench en blijft tijdens het bewerken in het geheugen. Directe persistentie: elke wijziging wordt onmiddellijk naar schijf geschreven. Als het schrijven naar schijf mislukt, blijft de wijziging in het geheugen behouden en krijgt de bibliotheek een save_error; destructieve bewerkingen worden geblokkeerd totdat opnieuw proberen is gelukt.

Migratie vanuit verouderde JSON

Verouderde *.json-bibliotheken uit app-gegevens worden bij de eerste start automatisch gemigreerd naar .bbart-bestanden ernaast. Het oorspronkelijke .json-bestand blijft staan.

Bibliotheken delen

Een .bbart-bestand is draagbaar. E-mail het of upload het; de ontvanger opent het via het paneel Illustratiebibliotheek → Laden.

Als twee .bbart-bestanden dezelfde library_id delen (bijvoorbeeld omdat je er één hebt gekopieerd), wordt de id van het bestand dat als tweede wordt geladen opnieuw toegewezen: er wordt een nieuwe id aangemaakt, het bestand wordt herschreven en er verschijnt een waarschuwing. Zo worden id-botsingen niet stilzwijgend veroorzaakt.

Randgevallen

Als opslaan mislukt (door bestandsrechten, een vergrendeld bestand of een volle schijf), toont de bibliotheek een opslagfout en worden destructieve bewerkingen uitgeschakeld totdat de volgende opslagpoging slaagt. De status wordt niet stilzwijgend teruggedraaid.
Als je de naam van een .bbart-bestand op schijf wijzigt, verandert alleen de weergavenaam. De library_id en inhoud blijven intact.
Dezelfde weergavenaam voor twee bestanden is geen probleem zolang hun library_id verschilt.