.bbart-Grafikbibliotheken

Benutzerverwaltete Sammlungen wiederverwendbarer Grafiken. JSON-basiert, inhaltsdedupliziert und eigenständig.

Eine .bbart-Datei ist eine Sammlung von Grafikelementen, die Sie projektübergreifend wiederverwenden möchten: Logos, Verzierungen, häufig verwendete Formen und erfasste Auswahlen. Im Grafikbibliothek-Bedienfeld können Sie diese laden und bearbeiten.

Im Gegensatz zu .lzrproj-Projekten, die jeweils einen einzelnen in Bearbeitung befindlichen Entwurf darstellen, sind .bbart-Dateien strukturierte Bibliotheken, die für die gemeinsame Nutzung, Versionsverwaltung und Wiederverwendung konzipiert sind.

Inhalt

Feld	Hinweise
`library_id`	UUID. Identifiziert die Bibliothek eindeutig (nicht anhand des Dateinamens).
`name`	Anzeigename. Bearbeitbar.
`items[]`	Jedes Element verfügt über eine eigene ID, einen Typ, Geometrie, Miniaturansichten, Tags und eine Kategorie.

Elementtypen

Externe Datei: Verweist auf eine Quellbild- oder Vektordatei. Das Element enthält die Originalbytes (innerhalb der Bibliothek anhand des Inhalts-Hashs dedupliziert).
Auswahl-Schnappschuss: Eine reduzierte Version einer aus einem Projekt erfassten Auswahl. Text wird in Geometrie umgewandelt, sodass beim Empfänger keine Abhängigkeit von Schriftarten besteht. Enthält source_text_metadata für eine spätere erneute Bearbeitung.

Miniaturansichten

Jedes Element verfügt über eine vom Frontend erzeugte Miniaturansicht, die in der Datei enthalten ist. Beim Laden der Bibliothek ist kein Live-Rendering erforderlich.

Deduplizierung

Innerhalb einer einzelnen .bbart-Datei werden identische Rasterbytes (anhand des Inhalts-Hashs) nur einmal gespeichert und von mehreren Elementen referenziert. Dies reduziert die Dateigröße, wenn Sie dasselbe Bild erneut als mehrere Elemente importieren.

Lesen und Schreiben

GUI: Im Grafikbibliothek-Bedienfeld können Bibliotheken erstellt, geladen, gespeichert, importiert und exportiert werden.
CLI: Derzeit nicht verfügbar.

Eine .bbart-Datei wird von Beam Bench geöffnet und bleibt während der Bearbeitung im Arbeitsspeicher. Direkte Persistierung: Jede verändernde Aktion wird sofort auf den Datenträger geschrieben. Schlägt der Schreibvorgang fehl, bleibt die Änderung im Arbeitsspeicher erhalten, die Bibliothek erhält einen save_error, und destruktive Vorgänge werden bis zu einem erneuten Versuch blockiert.

Migration aus älterem JSON-Format

Ältere *.json-Bibliotheken aus den App-Daten werden beim ersten Start automatisch in gleichnamige .bbart-Dateien im selben Verzeichnis migriert. Die ursprüngliche .json-Datei bleibt erhalten.

Bibliotheken freigeben

Eine .bbart-Datei ist portabel. Senden Sie sie per E-Mail oder laden Sie sie hoch; der Empfänger öffnet sie über das Grafikbibliothek-Bedienfeld → Laden.

Wenn zwei .bbart-Dateien dieselbe library_id verwenden (z. B. weil Sie eine davon kopiert haben), wird die ID der als Zweites geladenen Datei neu zugeordnet, eine neue ID erzeugt, die Datei neu geschrieben und eine Warnung angezeigt. Dadurch werden unbemerkte ID-Konflikte verhindert.

Sonderfälle

Schlägt das Speichern fehl (Dateiberechtigungen, gesperrte Datei, voller Datenträger), zeigt die Bibliothek einen Speicherfehler an und deaktiviert destruktive Vorgänge, bis der nächste Speichervorgang erfolgreich abgeschlossen wurde. Der Zustand wird nicht unbemerkt zurückgesetzt.
Wenn Sie eine .bbart-Datei auf dem Datenträger umbenennen, ändert sich nur der Anzeigename. Die library_id und die Inhalte bleiben unverändert.
Derselbe Anzeigename kann problemlos für zwei Dateien verwendet werden, solange sich deren library_id unterscheidet.