frameyard 0.7.0 → 0.9.0

package/dist/renderer/ffmpeg.js

@@ -1,6 +1,9 @@
 import { spawn } from "node:child_process";
 import { writeFile } from "node:fs/promises";
 import { FrameyardError } from "../errors.js";
+import { evaluatePresentation } from "../timeline/keyframes.js";
+import { transitionProgress } from "../timeline/transitions.js";
+import { keyframeChannelExpression, transitionGainExpression, transitionProgressExpression, } from "./keyframe-expressions.js";
 const STDERR_LIMIT = 16 * 1024;
 function captureTail(child) {
     let tail = "";
@@ -302,8 +305,7 @@ export async function probeMedia(filePath, options = {}) {
         throw new FrameyardError("FFPROBE_FAILED", `Could not parse ffprobe output for ${filePath}.`, { cause: error });
     }
 }
-/** Normalizes any decodable source to the 16 kHz mono PCM WAV that whisper.cpp expects. */
-export async function normalizeAudioForTranscription(options) {
+async function normalizeAudio(options) {
     await runCaptured("ffmpeg", [
         "-hide_banner",
         "-loglevel",
@@ -318,12 +320,20 @@ export async function normalizeAudioForTranscription(options) {
         "-ac",
         "1",
         "-ar",
-        "16000",
+        String(options.sampleRate),
         "-c:a",
         "pcm_s16le",
         options.outputPath,
     ], { signal: options.signal });
 }
+/** Normalizes any decodable source to the 16 kHz mono PCM WAV that whisper.cpp expects. */
+export async function normalizeAudioForTranscription(options) {
+    await normalizeAudio({ ...options, sampleRate: 16_000 });
+}
+/** Normalizes generated speech to the 24 kHz mono PCM WAV that Frameyard publishes. */
+export async function normalizeSpeechAudio(options) {
+    await normalizeAudio({ ...options, sampleRate: 24_000 });
+}
 export async function mixAudioTimeline(options) {
     if (options.clips.length === 0) {
         throw new FrameyardError("AUDIO_INVALID", "Cannot mix an empty audio timeline.");
@@ -340,10 +350,22 @@ export async function mixAudioTimeline(options) {
             trim.push(`duration=${formatNumber(clip.trimDuration)}`);
         }
         const delayMs = Math.round((clip.startFrame * 1000) / options.fps);
+        const gain = clip.volumeEnvelopes?.length
+            ? clip.volumeEnvelopes
+                .map((envelope) => transitionGainExpression({
+                progressExpression: `((${formatNumber(clip.startFrame)}+t*${formatNumber(options.fps)}-${formatNumber(envelope.startFrame)})/${formatNumber(envelope.endFrame - envelope.startFrame)})`,
+                ...(envelope.easing !== undefined ? { easing: envelope.easing } : {}),
+                role: envelope.role,
+            }))
+                .join("*")
+            : undefined;
+        const volume = gain === undefined
+            ? `volume=${formatNumber(clip.volume)}`
+            : `volume='${formatNumber(clip.volume)}*(${gain})':eval=frame`;
         const chain = [
             `atrim=${trim.join(":")}`,
             "asetpts=PTS-STARTPTS",
-            `volume=${formatNumber(clip.volume)}`,
+            volume,
             "aresample=48000",
             "aformat=sample_fmts=fltp:channel_layouts=stereo",
             "apad",
@@ -492,6 +514,44 @@ export async function startVideoEncoder(options) {
         abort,
     };
 }
+/**
+ * Builds FFmpeg's narrow layer input from a projected scene layer. The mapper
+ * owns the scene-to-filter boundary; capture chooses the artifact and its input
+ * mode, while the scene owns presentation, keyframes, and transition roles.
+ */
+export function sceneLayerToCompositeLayer(layer, artifact) {
+    const transform = layer.transform;
+    const transition = layer.transition;
+    return {
+        input: artifact.input,
+        path: artifact.path,
+        sourceWidth: layer.sourceWidth,
+        sourceHeight: layer.sourceHeight,
+        ...(transform.width !== undefined && transform.height !== undefined
+            ? { width: transform.width, height: transform.height }
+            : {}),
+        fit: transform.fit,
+        x: transform.x,
+        y: transform.y,
+        scale: transform.scale,
+        rotation: transform.rotation,
+        opacity: transform.opacity,
+        blend: layer.blend,
+        ...(artifact.sourceStartFrame !== undefined ? { sourceStartFrame: artifact.sourceStartFrame } : {}),
+        ...(layer.keyframes !== undefined ? { keyframes: layer.keyframes } : {}),
+        clipStart: layer.clip.start,
+        ...(transition !== undefined
+            ? {
+                transition: {
+                    role: transition.role,
+                    start: transition.window.start,
+                    end: transition.window.end,
+                    ...(transition.window.easing !== undefined ? { easing: transition.window.easing } : {}),
+                },
+            }
+            : {}),
+    };
+}
 function ffmpegBackgroundColor(value) {
     if (value === "transparent") {
         return "black@0.0";
@@ -533,47 +593,206 @@ function fitFilter(layer, stageWidth, stageHeight) {
     const fittedHeight = Math.max(1, Math.round(sourceHeight * scale));
     return `scale=${fittedWidth}:${fittedHeight},pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2:color=black@0`;
 }
-function layerFilter(layer, stageWidth, stageHeight, fps) {
-    const filters = [
+function layerTransform(layer) {
+    return {
+        fit: layer.fit,
+        x: layer.x,
+        y: layer.y,
+        ...(layer.width !== undefined && layer.height !== undefined ? { width: layer.width, height: layer.height } : {}),
+        scale: layer.scale,
+        rotation: layer.rotation,
+        opacity: layer.opacity,
+    };
+}
+function hasKeyframe(layer, channel) {
+    return layer.keyframes?.[channel] !== undefined;
+}
+/** The incoming layer's animated alpha at an absolute timeline frame. */
+function transitionAlphaAt(layer, frame) {
+    if (layer.transition?.role !== "in") {
+        return 1;
+    }
+    return transitionProgress(layer.transition, frame);
+}
+/** False when a keyed or transitioning layer is invisible for every frame of the range. */
+function isLayerVisibleInRange(layer, frameOffset, frames) {
+    const animated = hasKeyframe(layer, "opacity") || hasKeyframe(layer, "scale");
+    if (!animated && layer.transition?.role !== "in") {
+        return layer.opacity > 0 && layer.scale > 0;
+    }
+    const transform = layerTransform(layer);
+    const clipStart = layer.clipStart ?? 0;
+    for (let index = 0; index < frames; index += 1) {
+        const frame = frameOffset + index;
+        const values = evaluatePresentation(transform, layer.keyframes, frame - clipStart);
+        if (values.opacity * transitionAlphaAt(layer, frame) > 0 && values.scale > 0) {
+            return true;
+        }
+    }
+    return false;
+}
+function baseLayerFilters(layer, stageWidth, stageHeight, fps) {
+    return [
         // Matroska and WebM timestamps can be quantized to milliseconds. Normalize
         // every timed layer to the project frame rate before overlay framesync so
         // it does not duplicate or drop frames. Still images are already static.
-        ...(layer.kind === "image" ? [] : [`fps=${formatNumber(fps)}`]),
+        ...(layer.input === "image" ? [] : [`fps=${formatNumber(fps)}`]),
         fitFilter(layer, stageWidth, stageHeight),
         "format=rgba",
     ];
-    if (layer.scale !== 1) {
-        filters.push(`scale=iw*${formatNumber(layer.scale)}:ih*${formatNumber(layer.scale)}`);
+}
+/** Dimensions entering the rotate filter for this layer. */
+function rotationInputSize(layer, stageWidth, stageHeight) {
+    const width = layer.width ?? stageWidth;
+    const height = layer.height ?? stageHeight;
+    if (layer.keyframes?.scale !== undefined) {
+        // Animated scale is applied after rotation, keeping the rotate input fixed.
+        return { width, height };
+    }
+    return {
+        width: Math.max(1, Math.ceil(width * layer.scale)),
+        height: Math.max(1, Math.ceil(height * layer.scale)),
+    };
+}
+function rotatedBounds(width, height, degrees) {
+    const radians = (degrees * Math.PI) / 180;
+    const cosine = Math.abs(Math.cos(radians));
+    const sine = Math.abs(Math.sin(radians));
+    // Two extra pixels absorb filter rounding and anti-aliased edge pixels.
+    return {
+        width: Math.max(1, Math.ceil(width * cosine + height * sine) + 2),
+        height: Math.max(1, Math.ceil(width * sine + height * cosine) + 2),
+    };
+}
+/**
+ * FFmpeg's rotate filter clips to a fixed output size. A keyed rotation uses a
+ * square diagonal bound so every segment uses the same size and corners stay
+ * visible at any angle. Static rotation uses its exact bounding box.
+ */
+function rotationOutputSize(layer, stageWidth, stageHeight) {
+    const input = rotationInputSize(layer, stageWidth, stageHeight);
+    if (layer.keyframes?.rotation) {
+        const diagonal = Math.max(1, Math.ceil(Math.hypot(input.width, input.height)) + 2);
+        return { width: diagonal, height: diagonal };
+    }
+    return rotatedBounds(input.width, input.height, layer.rotation);
+}
+function needsOpacityMask(layer) {
+    return hasKeyframe(layer, "opacity") || hasKeyframe(layer, "scale") || layer.transition?.role === "in";
+}
+/**
+ * Presentation filters after the optional opacity mask. Animated scale is
+ * applied after rotation because uniform scale and rotation commute; rotation
+ * then keeps a fixed input size for the rotate filter.
+ */
+function presentationLayerFilters(layer, stageWidth, stageHeight, frameOffset) {
+    const filters = [];
+    const clipStart = layer.clipStart ?? 0;
+    const frameOptions = { frameVariable: "n", frameOffset, clipStart };
+    const scaleKeys = layer.keyframes?.scale;
+    const rotationKeys = layer.keyframes?.rotation;
+    const opacityKeys = layer.keyframes?.opacity;
+    const addRotation = () => {
+        if (rotationKeys || layer.rotation !== 0) {
+            const output = rotationOutputSize(layer, stageWidth, stageHeight);
+            const outputSize = `ow=${output.width}:oh=${output.height}`;
+            if (rotationKeys) {
+                const angle = keyframeChannelExpression("rotation", rotationKeys, frameOptions);
+                filters.push(`rotate=angle='(${angle})*PI/180':fillcolor=black@0:${outputSize}`);
+            }
+            else {
+                filters.push(`rotate=angle=${formatNumber(layer.rotation)}*PI/180:fillcolor=black@0:${outputSize}`);
+            }
+        }
+    };
+    if (scaleKeys) {
+        addRotation();
+        const scale = keyframeChannelExpression("scale", scaleKeys, frameOptions);
+        filters.push(`scale=w='max(1,iw*(${scale}))':h='max(1,ih*(${scale}))':eval=frame`);
     }
-    if (layer.rotation !== 0) {
-        filters.push(`rotate=angle=${formatNumber(layer.rotation)}*PI/180:fillcolor=black@0`);
+    else {
+        if (layer.scale !== 1) {
+            filters.push(`scale=iw*${formatNumber(layer.scale)}:ih*${formatNumber(layer.scale)}`);
+        }
+        addRotation();
     }
-    if (layer.opacity < 1) {
+    // A transitioning layer carries its opacity in the animated mask instead.
+    if (!opacityKeys && !scaleKeys && layer.transition?.role !== "in" && layer.opacity < 1) {
         filters.push(`colorchannelmixer=aa=${formatNumber(layer.opacity)}`);
     }
-    return filters.join(",");
+    return filters;
 }
-/** Encode a numbered PNG sequence into a lossless alpha-preserving FFV1 file. */
-export async function encodePngSequenceToFfv1(options) {
-    await runCaptured("ffmpeg", [
-        "-y",
-        "-v",
-        "error",
-        "-framerate",
-        formatNumber(options.fps),
-        "-i",
-        options.pattern,
-        "-c:v",
-        "ffv1",
-        "-level",
-        "3",
-        "-pix_fmt",
-        "bgra",
-        options.outputPath,
-    ], { signal: options.signal });
+/** Builds the animated alpha mask at the fitted box size. */
+function opacityMaskFilter(options) {
+    const { layer, stageWidth, stageHeight, frameOffset, inputIndex, outputLabel } = options;
+    const clipStart = layer.clipStart ?? 0;
+    const frameOptions = { frameVariable: "N", frameOffset, clipStart };
+    const opacityKeys = layer.keyframes?.opacity;
+    const scaleKeys = layer.keyframes?.scale;
+    const opacity = opacityKeys
+        ? keyframeChannelExpression("opacity", opacityKeys, frameOptions)
+        : formatNumber(layer.opacity);
+    const scale = scaleKeys ? keyframeChannelExpression("scale", scaleKeys, frameOptions) : undefined;
+    const visible = scale !== undefined ? `if(gt(${scale},0),1,0)` : "1";
+    const transition = layer.transition?.role === "in"
+        ? transitionProgressExpression({
+            frameVariable: "N",
+            frameOffset,
+            start: layer.transition.start,
+            end: layer.transition.end,
+            ...(layer.transition.easing !== undefined ? { easing: layer.transition.easing } : {}),
+        })
+        : undefined;
+    const alpha = `min(1,max(0,(${opacity})*(${visible})${transition !== undefined ? `*(${transition})` : ""}))`;
+    const width = layer.width ?? stageWidth;
+    const height = layer.height ?? stageHeight;
+    return `[${inputIndex}:v]format=rgba,geq=r=0:g=0:b=0:a='255*${alpha}',scale=${width}:${height}:flags=neighbor,format=rgba[${outputLabel}]`;
 }
-/** Composites one timeline segment into H.264 or an alpha-preserving FFV1 file. */
-export async function compositeTimelineSegment(options) {
+/** W3C soft-light in 0-255 space; FFmpeg's native mode uses a different formula. */
+const SOFT_LIGHT_EXPRESSION = "if(lt(B,128), A-(1-2*B/255)*A*(1-A/255), A+(2*B/255-1)*(if(lt(A,64),((16*A/255-12)*A/255+4)*A/255,sqrt(A/255))*255-A))";
+const BLEND_FILTER_NAMES = {
+    multiply: "multiply",
+    screen: "screen",
+    overlay: "overlay",
+    darken: "darken",
+    lighten: "lighten",
+    "color-dodge": "dodge",
+    "color-burn": "burn",
+    "hard-light": "hardlight",
+    difference: "difference",
+    exclusion: "exclusion",
+};
+function blendSpec(mode) {
+    if (mode === "soft-light") {
+        return {
+            options: `c0_expr='${SOFT_LIGHT_EXPRESSION}':c1_expr='${SOFT_LIGHT_EXPRESSION}':c2_expr='${SOFT_LIGHT_EXPRESSION}':c3_mode=normal`,
+            sourceFirst: false,
+        };
+    }
+    const name = BLEND_FILTER_NAMES[mode];
+    return {
+        options: `c0_mode=${name}:c1_mode=${name}:c2_mode=${name}:c3_mode=normal`,
+        sourceFirst: mode === "color-dodge" || mode === "color-burn",
+    };
+}
+function placementFilter(layer, frameOffset) {
+    const clipStart = layer.clipStart ?? 0;
+    const frameOptions = { frameVariable: "n", frameOffset, clipStart };
+    const xKeys = layer.keyframes?.x;
+    const yKeys = layer.keyframes?.y;
+    const x = xKeys ? keyframeChannelExpression("x", xKeys, frameOptions) : formatNumber(layer.x);
+    const y = yKeys ? keyframeChannelExpression("y", yKeys, frameOptions) : formatNumber(layer.y);
+    if (!xKeys && !yKeys) {
+        return `x=(main_w-overlay_w)/2+${x}:y=(main_h-overlay_h)/2+${y}`;
+    }
+    return `x='(main_w-overlay_w)/2+(${x})':y='(main_h-overlay_h)/2+(${y})':eval=frame`;
+}
+/**
+ * Builds the FFmpeg filter graph for one timeline composite. Blend layers are
+ * placed on a transparent stage-sized canvas, blended with the accumulated
+ * backdrop, masked by the source alpha, and composited source-over.
+ */
+function buildCompositeGraph(options) {
     const durationSeconds = options.frames / options.fps;
     const args = [
         "-y",
@@ -590,27 +809,126 @@ export async function compositeTimelineSegment(options) {
     let current = "base0";
     let inputIndex = 0;
     let includedIndex = 0;
+    const blendedLayers = options.layers.filter((layer) => layer.blend !== "normal" && isLayerVisibleInRange(layer, options.frameOffset, options.frames));
+    const canvasLabels = [];
+    if (blendedLayers.length > 0) {
+        args.push("-f", "lavfi", "-i", `color=c=black@0.0:s=${options.width}x${options.height}:r=${formatNumber(options.fps)}:d=${formatNumber(durationSeconds)}`);
+        inputIndex += 1;
+        for (let index = 0; index < blendedLayers.length; index += 1) {
+            canvasLabels.push(`cv${index}`);
+        }
+        const canvasChain = `[${inputIndex}:v]format=rgba,colorchannelmixer=aa=0`;
+        filters.push(canvasLabels.length === 1
+            ? `${canvasChain}[${canvasLabels[0]}]`
+            : `${canvasChain},split=${canvasLabels.length}${canvasLabels.map((label) => `[${label}]`).join("")}`);
+    }
+    let canvasIndex = 0;
     for (const layer of options.layers) {
-        if (layer.opacity <= 0 || layer.scale <= 0) {
+        if (!isLayerVisibleInRange(layer, options.frameOffset, options.frames)) {
             continue;
         }
-        if (layer.kind === "video") {
+        const masked = needsOpacityMask(layer);
+        let maskInput = 0;
+        if (masked) {
+            args.push("-f", "lavfi", "-i", 
+            // FFmpeg 6 rejects a 1x1 yuv420p source (chroma planes round to zero).
+            `color=c=black@0.0:s=2x2:r=${formatNumber(options.fps)}:d=${formatNumber(durationSeconds)}`);
+            inputIndex += 1;
+            maskInput = inputIndex;
+        }
+        if (layer.input === "video") {
             const startSeconds = (layer.sourceStartFrame ?? 0) / options.fps;
-            args.push("-ss", formatNumber(startSeconds), "-t", formatNumber(durationSeconds), "-i", layer.path, "-an");
+            if (options.segment) {
+                args.push("-ss", formatNumber(startSeconds), "-t", formatNumber(durationSeconds), "-i", layer.path, "-an");
+            }
+            else {
+                args.push("-ss", formatNumber(startSeconds), "-i", layer.path, "-an");
+            }
         }
-        else if (layer.kind === "image") {
-            args.push("-loop", "1", "-framerate", formatNumber(options.fps), "-t", formatNumber(durationSeconds), "-i", layer.path, "-an");
+        else if (layer.input === "image") {
+            if (options.segment) {
+                args.push("-loop", "1", "-framerate", formatNumber(options.fps), "-t", formatNumber(durationSeconds), "-i", layer.path, "-an");
+            }
+            else {
+                args.push("-i", layer.path, "-an");
+            }
         }
         else {
             args.push("-i", layer.path);
         }
         inputIndex += 1;
         includedIndex += 1;
-        filters.push(`[${inputIndex}:v]${layerFilter(layer, options.width, options.height, options.fps)}[l${includedIndex}]`);
-        filters.push(`[${current}][l${includedIndex}]overlay=x=(main_w-overlay_w)/2+${formatNumber(layer.x)}:y=(main_h-overlay_h)/2+${formatNumber(layer.y)}:format=auto[b${includedIndex}]`);
+        const layerInput = inputIndex;
+        const base = baseLayerFilters(layer, options.width, options.height, options.fps);
+        const presentation = presentationLayerFilters(layer, options.width, options.height, options.frameOffset);
+        if (masked) {
+            filters.push(`[${layerInput}:v]${base.join(",")}[v${includedIndex}]`);
+            filters.push(opacityMaskFilter({
+                layer,
+                stageWidth: options.width,
+                stageHeight: options.height,
+                frameOffset: options.frameOffset,
+                inputIndex: maskInput,
+                outputLabel: `km${includedIndex}`,
+            }));
+            filters.push(`[v${includedIndex}][km${includedIndex}]blend=c0_mode=normal:c1_mode=normal:c2_mode=normal:c3_mode=multiply${presentation.length > 0 ? `,${presentation.join(",")}` : ""}[l${includedIndex}]`);
+        }
+        else {
+            filters.push(`[${layerInput}:v]${[...base, ...presentation].join(",")}[l${includedIndex}]`);
+        }
+        if (layer.blend === "normal") {
+            filters.push(`[${current}][l${includedIndex}]overlay=${placementFilter(layer, options.frameOffset)}:format=auto[b${includedIndex}]`);
+            current = `b${includedIndex}`;
+            continue;
+        }
+        const canvas = canvasLabels[canvasIndex];
+        canvasIndex += 1;
+        filters.push(`[${canvas}][l${includedIndex}]overlay=${placementFilter(layer, options.frameOffset)}:format=auto,format=rgba,split=2[pb${includedIndex}][pm${includedIndex}]`);
+        filters.push(`[${current}]format=rgba,split=3[bc${includedIndex}][bm${includedIndex}][bo${includedIndex}]`);
+        filters.push(`[bm${includedIndex}]alphaextract,format=rgba[mask${includedIndex}]`);
+        const spec = blendSpec(layer.blend);
+        const first = spec.sourceFirst ? `pb${includedIndex}` : `bc${includedIndex}`;
+        const second = spec.sourceFirst ? `bc${includedIndex}` : `pb${includedIndex}`;
+        filters.push(`[${first}][${second}]blend=${spec.options}[bl${includedIndex}]`);
+        filters.push(`[pm${includedIndex}][bl${includedIndex}][mask${includedIndex}]maskedmerge=planes=7[cs${includedIndex}]`);
+        filters.push(`[bo${includedIndex}][cs${includedIndex}]overlay=x=0:y=0:format=auto,format=rgba[b${includedIndex}]`);
         current = `b${includedIndex}`;
     }
-    filters.push(`[${current}]format=${options.codec === "ffv1" ? "bgra" : "yuv420p"}[out]`);
+    return { args, filters, output: current };
+}
+/** Encode a numbered PNG sequence into a lossless alpha-preserving FFV1 file. */
+export async function encodePngSequenceToFfv1(options) {
+    await runCaptured("ffmpeg", [
+        "-y",
+        "-v",
+        "error",
+        "-framerate",
+        formatNumber(options.fps),
+        "-i",
+        options.pattern,
+        "-c:v",
+        "ffv1",
+        "-level",
+        "3",
+        "-pix_fmt",
+        "bgra",
+        options.outputPath,
+    ], { signal: options.signal });
+}
+/** Composites one timeline segment into H.264 or an alpha-preserving FFV1 file. */
+export async function compositeTimelineSegment(options) {
+    const graph = buildCompositeGraph({
+        width: options.width,
+        height: options.height,
+        fps: options.fps,
+        frames: options.frames,
+        frameOffset: options.frameOffset ?? 0,
+        background: options.background,
+        layers: options.layers,
+        segment: true,
+    });
+    const filters = [...graph.filters, `[${graph.output}]format=${options.codec === "ffv1" ? "bgra" : "yuv420p"}[out]`];
+    const args = graph.args;
     args.push("-filter_complex", filters.join(";"), "-map", "[out]", "-frames:v", String(options.frames), "-r", formatNumber(options.fps), "-an");
     if (options.codec === "ffv1") {
         args.push("-c:v", "ffv1", "-level", "3", "-pix_fmt", "bgra", ...containerMuxerArgs("mkv"));
@@ -674,38 +992,18 @@ export async function muxVideoWithAudio(options) {
 }
 /** Composites one timeline frame to a PNG without encoding a segment. */
 export async function compositeTimelineFrame(options) {
-    const args = [
-        "-y",
-        "-v",
-        "error",
-        "-f",
-        "lavfi",
-        "-i",
-        `color=c=${ffmpegBackgroundColor(options.background)}:s=${options.width}x${options.height}:r=${formatNumber(options.fps)}:d=${formatNumber(1 / options.fps)}`,
-    ];
-    const filters = [
-        options.background === "transparent" ? "[0:v]format=rgba,colorchannelmixer=aa=0[base0]" : "[0:v]format=rgba[base0]",
-    ];
-    let current = "base0";
-    let inputIndex = 0;
-    let includedIndex = 0;
-    for (const layer of options.layers) {
-        if (layer.opacity <= 0 || layer.scale <= 0) {
-            continue;
-        }
-        if (layer.kind === "video") {
-            args.push("-ss", formatNumber((layer.sourceStartFrame ?? 0) / options.fps), "-i", layer.path, "-an");
-        }
-        else {
-            args.push("-i", layer.path);
-        }
-        inputIndex += 1;
-        includedIndex += 1;
-        filters.push(`[${inputIndex}:v]${layerFilter(layer, options.width, options.height, options.fps)}[l${includedIndex}]`);
-        filters.push(`[${current}][l${includedIndex}]overlay=x=(main_w-overlay_w)/2+${formatNumber(layer.x)}:y=(main_h-overlay_h)/2+${formatNumber(layer.y)}:format=auto[b${includedIndex}]`);
-        current = `b${includedIndex}`;
-    }
-    filters.push(`[${current}]format=rgba[out]`);
+    const graph = buildCompositeGraph({
+        width: options.width,
+        height: options.height,
+        fps: options.fps,
+        frames: 1,
+        frameOffset: options.frameOffset ?? 0,
+        background: options.background,
+        layers: options.layers,
+        segment: false,
+    });
+    const filters = [...graph.filters, `[${graph.output}]format=rgba[out]`];
+    const args = graph.args;
     args.push("-filter_complex", filters.join(";"), "-map", "[out]", "-frames:v", "1", "-update", "1", "-c:v", "png", "-pix_fmt", "rgba", options.outputPath);
     await runCaptured("ffmpeg", args, { signal: options.signal });
 }