.bbart藝術庫
由使用者管理的可複用藝術作品集合。基於JSON、按內容去重、自包含。
.bbart檔案是一個藝術作品片段集合，用於在多個專案中重複使用：徽標、裝飾、常見形狀以及捕獲的選區。藝術庫面板可載入和編輯這些檔案。
與表示單個進行中設計的.lzrproj專案不同，.bbart檔案是經過組織的庫，專為共享、版本控制和重複使用而設計。
包含的內容
| 欄位 | 說明 |
|---|---|
library_id | UUID。用於唯一標識庫（不是根據檔名標識）。 |
name | 顯示名稱。可編輯。 |
items[] | 每個專案都有自己的id、型別、幾何資料、縮圖、標籤和類別。 |
專案型別
- 外部檔案：引用源影像或向量檔案。專案攜帶原始位元組（在庫內按內容雜湊去重）。
- 選區快照：從專案中捕獲的選區的扁平化版本。文本會扁平化為幾何圖形，接收方無需依賴字型。包含用於未來重新編輯的
source_text_metadata。
縮圖
每個專案都有一個由前端生成並打包到檔案中的縮圖。載入庫時無需即時渲染。
去重
在單個.bbart檔案內，相同的柵格位元組（按內容雜湊判斷）只儲存一次，並由多個專案引用。當你將同一影像重新匯入為多個專案時，這可以減小檔案大小。
如何讀取和寫入
- GUI：藝術庫面板可建立、載入、儲存、匯入和匯出。
- CLI：目前未提供。
Beam Bench開啟.bbart檔案後，檔案會在編輯期間保留在記憶體中。寫穿持久化：每個變更操作都會立即寫入磁碟。如果磁碟寫入失敗，則保留記憶體中的變更，庫會獲得一個save_error，並且在重試之前會阻止破坯性操作。
從舊版JSON遷移
舊版應用資料中的*.json庫會在首次啟動時自動遷移為同目錄下的.bbart檔案。原始.json檔案會保留。
共享庫
.bbart檔案具有可移植性。通過電子郵件傳送或上傳該檔案；接收方可使用藝術庫面板→載入將其開啟。
如果兩個.bbart檔案共享同一個library_id（例如你複製了其中一個），後載入的檔案會被重新對映，生成新的id，重寫檔案，並顯示警告。這樣可以防止id衝突被靜默發生。
邊界情況
- 儲存失敗（檔案許可權、檔案被鎖定或磁碟已滿）時，庫會顯示儲存錯誤，並在下一次儲存成功前停用破坯性操作。狀態不會被靜默回滾。
- 在磁碟上重新命名
.bbart檔案只會更改顯示名稱。library_id和內容保持不變。 - 兩個檔案使用相同的顯示名稱沒有問題，只要它們的
library_id不同即可。