Art Library
Saved artwork browser. Organize reusable clips into .bbart libraries and drop them into any project.
The Art Library is where you keep reusable artwork, logos, icons, decorations, anything you want to use in more than one project. Libraries are stored as .bbart files on disk, so they are easy to share and back up.
Opening it
- Default dock zone:
lower-right - Visible by default: no: open from the Window menu
- Hotkey: no default
What you see
Three regions, divided by draggable resizers:
- Left sidebar: list of loaded libraries. Click a library to make it active.
- Center: search bar, icon-size slider, then a grid of thumbnails.
- Bottom action bar: Library actions on the left, Graphic actions on the right.
Above the grid:
- Search...: text filter, matches against name, tags, and category (case-insensitive substring).
- Icon Size: [slider] X [readout]: range 96–160 px in 8 px steps. Readout shows current size (
128 x 128).
The grid shows thumbnails per item. Items without an auto-generated thumbnail use a symbol:
| Symbol | Meaning |
|---|---|
| ◫ | Selection snapshot (flattened geometry from a prior project) |
| ◇ | Vector graphic |
| ▣ | Raster graphic |
Selecting an item shows its details in a footer: name, dimensions (for selection snapshots only, e.g. 150.5 mm x 200.3 mm), and type (Graphic, Vector Graphic, Raster Graphic).
A red Save error banner appears if the library fails to write to disk (file permissions, locked file, etc.). Destructive operations are blocked until the save succeeds.
Buttons
Library section (bottom left)
| Button | Action |
|---|---|
| New | Open New Art Library dialog, creates a .bbart file. |
| Load | Open file dialog to load an existing .bbart file. |
| Unload | Unload the active library. Disabled if no library is loaded or in error state. |
Graphic section (bottom right)
| Button | Action |
|---|---|
| Add Graphic to Project | Insert the selected graphic into the current project. Disabled when no library / no item / no project. |
| Import Graphic from Project | Take the current project selection and add it to the library. |
| Import | Open file dialog to add artwork files: SVG, PNG, JPG, GIF, BMP, WebP, TIFF, TGA, DXF, PDF, AI, EPS. |
| Delete | Delete the selected graphic from the library. |
Context menus
Right-click in different places for different menus.
On a library (in the sidebar)
- Rename Library
- Save As...
- Delete (disabled in save error state)
On a graphic (in the grid)
- Insert into Project
- Add Selection to Library
- Rename
- Delete (disabled in save error state)
What you can do
Create a new library
- Click New.
- Save dialog opens, pick a location and name.
- The new (empty) library becomes active.
Add artwork to the library
Three ways:
- Import files from disk (SVG, raster, etc.).
- Import Graphic from Project: grab the current selection.
- Drag-and-drop files onto the grid from the OS file browser.
Insert artwork into your project
- Double-click a thumbnail, or
- Select it and click Add Graphic to Project, or
- Drag it onto the canvas.
Move artwork between libraries
Drag a thumbnail from the grid onto a library name in the sidebar.
- Default: copy.
- Hold Shift while dragging: move.
Resize thumbnails
Use the Icon Size slider. The change persists across sessions.
Behavior worth knowing
- Sidebar width, footer height, icon size, and action-bar height are persisted to local storage. Your layout choices stick.
- Search is a substring match on name, tags, and category, there is no advanced query syntax.
- When the library has a save error, destructive operations (Delete, Unload, Delete Library) are disabled until the next save succeeds. Mutations to in-memory state continue; they are not silently rolled back.
.bbartfiles are JSON. Snapshot items flatten text to geometry (no font dependency on the recipient's machine). Raster bytes are deduplicated by content hash within the library.- A
.bbartfile's display name and its internallibrary_id(UUID) are separate. Two files with the same display name on disk are fine as long as their internal IDs differ.
Related
- Settings, File & Import
- .bbart art libraries
- Cuts / Layers panel: where inserted artwork lands