Toolbar artwork

The toolbar can be the built-in ribbon (icons and labels drawn by SwizzinIRC) or your own picture with clickable regions laid over it. The second is called image mode.

Making toolbar graphics

1. Draw one picture of the whole toolbar, for example a 960×64 PNG. Any size up to 4000×1000 is accepted. Formats are PNG, JPEG, WebP or GIF, at most 512 KB each.
2. Optionally draw two more pictures of the same size showing the hover and pressed states.
3. Put them in Themes\<theme>\Graphics\, choose Rescan in Appearance → Import & folder, and apply the theme.
4. Choose Appearance → Customize toolbar…, set Style: Custom artwork, pick the images, and draw hotspots by dragging on the preview.
5. Give each hotspot a label, tooltip and action, then Save.

Image mode shows no brand block or labels of its own. Put them in the artwork.

Files

In toolbar-map.json:

• artwork, hover and pressed are files in the theme’s Graphics folder, written as Graphics/<name>.
• hover and pressed are full-size copies of the artwork showing the state; only the part under the hotspot is revealed. They are optional.
• reference gives the pixel size of the artwork the hotspots were drawn on.

Safety and recovery

• An invalid mapping is not partly applied. The theme’s own colours still load, the built-in toolbar stays, and the reason appears on the Themes tab.
• The editor warns when your toolbar cannot reach Reset appearance or Customize toolbar.
• Ctrl+Shift+A and the status bar’s Appearance… link always open Appearance, and /theme reset always works.
• Restore original toolbar in the editor loads the shipped b0r3d v1.0 mapping; choose Save to keep it.

See Hotspot mappings for the file format and the actions a button can run.