Route RefMods through H3 prompt builder

This commit is contained in:
2026-10-20 13:23:02 +00:00
parent 944f3d28b4
commit 506f97ab6c
4 changed files with 114 additions and 18 deletions
+24 -7
View File
@@ -241,6 +241,8 @@ class DumasH3RefModsToContinuum:
},
"optional": {
"sequence_prompt": ("STRING", {"default": "", "multiline": True}),
"base_reference_images": ("H3_CONTINUUM_REFERENCE_IMAGES_V39",),
"reference_offset": ("INT", {"default": 0, "min": 0, "max": 8}),
},
}
@@ -255,12 +257,22 @@ class DumasH3RefModsToContinuum:
)
def convert(self, mods, video_vae, routing="Prompt @R tags", chunk_count=1,
sequence_prompt=""):
if not mods:
sequence_prompt="", base_reference_images=None, reference_offset=0):
if not mods and base_reference_images is None:
raise ValueError("The H3 RefMod bundle is empty.")
if routing not in ("All chunks", "Prompt @R tags"):
raise ValueError(f"Unknown RefMod routing mode: {routing!r}")
images, skipped_audio, ignored_strength = [], [], []
offset = int(reference_offset)
if not 0 <= offset <= 8:
raise ValueError("reference_offset must be between 0 and 8.")
if base_reference_images is not None:
base_images = getattr(base_reference_images, "images", None)
if not isinstance(base_images, (tuple, list)) or len(base_images) != 9:
raise ValueError("base_reference_images is not a valid Continuum V3.9 bundle.")
slots = list(base_images)
else:
slots = [None] * 9
seen = set()
for mod, _strength in mods:
if getattr(mod, "kind", None) == "audio":
@@ -275,20 +287,25 @@ class DumasH3RefModsToContinuum:
continue
if abs(strength - 1.0) > 1e-6:
ignored_strength.append(getattr(mod, "name", "refmod"))
if len(images) >= 9:
target = offset + len(images)
if target >= 9:
raise ValueError("Continuum V3.9 supports at most nine RefMod image slots.")
image = _decode_refmod_image(video_vae, mod)
if image is not None:
images.append(image)
if not images:
if slots[offset + len(images) - 1] is not None:
raise ValueError("A RefMod slot overlaps an existing image reference.")
slots[offset + len(images) - 1] = image
if not images and base_reference_images is None:
raise ValueError("No visual RefMods were found; audio-only RefMods cannot feed image references.")
selectors = (("all",) * 9 if routing == "All chunks"
else _prompt_selectors(sequence_prompt, int(chunk_count)))
slots = tuple(images) + (None,) * (9 - len(images))
bundle = _continuum_reference_bundle_type()(
images=slots, reference_use="Per chunk", selectors=selectors,
images=tuple(slots), reference_use="Per chunk", selectors=selectors,
)
details = [f"decoded {len(images)} visual RefMod(s) into Continuum slots R1-R{len(images)}"]
details = [f"decoded {len(images)} visual RefMod(s) into Continuum slots starting at R{offset + 1}"]
if base_reference_images is not None:
details.append("merged with builder image references")
details.append("routing=all chunks" if routing == "All chunks" else "routing=prompt @R tags")
if skipped_audio:
details.append("skipped audio-only: " + ", ".join(skipped_audio))