Files
ComfyUI-H3-Continuum-Tiled/constants.py
T

124 lines
3.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Constants shared by H3 Continuum Join."""
from __future__ import annotations
FPS = 24.0
AUDIO_SAMPLE_RATE = 32_000
AUDIO_LATENT_FPS = 40.0
FRAME_RESCALE = AUDIO_LATENT_FPS / FPS
FRAME_PER_TOKEN = (1, 4, 4, 4, 4)
CHUNK_SECONDS_DEFAULT = 5.0
CHUNK_SECONDS_MIN = 4.0
CHUNK_SECONDS_MAX = 30.0
CHUNK_SECONDS_STEP = 0.1
CHUNK_SECONDS_TOOLTIP = (
"Target duration shared by every chunk. 5–15 seconds is the recommended "
"and validated range. Values above 15 seconds are supported, but VRAM "
"use and processing time can increase substantially, especially at high "
"resolution."
)
STATE_MAGIC = "H3_CONTINUUM_STATE"
PLAN_MAGIC = "H3_CONTINUUM_PLAN"
SESSION_MAGIC = "H3_CONTINUUM_SESSION"
PROMPT_PLAN_MAGIC = "H3_CONTINUUM_PROMPT_PLAN"
MARK_SCHEMA = "_h3cj_schema"
MARK_VIDEO_SLOT = "_h3cj_video_slot" # legacy/internal-slot compatibility
MARK_PIXEL_START = "_h3cj_pixel_start"
MARK_VIDEO_CONTEXT = "_h3cj_video_context"
MARK_CONTEXT_FRAMES = "_h3cj_context_frames"
MARK_AUDIO_CONTEXT = "_h3cj_audio_context"
MARK_AUDIO_END_FRAME = "_h3cj_audio_end_frame"
MARK_AUDIO_OVERHANG = "_h3cj_audio_overhang"
CONTINUUM_REFERENCE_METADATA_KEY = "_h3_continuum"
CONTINUUM_INTEROP_KEY = "h3_continuum"
CONTINUUM_INTEROP_API = 1
CONTINUUM_ACTUAL_PREFIX_STEPS = 2
MODEL_WRAPPER_KEY = "h3_continuum_join.apply_model.v1"
V2_RUNTIME_KEY = "h3_continuum_v2"
LAYOUT_ORIGINAL_TIME_ATTR = "_h3cj_original_time_v1"
LAYOUT_SIGNATURE_ATTR = "_h3cj_patch_signature_v1"
LAYOUT_DEVICE_CACHE_ATTR = "_h3cj_device_cache_v1"
CONTINUITY_OPTIONS = (
"Balanced — 22 frames",
"Fast — 5 frames",
"Strong — 39 frames (Experimental)",
)
CONTINUITY_FRAMES = {
CONTINUITY_OPTIONS[0]: 22,
CONTINUITY_OPTIONS[1]: 5,
CONTINUITY_OPTIONS[2]: 39,
}
DEFAULT_STATE_CAPACITY_FRAMES = 39
V2_CONTINUITY_AUTO = "Auto — conservative"
V2_CONTINUITY_OPTIONS = (V2_CONTINUITY_AUTO,) + CONTINUITY_OPTIONS
# Older saved workflows and frontend help text used ASCII hyphens in these
# labels. Keep the public labels canonical while accepting those persisted
# aliases when a saved Run Storage session is resumed.
_CONTINUITY_ALIASES = {
"Auto - conservative": V2_CONTINUITY_AUTO,
"Balanced - 22 frames": CONTINUITY_OPTIONS[0],
"Fast - 5 frames": CONTINUITY_OPTIONS[1],
"Strong - 39 frames (Experimental)": CONTINUITY_OPTIONS[2],
}
def normalize_continuity_mode(value: str) -> str:
"""Return the canonical continuity label for current and legacy saves."""
raw = str(value).strip()
return _CONTINUITY_ALIASES.get(raw, raw)
def continuity_storage_mode(value: str) -> str:
"""Return the stable ASCII label used in persisted contracts.
Persisted V3.8 runs used ASCII hyphens. Keeping that storage spelling
makes old manifests compatible while the runtime continues to accept and
expose the public em-dash labels.
"""
return normalize_continuity_mode(value).replace("—", "-")
PROMPT_MODE_FIXED = "Fixed — one prompt"
PROMPT_MODE_LIST = "List — split with ---"
PROMPT_MODE_TIMELINE = "Timeline — [0-5s] sections"
PROMPT_MODE_OPTIONS = (PROMPT_MODE_FIXED, PROMPT_MODE_LIST, PROMPT_MODE_TIMELINE)
PROMPT_FORMAT_AUTO = "Auto"
PROMPT_FORMAT_FIXED = "Fixed"
PROMPT_FORMAT_LIST = "List"
PROMPT_FORMAT_TIMELINE = "Timeline"
PROMPT_FORMAT_OPTIONS = (
PROMPT_FORMAT_AUTO,
PROMPT_FORMAT_FIXED,
PROMPT_FORMAT_LIST,
PROMPT_FORMAT_TIMELINE,
)
DIAGNOSTICS_OFF = "Off"
DIAGNOSTICS_BASIC = "Basic"
DIAGNOSTICS_FULL = "Detailed Report"
DIAGNOSTICS_LEGACY_FULL = "Full"
DIAGNOSTICS_OPTIONS = (DIAGNOSTICS_BASIC, DIAGNOSTICS_FULL, DIAGNOSTICS_OFF)
DIAGNOSTICS_ACCEPTED_OPTIONS = DIAGNOSTICS_OPTIONS + (DIAGNOSTICS_LEGACY_FULL,)
def normalize_diagnostics_mode(value: str) -> str:
return DIAGNOSTICS_FULL if value == DIAGNOSTICS_LEGACY_FULL else value
SEAM_CORRECTION_AUTO = "Auto"
SEAM_CORRECTION_OFF = "Off"
SEAM_CORRECTION_BASIC = "Basic"
SEAM_CORRECTION_OPTIONS = (
SEAM_CORRECTION_AUTO,
SEAM_CORRECTION_OFF,
SEAM_CORRECTION_BASIC,
)