106 lines
6.1 KiB
Markdown
106 lines
6.1 KiB
Markdown
# Menus and preferences
|
||
|
||
[Canvas Pilot](../README.md) · [Guide contents](README.md) · [Starter files](../../templates/canvas-pilot/README.md)
|
||
|
||
## Application menu
|
||
|
||
The header’s **Menu** brings the application’s commands together:
|
||
|
||
- **Project**: open/save JSON and export SVG.
|
||
- **Import**: SVG, clipboard layer values, and reference images.
|
||
- **Edit**: undo/redo, copy values, select all editable layers, or deselect.
|
||
- **View**: fit screen/selection, 1:1 pixels, output format, and reference settings.
|
||
- **Layers**: selected-layer properties, crop/reset, alignment, shared resizing,
|
||
lock/hide, and per-layer selection/visibility/lock controls.
|
||
- **Options**: resize aspect ratio and the source-coordinate preview.
|
||
|
||
The toolbar, cog and right-click shortcuts use the same commands and preferences.
|
||
Detailed numeric controls remain in their existing properties dialogs.
|
||
|
||
Enable **Options → Show toolbar icon names** (also available from the toolbar cog)
|
||
to display captions beneath the icons. It is off by default and saved with the
|
||
project; older projects open with captions off.
|
||
|
||
### Application themes
|
||
|
||
**Menu → Options → Theme** (also in the toolbar cog) shows up to three recently
|
||
used themes, newest first. **More themes…** opens the complete picker with color
|
||
swatches: Midra Dark plus all 18 themes from the SOTV song-database theme folder.
|
||
A fresh installation lists only Midra Dark until other themes are selected.
|
||
Selecting a theme updates the UI and viewport immediately and saves the recent
|
||
history across restarts. Reusing a theme moves it to the top without duplicates.
|
||
Closing the picker without choosing leaves the theme and history unchanged.
|
||
|
||
The viewport, grid, layer boxes and source test patterns use the selected palette;
|
||
selected layers remain gold (darker gold for contrast in light themes). Imported
|
||
reference images retain their colors. Theme and history survive opening projects
|
||
and are not included in project JSON or geometry exports.
|
||
|
||
The SOTV palettes are bundled with the app from
|
||
`sotv/song_database/styles/themes/` in the sibling `SOTV_Websites` repository;
|
||
Corporate Light uses `styles/base/variables.css`. No sibling repository is needed
|
||
to build or run Canvas Pilot. See the [theme catalog and settings contract](../../interfaces/canvas-pilot-settings.md)
|
||
for names, source files, stable IDs and palette adaptations.
|
||
|
||
### Saved application options
|
||
|
||
Options save automatically when changed: theme, toolbar icon names, aspect-ratio
|
||
lock and source-coordinate preview. No separate Apply or Save is needed.
|
||
The `directories` crate selects the OS configuration directory. Canvas Pilot retains
|
||
the former Midra Layout location so existing preferences and recovery remain available:
|
||
|
||
- Linux: `$XDG_CONFIG_HOME/midra-layout/settings.json`, or
|
||
`~/.config/midra-layout/settings.json` when XDG_CONFIG_HOME is unset.
|
||
- Windows: `%APPDATA%\beffroi\midra-layout\config\settings.json`.
|
||
- macOS: `~/Library/Application Support/org.beffroi.midra-layout/settings.json`.
|
||
|
||
Hover **Options save automatically** in Options to see the actual path. These are
|
||
startup defaults. Existing project files still restore their saved aspect-ratio,
|
||
caption and source-preview settings for the open document, without rewriting the
|
||
application defaults. A subsequent explicit Options change saves the current set
|
||
of options as the new defaults. Theme always remains an application preference.
|
||
|
||
Missing settings use defaults; the file is created on the first option change.
|
||
Unreadable, malformed or unsupported settings use defaults and show an Options
|
||
error; the original file is preserved and saving is disabled until the file is
|
||
repaired or moved and the application restarted. Write failures keep options
|
||
active in memory and offer **Retry saving options**. No project data, images or
|
||
clipboard contents are stored here. The [settings interface](../../interfaces/canvas-pilot-settings.md)
|
||
documents the file and compatibility rules.
|
||
|
||
**Keep aspect ratio when resizing** is also available below the position/size
|
||
fields in the selected layer's right panel and in the layer
|
||
right-click menu (including multiple selections). These controls share the
|
||
Options setting and save changes automatically. They do not apply or discard
|
||
pending size/position edits. Crop zoom remains proportional.
|
||
|
||
## Settings window
|
||
|
||
Open **Menu → Open all settings…**, **Options → Open all settings…**, the toolbar cog's
|
||
**Open all settings…** entry, or **Ctrl/Cmd+,**. The window groups the available controls:
|
||
|
||
- **Appearance:** themes, recent choices, icon captions and source-coordinate preview.
|
||
- **Editing:** aspect-ratio lock, movement snapping and a keyboard/mouse reference.
|
||
- **Reference images:** import and access to the current project's image settings.
|
||
- **Files & settings:** the settings-file path, copy-path action and restore defaults.
|
||
- **Midra integration:** current offline status and compatibility limitations.
|
||
|
||
Changes apply and save immediately, sharing state with quick menus and inspector
|
||
shortcuts. Close simply dismisses the window. Restore defaults resets preferences
|
||
without altering geometry or pending position/size edits. Device controls are not
|
||
presented as implemented until their mapping and transport are available.
|
||
|
||
### Movement snapping
|
||
|
||
The viewport right-click menu and quick Options menu both include **Snapping**:
|
||
enable movement/resizing snapping and choose pixel, screen or visible-layer edges.
|
||
These are the same automatically saved controls as Settings → Editing.
|
||
|
||
Enable **Settings → Editing → Snap movement & resizing** and choose pixel,
|
||
screen-edge and/or other-visible-layer-edge targets. Nearby edges show a guide;
|
||
the proximity radius stays six logical pixels at any zoom. A selection moves as
|
||
a rigid group. Hidden layers are ignored; visible locked layers can be targets.
|
||
Hold **Alt** to temporarily invert snapping: off when enabled, on when disabled. Turning snapping on/off alone never moves layers.
|
||
Exact numeric entry and nudges bypass proximity snapping; resize handles snap while preserving their anchors/ratios, and crop-content
|
||
handles retain their existing behavior. One drag remains one undo step, with Escape to cancel.
|