Skip to content

The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.

3.2 KB
Raw Blame
import type { SelectOption } from "../ui/Select";
import type { StartRenderHandler } from "./RenderQueue";
import type { ResolutionPreset } from "./useRenderQueue";

const RENDER_SETTINGS_KEY = "hf-studio-render-settings";

export interface PersistedRenderSettings {
  format: "mp4" | "webm" | "mov" | "gif";
  quality: "draft" | "standard" | "high";
  fps: 24 | 30 | 60;
  gpu: boolean;
}

export function getPersistedRenderSettings(): PersistedRenderSettings {
  try {
    const raw = localStorage.getItem(RENDER_SETTINGS_KEY);
    if (raw) {
      const parsed = JSON.parse(raw);
      return {
        format: ["mp4", "webm", "mov", "gif"].includes(parsed.format) ? parsed.format : "mp4",
        quality: ["draft", "standard", "high"].includes(parsed.quality)
          ? parsed.quality
          : "standard",
        fps: [24, 30, 60].includes(parsed.fps) ? parsed.fps : 30,
        gpu: parsed.gpu === true,
      };
    }
  } catch {
    /* ignore */
  }
  return { format: "mp4", quality: "standard", fps: 30, gpu: false };
}

export function persistRenderSettings(
  format: PersistedRenderSettings["format"],
  quality: PersistedRenderSettings["quality"],
  fps: PersistedRenderSettings["fps"],
  gpu: boolean = getPersistedRenderSettings().gpu,
): void {
  try {
    localStorage.setItem(RENDER_SETTINGS_KEY, JSON.stringify({ format, quality, fps, gpu }));
  } catch {
    /* ignore */
  }
}

export function resolveRenderFormat(value: string): PersistedRenderSettings["format"] {
  return (["mp4", "webm", "mov", "gif"] as const).find((format) => format === value) ?? "mp4";
}

export function startConfiguredRender(
  onStartRender: StartRenderHandler,
  settings: PersistedRenderSettings & { resolution: ResolutionPreset | "auto"; gifLoop: number },
): void | Promise<void> {
  const { format, quality, resolution, fps, gpu, gifLoop } = settings;
  if (format === "gif") return onStartRender(format, quality, resolution, fps, false, gifLoop);
  return onStartRender(format, quality, resolution, fps, gpu);
}

export function isRenderExportBlocked(
  isRendering: boolean,
  missingFfmpeg: boolean,
  invalidGifLoop: boolean,
): boolean {
  return isRendering || missingFfmpeg || invalidGifLoop;
}

export const FORMAT_INFO: Record<"mp4" | "webm" | "mov" | "gif", { label: string; desc: string }> =
  {
    gif: { label: "GIF", desc: "Animated image, no audio. Up to 30 fps." },
    mp4: { label: "MP4", desc: "Everyday video, widely compatible." },
    mov: {
      label: "MOV (ProRes 4444)",
      desc: "Transparent video for editing. Larger files.",
    },
    webm: {
      label: "WebM (VP9)",
      desc: "Transparent video for web. Limited editor support.",
    },
  };

const FPS_OPTIONS: SelectOption[] = [
  { value: "24", label: "24 fps" },
  { value: "30", label: "30 fps" },
  { value: "60", label: "60 fps" },
];

export function resolveRenderFps(
  format: PersistedRenderSettings["format"],
  fps: PersistedRenderSettings["fps"],
): PersistedRenderSettings["fps"] {
  return format === "gif" && fps === 60 ? 30 : fps;
}

export function getRenderFpsOptions(format: PersistedRenderSettings["format"]): SelectOption[] {
  return FPS_OPTIONS.map((option) => ({
    ...option,
    disabled: format === "gif" && option.value === "60",
  }));
}