Files
stuttlepress-ComfyUI-Wan-VA…/vace_join.py
T

240 lines
10 KiB
Python

import torch
class WanVACEPrepBase:
def _validate_dimensions(self, video_1, video_2):
"""Validate that both videos have matching, 16-divisible dimensions."""
height = video_1.shape[1]
width = video_1.shape[2]
if video_2.shape[1] != height or video_2.shape[2] != width:
raise ValueError(
f"Video dimensions must match. "
f"video_1 is {width}x{height}, "
f"video_2 is {video_2.shape[2]}x{video_2.shape[1]}"
)
if width % 16 != 0 or height % 16 != 0:
raise ValueError(
f"Video dimensions must be divisible by 16. "
f"Current dimensions: {width}x{height}"
)
return width, height
def _extract_context(self, video_1, video_2, context_frames, replace_frames):
"""Extract context frames from each video edge for the control video."""
if replace_frames > 0:
v1_context = video_1[-(context_frames + replace_frames):-replace_frames]
v2_context = video_2[replace_frames:context_frames + replace_frames]
else:
v1_context = video_1[-context_frames:]
v2_context = video_2[:context_frames]
return v1_context, v2_context
def _build_control_video_and_mask(self, video_1, v1_context, v2_context,
context_frames, replace_frames, new_frames,
height, width):
"""Build the control video tensor and mask."""
channels = video_1.shape[3]
# Wan wants to generate 4n+1 frames. If we don't provide that,
# it will quietly round down to the nearest 4n+1. So we add 1 here.
vace_count = (replace_frames * 2) + new_frames + 1
vace_frames = torch.full(
(vace_count, height, width, channels), 0.5,
dtype=video_1.dtype, device=video_1.device
)
control_video = torch.cat([v1_context, vace_frames, v2_context], dim=0)
total_frames = (context_frames * 2) + vace_count
mask = torch.zeros((total_frames, height, width), dtype=torch.float32, device=video_1.device)
mask[context_frames:context_frames + vace_count] = 1.0
return control_video, mask, vace_count
class WanVACEPrep(WanVACEPrepBase):
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"video_1": ("IMAGE",),
"video_2": ("IMAGE",),
"context_frames": ("INT", {
"default": 8,
"min": 4,
"max": 120,
"step": 4,
"tooltip": "Reference frames from each video edge for VACE interpolation (multiple of 4)."
}),
"replace_frames": ("INT", {
"default": 8,
"min": 0,
"max": 120,
"step": 4,
"tooltip": "Number of frames to regenerate at each transition edge (multiple of 4)."
}),
"new_frames": ("INT", {
"default": 0,
"min": 0,
"max": 240,
"step": 4,
"tooltip": "Number of new transition frames to generate, in addition to the replace_frames (multiple of 4)."
}),
}
}
RETURN_TYPES = ("IMAGE", "MASK", "INT", "INT", "INT", "IMAGE", "IMAGE", "INT", "INT", "INT")
RETURN_NAMES = ("control_video", "control_mask", "width", "height", "length", "start_images", "end_images", "context_frames", "replace_frames", "new_frames")
FUNCTION = "vace_prep"
CATEGORY = "video/VACE"
DESCRIPTION = """
Generates VACE control video and mask for smooth transitions between
two videos using context frames and frame replacement.
"""
def vace_prep(self, video_1, video_2, context_frames, replace_frames, new_frames):
width, height = self._validate_dimensions(video_1, video_2)
v1_len = video_1.shape[0]
v2_len = video_2.shape[0]
required_frames = context_frames + replace_frames
if v1_len < required_frames:
raise ValueError(
f"context_frames ({context_frames}) + replace_frames ({replace_frames}) = {required_frames}, "
f"which is too large for video_1 length of {v1_len}. "
f"Reduce context_frames or replace_frames."
)
if v2_len < required_frames:
raise ValueError(
f"context_frames ({context_frames}) + replace_frames ({replace_frames}) = {required_frames}, "
f"which is too large for video_2 length of {v2_len}. "
f"Reduce context_frames or replace_frames."
)
v1_context, v2_context = self._extract_context(video_1, video_2, context_frames, replace_frames)
control_video, mask, _ = self._build_control_video_and_mask(
video_1, v1_context, v2_context, context_frames, replace_frames, new_frames, height, width
)
start_images = video_1[:-(context_frames + replace_frames)]
end_images = video_2[context_frames + replace_frames:]
length = int(control_video.shape[0])
return (control_video, mask, width, height, length, start_images, end_images, context_frames, replace_frames, new_frames)
class WanVACEPrepBatch(WanVACEPrepBase):
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"video_1": ("IMAGE",),
"video_2": ("IMAGE",),
"is_first": ("BOOLEAN", {
"default": False,
"tooltip": "True for first iteration (index=0) - includes full beginning of video_1 in start_images."
}),
"is_last": ("BOOLEAN", {
"default": False,
"tooltip": "True for last iteration - includes full ending of video_2 in end_images."
}),
"context_frames": ("INT", {
"default": 8,
"min": 4,
"max": 120,
"step": 4,
"tooltip": "Reference frames from each video edge for VACE interpolation (multiple of 4)."
}),
"replace_frames": ("INT", {
"default": 8,
"min": 0,
"max": 120,
"step": 4,
"tooltip": "Number of frames to regenerate at each transition edge (multiple of 4)."
}),
"new_frames": ("INT", {
"default": 0,
"min": 0,
"max": 240,
"step": 4,
"tooltip": "Number of new transition frames to generate, in addition to the replace_frames (multiple of 4)."
}),
"debug": ("BOOLEAN", {
"default": False,
"tooltip": "Log details to the console"
}),
}
}
RETURN_TYPES = ("IMAGE", "MASK", "INT", "INT", "INT", "IMAGE", "IMAGE", "INT", "INT", "INT")
RETURN_NAMES = ("control_video", "control_mask", "width", "height", "length", "start_images", "end_images", "context_frames", "replace_frames", "new_frames")
FUNCTION = "vace_prep_batch"
CATEGORY = "video/VACE"
DESCRIPTION = "Batch-aware VACE prep that handles first/last iteration edge cases for multi-video processing."
def vace_prep_batch(self, video_1, video_2, context_frames, replace_frames, new_frames, is_first, is_last, debug):
width, height = self._validate_dimensions(video_1, video_2)
if debug:
print(f"\n[VACE Join Batch] === Start ===")
print(f"[VACE Join Batch] Video 1: {video_1.shape[0]} frames @ {width}x{height}")
print(f"[VACE Join Batch] Video 2: {video_2.shape[0]} frames @ {width}x{height}")
print(f"[VACE Join Batch] Flags: {'FIRST ' if is_first else ''}{'LAST' if is_last else 'MIDDLE' if not is_first else ''}")
print(f"[VACE Join Batch] Parameters: context={context_frames}, replace={replace_frames}, new={new_frames}")
v1_len = video_1.shape[0]
v2_len = video_2.shape[0]
required_frames = context_frames + replace_frames
if is_first:
if v1_len < required_frames:
raise ValueError(
f"First iteration: video_1 needs at least {required_frames} frames "
f"(context_frames + replace_frames), but has {v1_len}"
)
else:
if v1_len < required_frames * 2:
raise ValueError(
f"Middle/last iteration: video_1 needs at least {required_frames * 2} frames, "
f"but has {v1_len}"
)
if v2_len < required_frames:
raise ValueError(
f"video_2 needs at least {required_frames} frames "
f"(context_frames + replace_frames), but has {v2_len}"
)
v1_context, v2_context = self._extract_context(video_1, video_2, context_frames, replace_frames)
control_video, mask, vace_count = self._build_control_video_and_mask(
video_1, v1_context, v2_context, context_frames, replace_frames, new_frames, height, width
)
if is_first:
start_images = video_1[:-required_frames]
else:
start_images = video_1[required_frames:-required_frames]
if is_last:
end_images = video_2[required_frames:]
else:
channels = video_1.shape[3]
end_images = torch.empty((0, height, width, channels), dtype=video_2.dtype, device=video_2.device)
length = int(control_video.shape[0])
if debug:
print(f"[VACE Join Batch] Outputs:")
print(f"[VACE Join Batch] control_video: {control_video.shape}")
print(f"[VACE Join Batch] control_mask: {mask.shape}")
print(f"[VACE Join Batch] start_images: {start_images.shape[0]} frames")
print(f"[VACE Join Batch] end_images: {end_images.shape[0]} frames")
print(f"[VACE Join Batch] VACE output: {context_frames * 2 + vace_count} frames ({context_frames * 2} context + {vace_count} generated)")
print(f"[VACE Join Batch] === End ===")
return (control_video, mask, width, height, length, start_images, end_images, context_frames, replace_frames, new_frames)