Skip to content

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

4.0 KB
Raw Blame
import { describe, expect, it } from "vitest";
import {
	MediaTimeRemapSchema,
	mediaSourceIsHold,
	mediaSourceRange,
	mediaSourceRate,
	mediaSourceTime,
	validateMediaTimeRemap,
} from "./media-time.js";

describe("media time mapping", () => {
	it("maps fractional frames at a constant rate", () => {
		const map = MediaTimeRemapSchema.parse({
			kind: "rate",
			sourceStartSec: 2,
			rate: 0.25,
		});
		expect(mediaSourceTime(map, 15.5, 30)).toBeCloseTo(2 + 15.5 / 120);
		expect(validateMediaTimeRemap(map, 90)).toBeUndefined();
	});
	it("maps non-integer frame rates without accumulating drift", () => {
		const map = MediaTimeRemapSchema.parse({
			kind: "rate",
			sourceStartSec: 0.125,
			rate: 0.5,
		});
		const fps = 30000 / 1001;
		expect(mediaSourceTime(map, fps * 3600, fps)).toBeCloseTo(1800.125, 9);
	});
	it("maps piecewise source times and holds", () => {
		const map = MediaTimeRemapSchema.parse({
			kind: "keyframes",
			keyframes: [
				{ frame: 0, sourceSec: 1 },
				{ frame: 30, sourceSec: 2 },
				{ frame: 60, sourceSec: 2 },
				{ frame: 90, sourceSec: 4 },
			],
		});
		expect(validateMediaTimeRemap(map, 90)).toBeUndefined();
		expect(mediaSourceTime(map, 15, 30)).toBe(1.5);
		expect(mediaSourceTime(map, 45, 30)).toBe(2);
		expect(mediaSourceTime(map, 75, 30)).toBe(3);
	});
	it("rejects zero rate and accepts reverse playback", () => {
		expect(
			MediaTimeRemapSchema.safeParse({
				kind: "rate",
				sourceStartSec: 0,
				rate: 0,
			}).success,
		).toBe(false);
		const map = MediaTimeRemapSchema.parse({
			kind: "keyframes",
			keyframes: [
				{ frame: 0, sourceSec: 1 },
				{ frame: 30, sourceSec: 0 },
			],
		});
		expect(validateMediaTimeRemap(map, 30)).toBeUndefined();
		expect(mediaSourceTime(map, 15, 30)).toBe(0.5);
		expect(validateMediaTimeRemap(map, 31)).toMatch(/durationFrames/);
	});
	it("requires strictly ordered keyframes and a full layer window", () => {
		const map = MediaTimeRemapSchema.parse({
			kind: "keyframes",
			keyframes: [
				{ frame: 0, sourceSec: 0 },
				{ frame: 10, sourceSec: 1 },
				{ frame: 10, sourceSec: 1 },
				{ frame: 30, sourceSec: 2 },
			],
		});
		expect(validateMediaTimeRemap(map, 30)).toMatch(/strictly increasing/);
		expect(validateMediaTimeRemap(map, 29)).toMatch(/durationFrames/);
	});
	it("is independent of evaluation order", () => {
		const map = MediaTimeRemapSchema.parse({
			kind: "keyframes",
			keyframes: [
				{ frame: 0, sourceSec: 1 },
				{ frame: 20, sourceSec: 3 },
				{ frame: 40, sourceSec: 3 },
				{ frame: 60, sourceSec: 4 },
			],
		});
		const frames = [0, 12.5, 20, 39.5, 40, 59, 60];
		const expected = frames.map((frame) => mediaSourceTime(map, frame, 30));
		expect(
			frames
				.toReversed()
				.map((frame) => mediaSourceTime(map, frame, 30))
				.reverse(),
		).toEqual(expected);
	});
	it("evaluates smooth ramps without overshoot in either direction", () => {
		const map = MediaTimeRemapSchema.parse({
			kind: "keyframes",
			keyframes: [
				{ frame: 0, sourceSec: 1, interpolation: "ease-in" },
				{ frame: 30, sourceSec: 3, interpolation: "smooth" },
				{ frame: 60, sourceSec: 1, interpolation: "ease-out" },
				{ frame: 90, sourceSec: 2 },
			],
		});
		expect(validateMediaTimeRemap(map, 90)).toBeUndefined();
		expect(mediaSourceTime(map, 15, 30)).toBe(1.5);
		expect(mediaSourceTime(map, 45, 30)).toBe(2);
		expect(mediaSourceTime(map, 75, 30)).toBe(1.75);
		expect(mediaSourceRate(map, 0, 30)).toBe(0);
		expect(mediaSourceIsHold(map, 0)).toBe(false);
		expect(mediaSourceRange(map, 0, 90, 30)).toEqual({
			min: 1,
			max: 3,
			maxIncluded: true,
		});
		for (let frame = 0; frame <= 90; frame += 0.25)
			expect(mediaSourceTime(map, frame, 30)).toBeGreaterThanOrEqual(1);
	});
	it("maps constant reverse speed and bounds its source range", () => {
		const map = MediaTimeRemapSchema.parse({
			kind: "rate",
			sourceStartSec: 4,
			rate: -2,
		});
		expect(mediaSourceTime(map, 30, 30)).toBe(2);
		expect(mediaSourceRange(map, 0, 30, 30)).toEqual({
			min: 2,
			max: 4,
			maxIncluded: true,
		});
	});
});