설명
지정된 시간 범위를 기반으로 비디오 및 오디오 잠재 데이터에 대한 노이즈 마스크를 생성합니다. 생성된 마스크는 샘플링 중에 재생성되어야 할 시간적 영역을 나타냅니다. 마스크된 영역 내에서는 새로운 콘텐츠가 생성되고, 변경되지 않은 영역은 그대로 유지됩니다. 이는 비디오 잠재 데이터 또는 오디오 잠재 데이터 시퀀스에서 특정 세그먼트를 교체하면서 나머지는 그대로 두는 등 로컬 편집을 할 때 유용합니다.
입력
| 이름 | 유형 | 필수 | 기본값 | 최소 / 최대 / 단계 | 설명 |
|---|---|---|---|---|---|
video_latent | LATENT | 아니요 | – | – | 노이즈 마스크가 추가될 선택적 비디오 잠재 데이터입니다. |
audio_latent | LATENT | 아니요 | – | – | 노이즈 마스크가 추가될 선택적 오디오 잠재 데이터입니다. |
video_fps | 실수 | 예 | 25 | 0 / 100 / 0.01 | 비디오 잠재 데이터의 프레임 속도로, 시간(초)을 프레임 인덱스로 변환하는 데 사용됩니다. |
video_start_time | 실수 | 예 | 0 | 0 / 10000 / 0.01 | 비디오 마스크의 시작 시간(초)입니다. |
video_end_time | 실수 | 예 | 5 | 0 / 10000 / 0.01 | 비디오 마스크의 종료 시간(초)입니다. |
audio_start_time | 실수 | 예 | 0 | 0 / 10000 / 0.01 | 오디오 마스크의 시작 시간(초)입니다. |
audio_end_time | 실수 | 예 | 5 | 0 / 10000 / 0.01 | 오디오 마스크의 종료 시간(초)입니다. |
max_length | 콤보 | 예 | truncate | – | 출력 잠재 데이터의 전체 길이를 처리하는 방법: • truncate – 잠재 데이터를 end_time 길이에 맞게 자릅니다.• pad – 잠재 데이터가 더 짧은 경우 end_time까지 확장합니다.• partial – 전체 길이를 변경하지 않고 기존 잠재 데이터 내의 시간 범위에 대한 마스크를 만듭니다. |
existing_mask_mode | 콤보 | 아니요 | add | – | 입력 잠재 데이터에 이미 존재하는 노이즈 마스크와 결합하는 방법: • add – 기존 마스크와 새 마스크의 최댓값을 취합니다(합집합).• overwrite – 기존 마스크를 새 마스크로 완전히 대체합니다.• subtract – 마스크 영역을 1 대신 0으로 설정하여 해당 영역을 효과적으로 마스크 해제합니다. |
출력
| 유형 | 설명 |
|---|---|
LATENT | 업데이트된 노이즈 마스크(또는 새로 생성된 마스크)가 적용된 비디오 잠재 데이터입니다. video_latent가 제공되지 않은 경우, 샘플 없이 마스크만 포함된 잠재 데이터 배치가 반환됩니다. |
LATENT | 업데이트된 노이즈 마스크(또는 새로 생성된 마스크)가 적용된 오디오 잠재 데이터입니다. audio_latent가 제공되지 않은 경우, 마스크만 포함된 잠재 데이터 배치가 반환됩니다. |
두 출력 모두 ComfyUI 표준 잠재 데이터 사전이며 noise_mask 키를 포함합니다. 마스크는 이진 텐서로, 1은 재생성할 영역을, 0은 유지할 영역을 나타냅니다.
사용 참고 사항
- 최소 한 개의
video_latent또는audio_latent가 연결되어야 합니다. 하나만 제공된 경우, 해당하는 출력에만 의미 있는 샘플 데이터가 포함되고 다른 출력은 마스크만 있는 잠재 데이터가 됩니다. - 시간 값은 초 단위이며 제공된
video_fps를 사용하여 프레임 인덱스로 변환됩니다. 이 변환은 잠재 데이터의 시간 차원이 주어진 fps에서 (프레임 수)에 해당한다고 가정합니다. 오디오 잠재 데이터의 경우 동일한 fps 값을 사용하여 마스크를 오디오 잠재 데이터의 시간 구조에 맞춥니다. max_length설정은 출력 잠재 데이터가 지정된 종료 시간에 맞게 크기 조정(자르기 또는 채우기)되는지 여부를 결정합니다.partial을 사용하면 잠재 데이터가 원래 길이를 유지하고 마스크는 요청된 범위만 다룹니다.- 입력 잠재 데이터에 이미
noise_mask가 포함된 경우(예: 이전 노드에서),existing_mask_mode는 새 마스크가 이를 병합하는 방식을 제어합니다. 기본값add는 누적 마스크 영역을 구축하는 데 유용합니다.overwrite는 마스크를 완전히 대체합니다.subtract는 이전에 마스크된 영역을 "지우는" 데 사용할 수 있습니다. - 이 노드는 LTXV 기반 모델과 함께 사용하도록 설계되었으며 ComfyUI의
KJNodes/ltxv카테고리에 속합니다.
댓글
GitHub로 로그인하고 토론에 참여하세요.