2bc41aeb8602
lib.rs
//! VectorCraft's egui frontend: menus, tools, panels and dialogs over `vectorcraft-engine`.
//!
//! The UI is thin: every action goes through [`VectorcraftApp::run`], which dispatches UI commands
//! (view/window) here and everything else to the engine. The same entry point serves menus,
//! shortcuts, the command palette ([`palette`], Help › Search Commands…) and the control channel ([`control`]).
#![forbid(unsafe_code)]
/// VectorCraft as craft-update knows it, with its 128 px icon and accent colour: the update
/// prompt shows both, and an AppImage's menu entry gets the icon.
#[cfg(not(target_arch = "wasm32"))]
pub const UPDATE_APP: craft_update::app::App = craft_update::app::App {
icon_png: Some(include_bytes!("../../../assets/app-icon/hicolor/128x128/apps/ai.storyteller.vectorcraft.png")),
accent: Some([0xe8, 0x57, 0x3f]),
..craft_update::suite::VECTORCRAFT
};
/// Translate a UI string literal into the language the UI is drawn in (see [`i18n`]).
#[macro_export]
macro_rules! tl {
($s:expr) => {
$crate::i18n::t($s)
};
}
pub mod addons;
pub mod background;
mod brand;
pub mod canvas;
pub mod chrome;
mod clipboard_probe;
pub mod community;
pub mod control;
pub mod credits;
pub mod cursors;
mod custom_toolbars;
pub mod dialogs;
pub mod display_profile;
pub mod doc_windows;
pub mod dock;
mod edit_toolbar;
pub mod export_progress;
pub mod find_font;
pub mod font_menu;
mod frame_rate;
mod free_transform;
pub mod graphics;
pub mod hang_beacon;
pub mod i18n;
pub mod icon_data;
pub mod icons;
pub(crate) mod ime;
pub mod io;
pub mod keymap;
pub mod layout_migration;
pub mod menus;
pub mod native_menu;
pub mod opening;
mod original_editor;
#[doc(hidden)]
pub use original_editor::Choice as OriginalEditorChoice;
pub mod palette;
mod panel_docking;
pub mod panels;
pub mod picks;
pub mod place;
pub mod placing;
pub mod plugin_runs;
pub mod prefs_dialog;
pub mod print;
pub mod recovery;
pub mod render_worker;
pub mod screen_color;
pub mod script_runs;
pub mod scripts_menu;
mod scrub;
pub mod shortcut_editor;
pub mod shortcut_sheet;
pub mod shortcuts;
pub mod state;
pub mod stylus;
pub mod sysclip;
pub mod theme;
pub mod thumb_worker;
pub mod titlebar;
pub mod toasts;
pub mod toolbar;
mod tools_float;
pub mod touch;
pub mod trace_runs;
pub mod troubleshooting;
mod ui_fonts;
pub mod unsaved;
pub mod updates_ui;
pub mod widgets;
pub mod workspaces;
mod document_drag;
#[cfg(test)]
use tests::{
background as tests_background, folder as tests_folder, labels as tests_labels, picks as tests_picks, removeanchors as tests_removeanchors,
svg as tests_svg, synthetic as tests_synthetic, sysclip as tests_sysclip,
};
#[cfg(test)]
mod tests;
use std::sync::atomic::{AtomicBool, Ordering};
use std::sync::mpsc::Receiver;
use std::sync::{Arc, Mutex};
use serde_json::{Value, json};
use vectorcraft_engine::cmd::fileio;
use vectorcraft_engine::file_access::{self, AutomationRoots};
use vectorcraft_engine::{Session, ViewInfo};
pub use control::{ControlRequest, ControlResponse, Ticket as ControlTicket};
pub use state::{UiState, View};
pub use sysclip::{CLIPBOARD_PROBE_STOP_WAIT, ClipboardProbeFactory, ClipboardRead, MakeFlavour, SystemClipboard};
mod app;
mod caches;
mod clock;
mod services;
pub use app::MAX_RECENT_FONTS;
pub use caches::{CacheKey, CanvasCache, LivePaintGapsCache, Perf, PlacedKey, PrintTilingCache, SliceCache};
pub use clock::{now_ms, now_secs};
pub use craft_ui::docking::Monitor as DockMonitor;
#[cfg(test)]
pub(crate) use services::browsable_url;
pub use services::{
DownloadFn, ExistsFn, FileFilter, FilePick, Inbox, NativeInputHook, OpenUrlFn, PickOpen, PickSave, PickedInbox, ReadFn, RevealFn, SaveStreamFn,
SaveWriteFn, Services, WriteFn,
};
use state::{GeometryStamp, InputGeneration, PendingScreenshot, QueuedScreenshot};
pub(crate) use state::{InputFrame, take_frame_once};
pub use ui_fonts::on_missing_glyphs;
pub struct VectorcraftApp {
pub session: Session,
pub ui: UiState,
pub views: Vec<View>,
/// The document ([`vectorcraft_engine::DocState::uid`]) each of `views` belonged to at the last
/// [`VectorcraftApp::sync_views`], which puts the views back with their documents after
/// `document.move` reorders them (#5663).
pub(crate) view_uids: Vec<u64>,
/// The thread that checks the system clipboard for `system_paste` instead
/// ([`Services::clipboard_probe`]). It is declared before `services` so that it is dropped
/// first, waiting up to [`CLIPBOARD_PROBE_STOP_WAIT`] for its thread to let go of its handle: on
/// X11 the last clipboard handle alive hands what the app copied to the clipboard manager, and
/// that should be the app's own handle in `services`, dropped on the UI thread before the
/// process exits.
clipboard_probe: Option<clipboard_probe::Probe>,
pub services: Services,
pub canvas: CanvasCache,
/// The main window's display profile, which the canvas is drawn through
/// ([`display_profile`]); the desktop app reports what it reads into it.
pub display_profile: display_profile::DisplayProfile,
pub perf: Perf,
/// Docking state that lives for the session only.
pub(crate) dock_rt: panel_docking::Runtime,
/// macOS: the room the app bar keeps at its left for the window buttons over it, in points
/// (0 where the OS draws no buttons over the app bar).
pub titlebar_inset: f32,
/// Last applied effect (Effect → Apply Last Effect).
pub last_effect: Option<(String, serde_json::Value)>,
/// Last successful destructive Pathfinder operation, repeated on the current selection.
pub last_pathfinder: Option<String>,
/// Last confirmed Warp Options (bend, distortion, orientation) for the next new warp dialog.
pub last_warp: Option<serde_json::Value>,
/// The Character panel field that takes the keyboard focus when the panel next draws it
/// ([`panels::character::highlight`]).
pub(crate) character_focus: Option<panels::character::Field>,
/// Commands run through [`Self::run`] so far: the native menu bar reads its rows again when it
/// moves ([`native_menu::sync`]).
run_count: u64,
control_rx: Option<Receiver<ControlRequest>>,
/// A `ui.pointer` request taken from the channel while synthetic input sent before it was not
/// yet applied: it runs, ahead of the channel, on the first frame after that input is applied.
deferred_control: Option<ControlRequest>,
/// When synthetic input was last dropped before a UI pass took it, the sequence number of the
/// next control request ([`ControlRequest::next_seq`]): a `ui.pointer` request made before it
/// came after that input and is answered with an error.
synthetic_dropped_before: u64,
/// Window captures asked for and not answered yet.
pending_screenshots: Vec<PendingScreenshot>,
/// `ui.pointer` replies waiting for their events and the edit the tool computes on another
/// thread ([`control::Outcome::AfterToolEdit`]), with the numbers of those events.
pointer_replies: Vec<control::PendingPointerReply>,
/// Admitted captures whose settled frame has not come yet (issued one at a time).
queued_screenshots: Vec<QueuedScreenshot>,
screenshot_token: u64,
/// Bytes reserved by admitted captures (checked `width * height * 4`).
screenshot_reserved: usize,
/// Synthetic input events (from the control channel) injected one step per frame.
pub synthetic: Vec<egui::Event>,
styled: bool,
fonts_ready: bool,
/// The egui context the UI's textures were uploaded to (0: none yet; see
/// [`Self::adopt_context`]).
context: u64,
/// The current context, for the focus part of an injected batch's generation (set by
/// [`Self::adopt_context`]).
ui_ctx: Option<egui::Context>,
/// Installed fonts added to the UI's for characters its own fonts lack (CJK names…).
ui_fonts: ui_fonts::UiFonts,
pub(crate) updates_rt: updates_ui::Runtime,
/// The status bar's frame rate ([`frame_rate`]).
frame_rate: frame_rate::FrameRate,
/// Canvas rect of the last frame (screen points), for control-channel coordinate mapping.
pub canvas_rect: Option<egui::Rect>,
/// The UI zoom (egui's zoom factor, set by Preferences › User Interface › UI Scaling) of the
/// frame that laid out [`Self::canvas_rect`]; 1.0 before the first one. [`Self::canvas_xf`]
/// maps the document to that rect with it.
pub(crate) canvas_ui_zoom: f32,
/// An unfinished control-channel Rotate View gesture, kept only for this app instance.
pub(crate) control_rotate_press: Option<control::RotateViewPress>,
/// Hover position in document coordinates.
pub hover_doc: Option<vectorcraft_geom::Point>,
/// System clipboard: SVG to publish next frame, the last SVG we published (so pasting it back
/// uses the lossless internal clipboard) and what came with a paste (a Paste event's text, a
/// picture or file the host read: [`Self::paste_from_host`]).
clipboard_out: Option<String>,
clipboard_published: Option<String>,
pub(crate) clipboard_in: Option<vectorcraft_engine::cmd::clipboard::Flavour>,
/// The Copy or Cut whose formats go to the system clipboard ([`Self::publish_clipboard`]).
clipboard_publishing: sysclip::Publishing,
/// A URL to open through egui next frame (when the host has no `open_url` service).
pending_url: Option<String>,
/// `VECTORCRAFT_TITLEBAR` chose this window's frame (Linux and the BSDs), so Preferences › User
/// Interface › System Title Bar and VectorCraft Title Bar on Every Desktop do not apply while
/// it is set. `false` unless the host sets it.
pub titlebar_from_env: bool,
/// Windows and Linux: the window has no OS decorations, so the app bar is the title bar (drag,
/// double-click to maximize, caption buttons) and invisible edge zones resize the window.
pub custom_titlebar: bool,
/// Where the caption buttons go on the app bar while [`Self::custom_titlebar`] is on: the
/// desktop's window-button layout on Linux and the BSDs where the desktop leaves the frame to the
/// app, all three at the right otherwise.
pub caption_layout: titlebar::CaptionLayout,
/// The window has the desktop's own title bar: the OS or the window manager draws its frame,
/// icon and title. Set by the desktop app when it opens the window; `false` for embedders
/// without a window of their own.
pub desktop_frame: bool,
/// Linux and the BSDs: `VECTORCRAFT_TITLEBAR` is unset and the desktop would draw the window's
/// frame on this session with Preferences › User Interface › System Title Bar on or off while
/// VectorCraft Title Bar on Every Desktop is off, so the dialog says so under System Title Bar.
/// It stays `true` while VectorCraft Title Bar on Every Desktop gives the app the frame. Set by
/// the desktop app when it opens the window; `false` elsewhere.
pub desktop_keeps_frame: bool,
/// Last window title sent to the OS (`ViewportCommand::Title`, see `chrome::sync_window_title`):
/// sent again only when it changes, so idle frames don't spam the backend.
pub(crate) last_window_title: String,
/// Whether a screen mode put the window full screen (`chrome::sync_fullscreen`), so Normal
/// Screen Mode takes it back out, and leaves a window the user made full screen as it is.
pub(crate) fullscreen_for_mode: bool,
/// The graphics adapter the window renders with ("name (backend)"), as the host reports it:
/// shown in Help › About and `ui.inspect` for GPU bug reports. `None` when unknown.
pub graphics_adapter: Option<String>,
/// Where [`Self::run`] marks each command for the desktop app's hang report:
/// [`hang_beacon::BEACON`], or a test's own.
pub(crate) beacon: &'static hang_beacon::Beacon,
/// File → Place: picked files, the place cursor's thumbnails, the Control bar's image details.
pub place: place::PlaceState,
/// The Paste commands can paste from the system clipboard alone: it holds something to paste
/// (SVG without a `system_clipboard`) while the internal clipboard is empty. It enables the
/// Paste menu items.
pub(crate) system_paste: bool,
/// The modifiers held when an egui `PasteImage` asked the rich system clipboard to be read.
/// Consumed once by the next `tick`; storing the paste-time chord keeps a later pass's stale
/// modifiers from choosing Paste in Place instead of Paste (or the reverse).
pub(crate) clipboard_image_request: Option<egui::Modifiers>,
/// When `system_paste` was last checked in line (app time, s; at most once per frame).
system_paste_at: f64,
/// File dialogs shown off the UI thread and what runs again with their answers.
pub(crate) picks: picks::Picks,
pub(crate) original_editor: original_editor::Draft,
/// The screen color sampler shown and not answered yet, and where its color goes.
pub(crate) screen_sampler: Option<screen_color::Waiting>,
/// The look for fonts installed or removed meanwhile, running
/// ([`Self::refresh_installed_fonts`]): whether they were, and whether to wake the app for
/// the answer.
font_check: Option<(std::sync::mpsc::Receiver<bool>, bool)>,
/// When installed fonts were last checked in line (app time, s).
#[cfg(not(target_arch = "wasm32"))]
font_install_check_at: f64,
/// Keyboard pastes of something other than text (see [`shortcuts::PasteChord`]).
pub(crate) paste_chord: shortcuts::PasteChord,
/// Runs the frame's key presses against the keymap ([`shortcuts::handle`]).
pub(crate) dispatcher: craft_keymap::egui::Dispatcher,
/// Saves and exports running in the background (Preferences → File Handling).
pub background: background::Background,
/// Documents being read off the UI thread ([`opening`]).
pub opening: opening::Opening,
/// Heavy plug-in filters running off the UI thread ([`plugin_runs`]).
pub plugin_runs: plugin_runs::PluginRuns,
/// Files being read off the UI thread for Place ([`placing`]).
pub placing: placing::Placing,
/// Image Traces running off the UI thread ([`trace_runs`]).
pub trace_runs: trace_runs::TraceRuns,
/// The messages shown over the window ([`toasts`]).
pub toasts: toasts::Shown,
/// Data Recovery's timer and startup question ([`recovery`]).
pub recovery: recovery::Timer,
/// Modifiers the keyboard holds (from the host's input), given back after synthetic input.
host_modifiers: egui::Modifiers,
/// Key, text and clipboard events a floating panel's own OS window forwarded, for the main
/// window's next frame ([`Self::raw_input_hook`]), and the modifiers held in that window.
pub(crate) forwarded: Vec<egui::Event>,
pub(crate) forwarded_modifiers: Option<egui::Modifiers>,
/// The last frame held the forwarded modifiers: this one goes back to the keyboard's.
forwarded_modifiers_held: bool,
/// This host iteration's input carries forwarded keys: they are the main window's although
/// its OS window doesn't have the keyboard (see `shortcuts::handle`).
pub(crate) forwarded_frame: bool,
/// The forwarded keys of this host iteration hold a Copy or Cut: it copies the art, not text
/// selected in this window's labels (see `shortcuts::handle_clipboard`).
pub(crate) forwarded_clipboard: bool,
/// The key presses among this host iteration's forwarded keys: a Copy or Cut one of them runs
/// (F3 and F2 off macOS) copies the art, not text selected in this window's labels (see
/// `shortcuts::clipboard_key_to_labels`).
pub(crate) forwarded_presses: Vec<egui::Event>,
/// Synthetic input set the modifiers egui holds (see [`Self::raw_input_hook`]).
synthetic_modifiers: bool,
/// The marked text the system IME last sent (`None` once it commits or clears). When the Type
/// tool stops composing on its own (a click, a tool switch), the IME is told to drop it.
pub(crate) ime_marked: Option<String>,
/// Owner/generation/change-cause bookkeeping for the outgoing IME surrounding-text producer
/// (one tracker serves every viewport; see the crate's IME producer module).
pub(crate) ime_context: egui::ime_context::ImeContextTracker,
/// Incoming composition ownership is separate from outgoing receipt/generation bookkeeping.
/// Interrupted input stays stale until the exact request-bound native fence arrives.
pub(crate) ime_compositions: egui::ViewportIdMap<ime::IncomingComposition>,
pub(crate) ime_resets: egui::ViewportIdMap<ime::ResetGuard>,
/// The Type tool's IME caret geometry for this pass, recorded by the canvas. The descriptor
/// itself is written at the end of the pass ([`ime::end_of_pass`]), after dialogs, floating
/// panels and the palette, because any of them can move the owner, edit the text or cover the
/// canvas after the canvas drew.
pub(crate) ime_caret_rect: Option<(egui::Rect, egui::Rect)>,
/// The IME must drop its marked text (see [`Self::take_ime_discard`]).
pub(crate) ime_discard: bool,
/// Preferences were confirmed (see [`Self::take_prefs_changed`]).
pub(crate) prefs_changed: bool,
/// The export presets the Asset Export panel lists (`document.exportPresets.list`'s rows), built
/// again when the saved presets change ([`dialogs::screen_preset_list`]).
pub(crate) asset_export_presets: Value,
/// Whether the last frame's input reported a touch screen (Preferences › Devices › Touch Workspace).
pub touch_screen: bool,
/// A numeric field is being scrubbed: the document's edits meanwhile are one undo step
/// ([`scrub::begin_frame`]).
scrub_group: bool,
/// The undo step of the scrub in progress ([`vectorcraft_engine::Session::begin_undo_scope`]).
scrub_scope: Option<vectorcraft_engine::UndoScope>,
/// The folders control requests, and the input they inject, may read and write
/// (`--automation-read-root`, `--automation-write-root`); `None`: anywhere. See
/// [`Self::with_automation_roots`].
automation_roots: Option<Arc<AutomationRoots>>,
/// This frame carries input the control channel injected ([`Self::raw_input_hook`]): it runs
/// confined to [`Self::automation_roots`].
synthetic_frame: bool,
/// The plug-in install the approval dialog asks about, kept out of the dialog's fields, which
/// `ui.dialog.set` writes.
pub(crate) pending_plugin_install: Option<dialogs::plugin::PendingInstall>,
/// The file File › Open read that waits for the answer to its profile question
/// ([`dialogs::profile_mismatch`]), kept out of the dialog's fields.
pub(crate) pending_profile_open: Option<dialogs::profile_mismatch::PendingOpen>,
/// Files File › Open read while another one's profile question was open, each asking its own
/// question in turn.
pub(crate) queued_profile_opens: std::collections::VecDeque<dialogs::profile_mismatch::PendingOpen>,
/// The paths Choose… picked in a script's file dialog, kept out of the dialog's fields, which
/// `ui.dialog.set` writes.
pub(crate) script_picked: Vec<String>,
/// Choose… left out files past the most a script is given.
pub(crate) script_picked_left_out: bool,
/// The pen end the canvas saw last and the tool its eraser end stands in for
/// ([`stylus::sync_eraser_tool`]).
pub(crate) pen_end: stylus::PenEnd,
/// Host iterations (full or logic-only), advanced once in [`Self::begin_host_iteration`].
pub(crate) host_iteration: u64,
/// A test's clock for [`Self::tick`], replacing the monotonic [`now_secs`] so idle scheduling
/// can be driven one simulated frame at a time (production always leaves this `None`).
#[cfg(test)]
pub(crate) now_override: Option<f64>,
/// An error the next tool choice returns before the engine sees it ([`Self::try_select_tool`]),
/// so tests can drive a failed switch (production has no such field).
#[cfg(test)]
pub(crate) fail_next_tool_choice: Option<String>,
/// The host iteration [`Self::tick`] ran in (`None`: never): once per iteration, never per pass.
tick_iteration: Option<u64>,
/// The context, viewport and frame whose UI-phase input was already taken in this host
/// iteration: a discarded rerun and a second viewport pass must not replay a frame's events.
input_frames: Vec<InputFrame>,
/// The context, viewport and frame `shortcuts::handle` already took in this host iteration.
/// Interleaving root and auxiliary viewport passes cannot make an older frame look new again.
pub(crate) shortcuts_frames: Vec<InputFrame>,
/// The single-key tool shortcuts held down, the last held last, and the tool each goes back to
/// when it is let go ([`shortcuts::HeldTool`]).
pub(crate) held_tool: Vec<shortcuts::HeldTool>,
/// Alt held down on its own since a frame saw it go down ([`shortcuts::AltTap`]).
pub(crate) alt_tap: shortcuts::AltTap,
/// A key with a hold shortcut that waits for its release, and the keys whose repeats are held
/// back until they are let go ([`shortcuts::HoldKeys`]).
pub(crate) hold_keys: shortcuts::HoldKeys,
/// A synthetic batch is in the host's raw input and no settled UI pass has taken it yet.
synthetic_injected: bool,
/// The exact events of [`Self::synthetic_injected`], to remove them if the state they belong
/// to changed before a UI pass could take them.
injected_events: Vec<egui::Event>,
/// The document, dialog and focus an injected batch belongs to.
injected_generation: InputGeneration,
/// The end-of-pass observer was installed on the context.
injected_settle_hook: bool,
/// A settled UI pass consumed the injected batch (read by the next host iteration).
injected_settled: Arc<AtomicBool>,
/// A change of the window's content geometry (resize, DPI, zoom or surface), even back again.
geometry_epoch: u64,
/// The geometry stamp [`Self::geometry_epoch`] was last advanced for.
geometry_stamp: Option<GeometryStamp>,
}
No file is open. Choose one in the tree, or press Ctrl+O (⌘O on a Mac) to find one by name.
Syntax highlighting could not load. The unmodified read-only text remains available above.