John
e6eec33a42
* G13: TikTok, Instagram Reels and YouTube Shorts export presets Three Web & Social presets for short-form vertical video: H.264 1080×1920 (9:16), scaled to fill, at the sequence's frame rate, AAC 48 kHz stereo, with Loudness Normalization on at −14 LUFS and a −1 dBTP ceiling, the level the platforms play at; 10, 8 and 12 Mbps VBR. They share a short_form() helper; Social Vertical is unchanged. short_form_presets_are_vertical_and_loudness_normalized checks size, rate, scaling, bitrate, audio and loudness. Real exports measured −14.1 LUFS from both a −19 and a −8.4 LUFS source. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * G13: the short-form presets test checks each maximum bitrate CodeRabbit on #3721: assert max_bitrate_kbps (12, 10 and 16 Mbps) and the VBR 1 pass mode next to the target bitrate, so a change to the ceiling alone fails the test. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
FilmCraft export
The export pipeline renders sequence frames, encodes them and writes the selected container. See architecture for formats, settings, presets and queue behavior.
MP4 upload compatibility (#3459)
MP4 video exports finalize with the existing ISO BMFF muxer's fast-start layout: ftyp, then
moov metadata before mdat media data. This lets progressive players and upload services read
the track metadata before downloading the media. The choice follows the container, so it applies
to H.264, HEVC and AV1 MP4 exports with software or hardware encoders. QuickTime MOV and
audio-only export layouts are unchanged.
The muxer shifts media in place with a bounded copy buffer and updates sample offsets; it does
not load the entire disk export into memory. Disk outputs therefore need read and write access.
Callers supplying ExportSettings::output_file for MP4 video must reserve a readable, writable
file. Buffered writes are flushed before reads through that same handle. In-memory download
sinks use their existing seekable byte buffer. Read, write and seek failures propagate as export
errors.
Animated GIF transparency
Animated GIF supports the existing ExportSettings::alpha option (#3396). In Export mode,
choose Animated GIF and enable Video ▸ Include Alpha Channel. Engine and MCP exports use
file.exportMedia with "format": "gif", "alpha": true; queue entries and presets use the
same settings. The default remains off, flattening the picture over black.
GIF has binary transparency, not partial alpha. After rendering and scaling, RGBA8 alpha 0–127 becomes transparent and 128–255 becomes opaque. Visible pixels retain their straight RGB color before palette quantization; transparent pixels share a cleared color. This avoids darkening partially transparent edges, but cannot preserve smooth translucent edges or shadows. The UI displays the threshold alongside the checkbox.
The existing image GIF encoder writes the animation; no codec implementation is added.
Format reference: GIF89a, 31 July 1990, §23 Graphic Control Extension.
settings_tests::gif_alpha_threshold_and_disposal_roundtrip exports synthetic moving stripes
with alpha 0, 127, 128 and 255, followed by an empty frame. Decoding verifies transparency,
color, frame timing and removal of previous-frame pixels, with alpha both enabled and disabled.
When FFmpeg is installed, its independent decode must agree on every pixel's alpha and opaque color.
settings_tests::gif_palette_quantization_preserves_isolated_transparency_and_dark_pixels
checks two frames with more than 256 distinct post-conversion RGBA colors, forcing palette
reduction. A single transparent pixel moves between frames, surrounded by opaque black and
near-black pixels. Decoded alpha must match exactly; opaque RGB channels allow at most 16/255
quantization error. This test uses the Rust decoder and needs no FFmpeg installation.
Run the GIF export tests with cargo test -p filmcraft-export --lib gif_ -- --nocapture.
Run all export unit tests with cargo test -p filmcraft-export --lib.
filmcraft-ui-egui's export_ui::gif_export_exposes_binary_alpha_option uses the control
channel to select GIF, toggle alpha and inspect the explanatory label. Set
FILMCRAFT_UI_SNAPSHOT_DIR to render its Export-mode screenshot.