Skip to content

Code-first video & image, rendered natively on WebGPU.

1.4 KB
Raw Blame
/** Frame windows are half-open: [startFrame, startFrame + durationFrames). */
export function frameCount(durationMs: number, fps: number): number {
	assertFps(fps);
	if (!Number.isFinite(durationMs) || durationMs <= 0)
		throw new Error("durationMs must be finite and positive");
	const count = Math.max(1, Math.round((durationMs / 1000) * fps));
	if (!Number.isSafeInteger(count))
		throw new Error("Duration exceeds the safe frame range");
	return count;
}

export function assertFps(fps: number): void {
	if (!Number.isFinite(fps) || fps <= 0)
		throw new Error(`Invalid fps: ${fps}. Must be finite and > 0.`);
}

/** Resolve once, before hooks or rendering. atMs takes precedence over frame. */
export function resolveFrameRequest(
	request: { frame?: number; atMs?: number },
	fps: number,
): { frame: number; timeMs: number } {
	assertFps(fps);
	if (
		request.atMs !== undefined &&
		(!Number.isFinite(request.atMs) || request.atMs < 0)
	)
		throw new Error("atMs must be finite and nonnegative");
	const frame =
		request.atMs !== undefined
			? Math.round((request.atMs / 1000) * fps)
			: (request.frame ?? 0);
	if (!Number.isSafeInteger(frame) || frame < 0)
		throw new Error(
			`Invalid frame index: ${frame}. Must be a nonnegative safe integer.`,
		);
	const timeMs = (frame / fps) * 1000;
	if (!Number.isFinite(timeMs))
		throw new Error("Frame timestamp exceeds the finite range");
	return { frame, timeMs };
}