Dokumentace Beam Bench

.bbart knihovny grafik

Uživatelem spravované kolekce opakovaně použitelné grafiky. Kolekce jsou založené na formátu JSON, odstraňují duplicitní obsah a zůstávají zcela samostatné.

Soubor .bbart je kolekce grafických výřezů, které chcete znovu používat napříč projekty: loga, dekorace, běžné tvary nebo zachycené výběry. Načítá a upravuje je panel Knihovna grafik.

Na rozdíl od projektů .lzrproj (které představují jeden rozpracovaný návrh) jsou soubory .bbart uspořádané knihovny určené ke sdílení, správě verzí a opakovanému použití.

Co obsahuje

PolePoznámky
library_idUUID. Jednoznačně identifikuje knihovnu (nikoli podle názvu souboru).
nameZobrazovaný název. Lze upravit.
items[]Každá položka má vlastní id, typ, geometrii, náhledy, štítky a kategorii.

Typy položek

  • Externí soubor: odkazuje na zdrojový rastrový nebo vektorový soubor. Položka obsahuje původní bajty (v rámci knihovny deduplikované podle hashe obsahu).
  • Snímek výběru: sloučená verze výběru zachyceného z projektu. Text je převeden na geometrii, takže příjemce není závislý na fontu. Obsahuje source_text_metadata pro budoucí opětovné vytvoření.

Náhledy

Každá položka má náhled vygenerovaný frontendem, přibalený přímo v souboru. Při načítání knihovny není potřeba živé vykreslování.

Deduplikace

V rámci jediného souboru .bbart jsou shodná rastrová data (podle hashe obsahu) uložena pouze jednou a odkazuje na ně více položek. Tím se zmenší velikost souboru, když stejný obrázek znovu importujete jako více položek.

Jak číst a zapisovat

  • Grafické rozhraní: panel Knihovna grafik vytváří, načítá, ukládá, importuje a exportuje knihovny.
  • CLI: aktuálně není zpřístupněno.

Soubor .bbart otevře Beam Bench a při úpravách zůstává v paměti. Průběžný zápis: každá měnící akce se okamžitě zapíše na disk. Pokud zápis na disk selže, změna v paměti zůstane zachována, knihovna obdrží save_error a destruktivní operace jsou až do opakování zápisu zablokovány.

Migrace ze staršího JSON

Knihovny *.json ve starších aplikačních datech se při prvním spuštění automaticky migrují do souborů .bbart ve stejné složce. Původní soubor .json zůstane zachován.

Sdílení knihoven

Soubor .bbart je přenositelný. Odešlete jej e-mailem nebo nahrajte; příjemce jej otevře pomocí panelu Knihovna grafikNačíst.

Pokud dva soubory .bbart sdílejí stejné library_id (například jste jeden zkopírovali), druhému načtenému souboru se přiřadí nové ID, vygeneruje se nové id, soubor se přepíše a zobrazí se varování. Tím se zabrání tichým kolizím ID.

Okrajové případy

  • Uložení selže (kvůli oprávněním k souboru, zamčenému souboru nebo plnému disku): knihovna zobrazí chybu ukládání a deaktivuje destruktivní operace, dokud další uložení neproběhne úspěšně. Stav se tiše nevrátí zpět.
  • Přejmenování souboru .bbart na disku změní pouze zobrazovaný název. library_id a obsah zůstanou nedotčeny.
  • Stejný zobrazovaný název u dvou souborů nevadí, pokud se jejich library_id liší.

Související

On this page