EasyLoader (SV3D)(sv3dLoader)

설명

ComfyUI-Easy-Use 패키지의 로더 노드로, EasyUse/Loaders 그룹에 속합니다. 체크포인트와 VAE를 로딩하고 초기 이미지를 받아들여 주변의 뷰 시퀀스를 생성하는 데 사용되는 잠재 데이터/배치 설정을 구성함으로써 SV3D 이미지-3D 워크플로를 준비합니다.

또한 이 노드는 카메라 궤적 컨트롤과 선택적인 스케줄러 문자열을 제공하므로, 다운스트림 샘플링 및 비디오/3D 생성 노드에 공급하기 위한 단일 진입점 역할을 합니다.

입력

ckpt_name

콤보. 로드할 체크포인트 모델을 선택합니다. 사용 가능한 옵션은 체크포인트 폴더에서 가져옵니다.

vae_name

콤보. 잠재 데이터를 인코딩/디코딩하는 데 사용되는 VAE를 선택합니다. 사용 가능한 옵션은 VAE 폴더에서 가져옵니다.

init_image

이미지. SV3D 생성의 시작 뷰로 사용되는 소스 이미지입니다. 이 이미지는 잠재 공간으로 인코딩되어 생성된 카메라 경로의 시각적 기준으로 사용됩니다.

empty_latent_width

정수. 생성된 프레임에 사용되는 빈 잠재 데이터의 너비입니다. SV3D 시퀀스에 원하는 출력 해상도와 일치하도록 설정하세요.

empty_latent_height

정수. 생성된 프레임에 사용되는 빈 잠재 데이터의 높이입니다. SV3D 시퀀스에 원하는 출력 해상도와 일치하도록 설정하세요.

batch_size

정수, 기본값 21, 최소 1, 최대 4096. 생성할 프레임 수/잠재 샘플 수입니다. SV3D는 일반적으로 표준 궤도 뷰 시퀀스에 21프레임을 사용하므로 기본값은 21로 설정되어 있습니다. 더 큰 값은 메모리 사용량과 생성 시간을 크게 증가시킵니다.

interp_easing

콤보, 기본값 linear. 옵션: linear, ease_in, ease_out, ease_in_out. 카메라 경로를 따라 보간에 적용되는 이징(easing)을 제어합니다.

• linear: 프레임 사이에 일정한 보간.
• ease_in: 느리게 시작하고 가속.
• ease_out: 빠르게 시작하고 감속.
• ease_in_out: 시작 시 가속하고 끝에서 감속.

easing_mode

콤보, 기본값 azimuth. 옵션: azimuth, elevation, custom. SV3D 시퀀스에 사용되는 카메라 이동 유형을 선택합니다.

• azimuth: 물체 주위를 수평으로 궤도 회전합니다.
• elevation: 카메라를 수직으로 이동합니다.
• custom: 사용자 지정 카메라/스케줄러 경로를 사용합니다.

scheduler

문자열, 선택 사항, 기본값 "". 선택적인 스케줄러 문자열입니다. 비어 있으면 로더는 기본 제공/기본 스케줄링 동작을 사용합니다. 제공되면 스케줄러 값을 소비하는 다운스트림 노드에 전달할 수 있습니다.

출력

PIPE_LINE

로드된 모델, VAE 및 관련 생성 설정을 번들로 묶는 EasyUse 파이프라인 개체로, 다운스트림 EasyUse 노드에 편리하게 연결할 수 있습니다.

MODEL

로드된 SV3D diffusion 모델로, 샘플러 또는 기타 모델을 사용하는 노드에서 사용할 준비가 되었습니다.

STRING

이 로더 설정과 연결된 스케줄러 문자열입니다. 스케줄러 값을 기대하는 노드에 전달하거나 디버깅/사용자 지정 스케줄링 워크플로에 사용할 수 있습니다.

사용 참고 사항

• 이 노드는 초기 이미지를 생성된 뷰 시퀀스의 앵커로 사용하는 SV3D 이미지-3D 생성을 위한 것입니다.
• 기본 batch_size인 21은 SV3D의 표준 프레임 수와 일치합니다. 변경하는 경우 다운스트림 모델과 샘플링 설정이 해당 프레임 수를 지원하는지 확인하세요.
• empty_latent_width와 empty_latent_height는 일반적으로 입력 이미지의 크기와 동일한 값으로 설정하거나 SV3D 모델이 기대하는 기본 해상도로 설정해야 합니다.
• easing_mode와 interp_easing은 함께 배치에 걸쳐 카메라가 물체 주위를 이동하는 방식을 정의합니다. 단순한 궤도 회전의 경우 easing_mode를 azimuth로, interp_easing을 linear로 유지하세요.
• 선택적 scheduler 입력은 노드의 기본값에 의존하는 대신 카메라/스케줄링 동작을 외부에서 제어하려는 경우 특히 유용합니다.