설명
빠른 배치 미리보기는 이미지 또는 마스크 배치 전체를 단일 H.264 MP4 썸네일 스트립으로 미리보기 할 수 있게 해주며, ComfyUI 인터페이스에서 대화형 그리드로 표시됩니다. 각 프레임이 I-프레임(키프레임)으로 인코딩되어 임의 접근이 가능합니다. 타일을 클릭하면 확대되고, 배치 전체를 앞뒤로 찾아보면서 수백 개의 개별 PNG 파일을 생성하지 않아도 됩니다. 따라서 대규모 생성 실행을 반복할 때 훨씬 빠르고 리소스 효율적입니다.
이 노드는 KJNodes/experimental 카테고리에 속하며 시각적 진단 도구로 설계되었습니다. 데이터 출력은 없습니다.
입력
| 입력 | 타입 | 필수 | 기본값 | 최소 | 최대 | 단계 | 설명 |
|---|---|---|---|---|---|---|---|
input | IMAGE, MASK 또는 배치 | ✅ | – | – | – | – | 미리보기 할 이미지 또는 마스크 배치입니다. 단일 이미지, 이미지 배치 또는 마스크 배치가 될 수 있습니다. |
max_thumb_size | INT | ✅ | 512 | 512 | 1024 | 8 | 상세 보기 썸네일(타일 클릭 시 확대된 보기)의 최대 변 길이(픽셀)입니다. 그리드 타일(스트립 썸네일)은 자동으로 256픽셀로 제한됩니다. |
crf | INT | ✅ | 25 | 0 | 51 | 1 | H.264 인코딩의 CRF(Constant Rate Factor)입니다. 값이 낮을수록 시각적 품질이 높아지지만 파일 크기가 커집니다. 값이 높을수록 공간을 절약하지만 품질이 저하됩니다. 18 미만의 값은 일반적으로 시각적 무손실로 간주됩니다. |
max_grid_frames | INT | ✅ | 1024 | 1 | 4096 | 1 | 입력 배치가 이 프레임 수를 초과하면 노드가 배치를 균등하게 스트라이드 샘플링하여 그리드에 이 프레임 수만 표시합니다. 확대된 보기에서는 전체 배치를 계속 탐색할 수 있습니다. |
사용 참고 사항
- 빠른 배치 미리보기를 사용해야 하는 경우: 애니메이션 워크플로, 잠재 데이터 배치 샘플링 또는 마스크 시퀀스 확인 중과 같이 생성된 많은 프레임을 신속하게 검사해야 할 때 개별 미리보기 이미지를 저장하는 대신 이 노드를 사용하세요.
- 파일 처리: 생성된 MP4는 임시로 저장되며 ComfyUI를 닫으면 삭제됩니다. 표준 출력 폴더에 기록되지 않습니다.
- 메모리 대 성능: 이 노드는 단일 비디오 파일과 키프레임을 사용하므로 N개의 개별 PNG를 쓰고 읽는 오버헤드를 피할 수 있습니다. 수백 또는 수천 프레임의 배치를 미리보기 할 때 지연 시간을 크게 줄일 수 있습니다.
- 스트라이드 샘플링 로직: 배치 길이가
max_grid_frames를 초과하면 그리드는 균일한 프레임 하위 집합(예: N번째 프레임마다)을 표시합니다. 확대된 보기에서는 전체 배치를 단계별로 탐색할 수 있습니다. - 출력 없음: 이 노드는 실시간 미리보기 전용으로 설계되었으며, 데이터를 다운스트림으로 전달하지 않습니다. 워크플로 체인의 끝에 배치하세요.
- 실험적 상태:
KJNodes/experimental에 있으므로 향후 릴리스에서 API가 변경될 수 있습니다. 커스텀 노드 팩을 업그레이드할 때 업데이트를 확인하세요.
댓글
GitHub로 로그인하고 토론에 참여하세요.