effectcraft/docs
bflatastic 736fa4ac3c Import: image sequences with a Sequence option, ranges, folders and missing frames (#297)
Image sequences were found only by the desktop media prober: one picked
numbered still brought its whole run, with no way to import just that
frame, picking every frame made one sequence item per frame, the browser
couldn't make sequences at all, and a gap in the numbering closed up
silently.

The engine now groups numbered stills itself (engine/src/sequence.rs):
one picked file brings its run from its folder, several picked files of
one run import as that range, a picked or dropped folder imports its
files with each run as a sequence, and Force Alphabetical Order takes
every image of that type in the folder by name. `file.import` takes
`sequence` (default on), `alphabetical` and `frameRate`; Replace Footage,
Reload, proxies and render outputs probe the same way. The media layer
probes one file; the browser lists its file table for the run and
registers every frame with its media pool.

File > Import > File... asks, like After Effects' "PNG Sequence"
checkbox, whether picked numbered stills import as a sequence, with
Force Alphabetical Order and the frame rate. Sequences are named
`shot_[0001-0250].png`.

Interpret Footage gains Missing Frames (Show Placeholder, colour bars as
in After Effects, the new default; Hold Previous Frame; Skip) and Start
Frame (the frame number at the footage's first frame: trims or pads the
head). Saved projects keep Skip, so their sequences play as before.

Form notes keep a readable width and the form fits its rows, so OK stays
in view. docs/footage.md explains importing footage and sequences.

Test: tests_sequence (engine: run, picked range, every frame, Sequence
off, folder, alphabetical, Interpret Footage Missing Frames / Start
Frame, Replace Footage and Reload), project sequence unit tests,
sequence_gaps_show_placeholders_hold_or_close_up (media),
import_dialog_offers_the_image_sequence_option and
dropped_frames_import_as_one_sequence_with_sequence_interpretation (UI).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 18:53:44 +07:00
..
brand Licensing: standard LICENSE files, NOTICE, ArtCraft brand terms 2026-10-04 10:05:24 -04:00
fidelity G2: improve editing reliability and Windows rendering fidelity 2026-10-06 00:00:31 -05:00
images M0.11: README rewrite with headless screenshots (hero, graph editor, effects, 3D, render queue) 2026-10-01 23:31:40 -04:00
agents.md Import: image sequences with a Sequence option, ranges, folders and missing frames (#297) 2026-10-09 18:53:44 +07:00
architecture.md Merge pull request #200 from EthanSuquet/fix/text-scale-continuous-raster 2026-10-09 00:21:56 -04:00
contributors.md About: contributor and model credits compiled in (grab bag + table, self-submitted names) (#228) 2026-10-07 21:16:47 -04:00
control-protocol.md Viewer: Snapping options pick which layer features snap (#253) 2026-10-08 17:14:05 +07:00
effects.md Merge main into M13.28 worktree 2026-10-04 02:57:55 -04:00
footage.md Import: image sequences with a Sequence option, ranges, folders and missing frames (#297) 2026-10-09 18:53:44 +07:00
gaps.md Docs: gaps.md records the #290 fixes 2026-10-09 17:21:13 +07:00
parity.md Import: image sequences with a Sequence option, ranges, folders and missing frames (#297) 2026-10-09 18:53:44 +07:00
plugins.md M13.12: docs (pdf README, parity, plug-ins), EPS Type 3 fonts reported 2026-10-03 09:51:22 -04:00
preferences.md Import: image sequences with a Sequence option, ranges, folders and missing frames (#297) 2026-10-09 18:53:44 +07:00
releasing.md Release: FreeBSD x86_64, Flatpak x86_64 + aarch64, AppImage zsync updates; README Downloads (#287) 2026-10-08 09:48:00 -04:00
testing.md Effects: the sim golden test accepts macOS 27's libm hash for Mr. Mercury (#232) 2026-10-08 13:36:09 +07:00
web.md Web: a lost graphics device says so and offers a reload (#225) 2026-10-08 12:38:11 +07:00