Insert Latent To Index (InsertLatentToIndex) - ComfyUI-KJNodes

Insert Latent To Index 노드는 두 개의 LATENT 타입 입력을 받으며, 4D(B, C, H, W)와 5D(B, C, T, H, W) 텐서 형식을 지원합니다.

Insert Latent To Index 노드는 하나의 잠재 표현(latent) 배치를 다른 잠재 배치 내의 지정된 위치에 삽입하는 데 사용됩니다. 핵심 기능은 대상 배치 내 특정 인덱스 위치의 잠재 샘플을 교체하여 잠재 공간의 정밀한 편집과 조합을 가능하게 합니다.

노드 기능

이 노드는 두 개의 LATENT 타입 입력을 받으며, 4D(B, C, H, W)와 5D(B, C, T, H, W) 텐서 형식을 지원합니다. 내부 메커니즘은 PyTorch의 torch.cat 함수를 사용하여 소스 텐서(source)를 대상 텐서(destination)의 지정된 인덱스(index) 앞에 연결하고, 원본 대상 텐서의 해당 인덱스 데이터를 건너뛰어 최종적으로 새로운 조합된 잠재 텐서를 출력합니다.

노드 파라미터 설명 - Insert Latent To Index

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`source`	LATENT	예	-	-	source (입력 파라미터): 삽입할 소스 잠재 표현 배치를 제공합니다.
`destination`	LATENT	예	-	-	destination (입력 파라미터): 수정될 대상 잠재 표현 배치를 제공합니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`index`	INT	예	0	-1 - 4096 (스텝: 1)	index (입력 파라미터): 소스 잠재 표현이 대상 배치 내에 삽입될 위치를 지정합니다. 범위는 -1부터 4096까지입니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
LATENT	LATENT	LATENT (출력 파라미터): 병합된 새로운 잠재 표현 배치를 출력합니다.

사용 시나리오

이미지 생성 워크플로에서 이 노드는 배치 생성 과정에서 특정 이미지 하나의 잠재 표현을 교체하는 데 사용할 수 있습니다. 예를 들어, 일련의 인물 초상화를 생성한 후, 그중 세 번째 이미지를 더 만족스러운 얼굴 특징을 가진 이미지로 교체하고 싶다면, 새 얼굴의 잠재 표현을 source로, 원본 배치를 destination으로 설정하고 index를 2로 지정하면 교체가 완료됩니다.

주의사항

사용 시 지정된 인덱스 값은 대상 잠재 배치의 유효한 범위 내에 있어야 하며, 그렇지 않으면 노드에서 오류가 발생합니다. 4D 텐서의 경우 인덱스는 배치 차원(B)에 대응하고, 5D 텐서의 경우 인덱스는 시간 차원(T)에 대응합니다.

Insert Latent To Index 노드 소스 코드 링크

Insert Latent To Index 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Insert Latent To Index(InsertLatentToIndex)