feat(modality)!: SnapOtter 2.0 phase 3 modality framework: media/doc engines, pool routing, display modes (#218)

2026-08-03 07:46:42 +02:00 · 2026-06-13 10:18:39 +08:00
parent c451b939c7
commit d647d8ed19
99 changed files with 4380 additions and 1813 deletions
@@ -0,0 +1,34 @@
+export type EncoderTarget = "h264" | "hevc" | "av1" | "vp9" | "aac" | "opus" | "mp3";
+
+const SOFTWARE: Record<EncoderTarget, string> = {
+  h264: "libx264",
+  hevc: "libx265",
+  av1: "libsvtav1",
+  vp9: "libvpx-vp9",
+  aac: "aac",
+  opus: "libopus",
+  mp3: "libmp3lame",
+};
+
+const NVENC: Partial<Record<EncoderTarget, string>> = {
+  h264: "h264_nvenc",
+  hevc: "hevc_nvenc",
+  av1: "av1_nvenc",
+};
+
+const VAAPI: Partial<Record<EncoderTarget, string>> = {
+  h264: "h264_vaapi",
+  hevc: "hevc_vaapi",
+};
+
+/**
+ * Hardware-acceleration seam (spec 4.5): SNAPOTTER_HW_ACCEL selects an
+ * encoder family; a CUDA/NVENC deployment is a Dockerfile change, not a
+ * code change. Unknown values fall back to software.
+ */
+export function resolveEncoder(target: EncoderTarget): string {
+  const accel = (process.env.SNAPOTTER_HW_ACCEL ?? "").toLowerCase();
+  if (accel === "nvenc") return NVENC[target] ?? SOFTWARE[target];
+  if (accel === "vaapi") return VAAPI[target] ?? SOFTWARE[target];
+  return SOFTWARE[target];
+}