Code-first video & image, rendered natively on WebGPU.
import { resolveMediaSourceUrl } from "@framefields/client-utils";
import {
getActiveMediaMetadata,
resolveMediaMimeType,
type VirtualMediaData,
} from "@framefields/core";
export type CropRegion = {
leftPct: number;
topPct: number;
widthPct: number;
heightPct: number;
};
export type RenderParams = {
sourceUrl: string | undefined;
trimStartSec: number;
trimEndSec: number | null;
speed: number;
cropRegion: CropRegion | null;
flipH: boolean;
flipV: boolean;
rotation: number;
effectiveDurationSec: number;
mimeType: string | null;
};
/**
* Compute render parameters for the CURRENT node only — does NOT recurse into
* children. Each node in the VirtualMedia tree is responsible for exactly its
* own operation; `SingleClipComposition` drives traversal via React recursion.
*
* This is the correct function to use inside the renderer.
*/
export function computeRenderParams(vv: VirtualMediaData): RenderParams {
const op = vv.operation;
const baseMeta = getActiveMediaMetadata(vv);
const params: RenderParams = {
sourceUrl: undefined,
trimStartSec: 0,
trimEndSec: null,
speed: 1.0,
cropRegion: null,
flipH: false,
flipV: false,
rotation: 0,
effectiveDurationSec: 0,
mimeType: resolveMediaMimeType(vv) || null,
};
switch (op.op) {
case "text":
// Rendered as a DOM element by the caller; no media URL needed.
params.sourceUrl = undefined;
break;
default:
params.sourceUrl = resolveMediaSourceUrl(vv);
break;
}
const sourceDurationSec = (baseMeta?.durationMs ?? 0) / 1000;
params.effectiveDurationSec =
((params.trimEndSec ?? sourceDurationSec) - params.trimStartSec) /
params.speed;
return params;
}