Module app

The application: owns the project, undo stack, settings, player, dockable layout and wires the panels together. Non-blocking windows (Settings, Retime, Export, Save Template, Save Profile, export/convert progress) are plain egui::Windows — the editor stays usable while they are open. Also executes MCP tool calls against the live project (one undo step per mutating call).

Structs

App

Compress 🔒

Compress… window state: what to shrink, how hard, and where the result goes.

LibPreview 🔒

The library’s own preview player: a file, its own decoder/audio pipeline, and the duration/fps a transport needs (an asset’s own probed values, since this project is a synthetic single-clip one).

McpJob 🔒

A blocking MCP tool job (export.video / media.convert): the reply is sent when the job finishes.

Enums

ExportKind 🔒

Constants

LAYOUT_STEP 🔒

Marker in the undo stack for “a pane was dragged somewhere else”. The arrangement itself lives in Layout’s own (much shorter) history — this only keeps Ctrl+Z stepping back in the right order. ponytail: once the layout history has scrolled past its 20 entries the marker undoes nothing; deepen the layout stack if that ever bites.

MEDIA_EXTS 🔒

MUTATING_TOOLS 🔒

Tools whose success means “one undo step + after_edit” (media.import pushes its own undo).

PROJECT_EXT 🔒

STOCK 🔒

The embedded stock picture, already decoded: assets/bubble.webp converted once to raw RGBA at card size, because nothing in the binary can decode a webp (no image crate, and ffmpeg may be missing).

STOCK_H 🔒

STOCK_W 🔒

Functions

GetCursorPos^⚠

add_mask 🔒

Give the clip’s last effect a mask, or the clip itself when it has no effects. False = there is one already, or the clip is audio (a mask shapes pixels, and audio has none).

anim_of 🔒

The animated property name of a clip: inspector labels or “: ”.

apply_clip_fields 🔒

Apply clip.set fields to a clip (everything except speed/reverse, which the caller routes through Project::set_speed so neighbour collisions are respected).

apply_mask_fields 🔒

arg_bool 🔒

arg_f64 🔒

arg_ids 🔒

arg_str 🔒

arg_u64 🔒

base64 🔒

Standard base64 (RFC 4648, with padding) — for the render.frame PNG data url. Tool path, not hot.

clamp_canvas 🔒

preview_max_width applied to a canvas size, keeping the aspect ratio. Must match Player::set_canvas, or the GPU renders at a different shape than the player decodes at.

color_arg 🔒

converted_path 🔒

Where “Convert To…” writes: <stem>_converted.<ext> next to the source, uniquified so a convert can never overwrite the source itself or a file already on disk (possibly one the timeline is using).

effect_thumb_key 🔒

Cache key of one effect thumbnail: kind, source image and size. Changing the stock image (or the grid size) invalidates every thumbnail; two different effects never share a key.

effect_thumb_source 🔒

The picture the effect thumbnails are rendered from: the user’s stock image, else the embedded one.

frame_render_size 🔒

Render size for an image export: downscales are rendered straight at the target (the compositor’s Scaler does the filtering), upscales are rendered at project size and enlarged by ffmpeg with the chosen resize flag — rendering a 4K frame from a 1080p timeline gains nothing but time.

guarded 🔒

Run something that may panic (GPU driver, pre-render, a panel widget) without taking the editor down — same policy as the decoder threads. None = it panicked. ponytail: the panic message goes to the default hook (stderr); the caller toasts and degrades.

job_window 🔒

Non-blocking progress window for background jobs (conversions, downloads): one row per job with a progress bar and Cancel. Draws nothing when there are no jobs.

mask_shape 🔒

mask_slot 🔒

The mask slot of a clip, or of one of its effects (effect = index in the effect stack).

node_kind 🔒

“Blur” / “Color” / “Blend” / “Combine” / “Merge” / “Matte” / “Mask” / “Text” / “Input” → a node kind.

parse_ease 🔒

“Linear” | “EaseIn” | … | “cubic-bezier(x1,y1,x2,y2)”

preview_canvas 🔒

Preview render size for a pane of canvas px at quality percent (25..100). Zero stays zero (nothing to render), and the aspect ratio is kept.

push_undo_json 🔒

Push an undo snapshot (capped) and clear the redo history.

relocate_assets 🔒

Moved/renamed sources: re-point assets to project_dir/<file name> when that exists (a silent black preview is the alternative); returns the paths that are still missing.

req 🔒

scrub_time 🔒

Time a library preview scrub-bar click/drag at fractional position frac (0..1 across the bar, unclamped so a drag past either end still reads as 0 or duration) seeks to.

step_time 🔒

Time the library preview’s “step back/forward one frame” buttons seek to.

timeline_is_empty 🔒

Nothing to save/export: the MAIN timeline is empty. Project::is_empty() only sees the open sequence, and main_stash is Some exactly while one is open — so this is export_project().is_empty() without the clone.

write_image 🔒

Write one rendered frame as PNG / JPG / WebP through ffmpeg (raw RGBA on stdin), resizing to opts.size with opts.resize when the render came out at a different size.