summaryrefslogtreecommitdiff
path: root/apps/web/src/services/thumbnail-cache/tiling.ts
blob: bc8d31e597f206f797e6f8ae232b8859c52cfb0a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
export const MEDIA_TILE_ASPECT_RATIO = 16 / 9;
export const FILMSTRIP_MIN_INTERVAL_SECONDS = 0.1;
export const FILMSTRIP_MAX_INTERVAL_SECONDS = 64;
export const FILMSTRIP_OVERSCAN_SLOTS = 2;

const SOURCE_TIME_END_PADDING_SECONDS = 0.05;
const TILE_TIME_QUANTUM_PER_SECOND = 4096;

export function getFilmstripInterval({
	pixelsPerSecond,
	minTileWidthPx,
}: {
	pixelsPerSecond: number;
	minTileWidthPx: number;
}): number {
	if (
		!Number.isFinite(pixelsPerSecond) ||
		pixelsPerSecond <= 0 ||
		!Number.isFinite(minTileWidthPx) ||
		minTileWidthPx <= 0
	) {
		return FILMSTRIP_MAX_INTERVAL_SECONDS;
	}

	const ideal = minTileWidthPx / pixelsPerSecond;
	const clamped = Math.min(
		FILMSTRIP_MAX_INTERVAL_SECONDS,
		Math.max(FILMSTRIP_MIN_INTERVAL_SECONDS, ideal),
	);
	return 2 ** Math.round(Math.log2(clamped));
}

export function getFilmstripSlotCount({
	clipDurationSec,
	interval,
}: {
	clipDurationSec: number;
	interval: number;
}): number {
	if (
		!Number.isFinite(clipDurationSec) ||
		clipDurationSec <= 0 ||
		interval <= 0
	) {
		return 0;
	}
	return Math.max(1, Math.ceil(clipDurationSec / interval - 1e-6));
}

export function getVisibleSlotRange({
	slotCount,
	tileWidthPx,
	visibleLeftPx,
	visibleRightPx,
	overscanSlots = FILMSTRIP_OVERSCAN_SLOTS,
}: {
	slotCount: number;
	tileWidthPx: number;
	visibleLeftPx: number;
	visibleRightPx: number;
	overscanSlots?: number;
}): { firstSlot: number; lastSlot: number } {
	if (slotCount <= 0 || tileWidthPx <= 0 || visibleRightPx <= visibleLeftPx) {
		return { firstSlot: 0, lastSlot: -1 };
	}

	const firstSlot = Math.max(
		0,
		Math.floor(visibleLeftPx / tileWidthPx) - overscanSlots,
	);
	const lastSlot = Math.min(
		slotCount - 1,
		Math.ceil(visibleRightPx / tileWidthPx) - 1 + overscanSlots,
	);
	return { firstSlot, lastSlot };
}

export function getFilmstripSlotSourceTime({
	slot,
	interval,
	trimStartSec,
	rate,
	assetDurationSec,
}: {
	slot: number;
	interval: number;
	trimStartSec: number;
	rate: number;
	assetDurationSec?: number;
}): number {
	const safeRate = Number.isFinite(rate) && rate > 0 ? rate : 1;
	const raw = Math.max(0, trimStartSec + slot * interval * safeRate);
	if (
		assetDurationSec === undefined ||
		!Number.isFinite(assetDurationSec) ||
		assetDurationSec <= 0
	) {
		return raw;
	}
	return Math.min(
		raw,
		Math.max(0, assetDurationSec - SOURCE_TIME_END_PADDING_SECONDS),
	);
}

export function buildThumbnailTileKey({
	mediaId,
	time,
	width,
	height,
}: {
	mediaId: string;
	time: number;
	width: number;
	height: number;
}): string {
	const quantizedTime = Math.round(
		Math.max(0, time) * TILE_TIME_QUANTUM_PER_SECOND,
	);
	return `${mediaId}:${width}x${height}:${quantizedTime}`;
}