Beam Bench-dokumentasjon

.bbart-biblioteker for grafikk

Brukerstyrte samlinger med gjenbrukbar grafikk. JSON-baserte, innholdsdedupliserte og selvstendige.

En .bbart-fil er en samling grafikkelementer du vil gjenbruke på tvers av prosjekter: logoer, dekorasjoner, vanlige former og lagrede utvalg. Panelet Grafikkbibliotek laster inn og redigerer dem.

I motsetning til .lzrproj-prosjekter, som representerer ett enkelt pågående design, er .bbart-filer organiserte biblioteker laget for deling, versjonskontroll og gjenbruk.

Hva den inneholder

FeltMerknader
library_idUUID. Identifiserer biblioteket unikt, ikke basert på filnavnet.
nameVisningsnavn. Kan redigeres.
items[]Hvert element har sin egen id, type, geometri, miniatyrbilder, tagger og kategori.

Elementtyper

  • Ekstern fil: refererer til en kildebildefil eller vektorfil. Elementet inneholder de opprinnelige bytene, deduplisert etter innholdshash i biblioteket.
  • Øyeblikksbilde av utvalg: en flatet versjon av et utvalg hentet fra et prosjekt. Tekst flates ut til geometri, så mottakeren ikke er avhengig av en bestemt skrift. Inneholder source_text_metadata for fremtidig redigering av teksten.

Miniatyrbilder

Hvert element har et miniatyrbilde generert av frontend-en, inkludert i filen. Det kreves ingen gjengivelse i sanntid når biblioteket lastes inn.

Deduplisering

I én .bbart-fil lagres identiske rasterbytes, basert på innholdshash, én gang og refereres fra flere elementer. Dette reduserer filstørrelsen når du importerer det samme bildet på nytt som flere elementer.

Slik leser og skriver du

  • Grafisk grensesnitt: Panelet Grafikkbibliotek oppretter, laster inn, lagrer, importerer og eksporterer.
  • CLI: er for øyeblikket ikke tilgjengelig.

En .bbart-fil åpnes av Beam Bench og beholdes i minnet mens den redigeres. Gjennomgående lagring: Hver endrende handling skrives umiddelbart til disken. Hvis diskskrivingen mislykkes, beholdes endringen i minnet, biblioteket får en save_error, og destruktive operasjoner blokkeres til nytt forsøk.

Migrering fra eldre JSON

Eldre *.json-biblioteker i appdata migreres automatisk til tilhørende .bbart-filer ved første oppstart. Den opprinnelige .json-filen beholdes.

Dele biblioteker

En .bbart-fil er flyttbar. Send den på e-post eller last den opp, så åpner mottakeren den med panelet GrafikkbibliotekLast inn.

Hvis to .bbart-filer deler samme library_id, for eksempel fordi du kopierte den ene, blir den andre som lastes inn, tilordnet en ny id. En ny id opprettes, filen skrives om, og en advarsel vises. Dette hindrer at id-kollisjoner oppstår ubemerket.

Særtilfeller

  • Lagring kan mislykkes på grunn av filtillatelser, låst fil eller full disk. Biblioteket viser en lagringsfeil og deaktiverer destruktive operasjoner til neste lagring lykkes. Tilstanden rulles ikke tilbake i stillhet.
  • Hvis du endrer navnet på en .bbart-fil på disken, endres bare visningsnavnet. library_id og innholdet er intakt.
  • Det er greit at to filer har samme visningsnavn, så lenge library_id er forskjellig.

Relatert

On this page