BeamBench: .bbart , biblioteki grafik

Zarządzane przez użytkownika kolekcje wielokrotnego użytku. Oparte na JSON, z deduplikacją zawartości, samodzielne.

Plik .bbart to kolekcja fragmentów grafik, które chcesz ponownie wykorzystywać w różnych projektach: logo, ozdób, typowych kształtów i przechwyconych zaznaczeń. Panel Biblioteka grafik umożliwia ich wczytywanie i edycję.

W przeciwieństwie do projektów .lzrproj (reprezentujących pojedynczy projekt w toku), pliki .bbart są uporządkowanymi bibliotekami przeznaczonymi do udostępniania, kontroli wersji i ponownego użycia.

Zawartość

Pole	Uwagi
`library_id`	UUID. Jednoznacznie identyfikuje bibliotekę (nie na podstawie nazwy pliku).
`name`	Nazwa wyświetlana. Można ją edytować.
`items[]`	Każdy element ma własny identyfikator, rodzaj, geometrię, miniatury, tagi i kategorię.

Rodzaje elementów

Plik zewnętrzny: odwołuje się do źródłowego pliku obrazu lub wektorowego. Element zawiera oryginalne bajty (deduplikowane w bibliotece na podstawie skrótu zawartości).
Migawka zaznaczenia: spłaszczona wersja zaznaczenia przechwyconego z projektu. Tekst zostaje spłaszczony do geometrii, więc odbiorca nie potrzebuje odpowiedniej czcionki. Zawiera source_text_metadata na potrzeby przyszłej ponownej edycji.

Miniatury

Każdy element ma wygenerowaną przez frontend miniaturę dołączoną do pliku. Podczas wczytywania biblioteki nie jest potrzebne bieżące renderowanie.

Deduplikacja

W pojedynczym pliku .bbart identyczne bajty rastrowe (według skrótu zawartości) są przechowywane tylko raz i wskazywane przez wiele elementów. Zmniejsza to rozmiar pliku, gdy ponownie importujesz ten sam obraz jako wiele elementów.

Odczyt i zapis

GUI: panel Biblioteka grafik tworzy, wczytuje, zapisuje, importuje i eksportuje biblioteki.
CLI: obecnie niedostępne.

Plik .bbart jest otwierany przez Beam Bench i pozostaje w pamięci podczas edycji. Trwałość zapisu bezpośredniego: każda operacja modyfikująca natychmiast zapisuje zmiany na dysku. Jeśli zapis na dysku się nie powiedzie, zmiana w pamięci zostaje zachowana, biblioteka otrzymuje save_error, a operacje destrukcyjne zostają zablokowane do czasu ponowienia próby.

Migracja ze starszego formatu JSON

Biblioteki *.json ze starszych danych aplikacji są przy pierwszym uruchomieniu automatycznie migrowane do sąsiadujących plików .bbart. Oryginalny plik .json pozostaje na miejscu.

Udostępnianie bibliotek

Plik .bbart jest przenośny. Wyślij go e-mailem lub prześlij; odbiorca otwiera go za pomocą panelu Biblioteka grafik → Wczytaj.

Jeśli dwa pliki .bbart mają ten sam library_id (np. po skopiowaniu jednego z nich), identyfikator drugiego wczytanego pliku zostanie zmieniony, zostanie wygenerowany nowy identyfikator, plik zostanie przepisany, a użytkownik zobaczy ostrzeżenie. Zapobiega to kolizjom identyfikatorów, które mogłyby pozostać niezauważone.

Przypadki brzegowe

Jeśli zapis się nie powiedzie (brak uprawnień do pliku, zablokowany plik, pełny dysk), biblioteka wyświetla błąd zapisu i wyłącza operacje destrukcyjne do czasu pomyślnego wykonania kolejnego zapisu. Stan nie jest wycofywany po cichu.
Zmiana nazwy pliku .bbart na dysku zmienia tylko nazwę wyświetlaną. library_id i zawartość pozostają niezmienione.
Taka sama nazwa wyświetlana w dwóch plikach jest dozwolona, o ile ich library_id są różne.

.bbart , biblioteki grafik