5.9 KiB
Menus and preferences
Midra Layout · Guide contents · Starter files
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 Midra Layout. See the theme catalog and settings contract
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:
- Linux:
$XDG_CONFIG_HOME/midra-layout/settings.json, or~/.config/midra-layout/settings.jsonwhen 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 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.