GLIGENTextBoxApplyBatchCoords

GLIGENTextBoxApplyBatchCoords 노드는 기술적으로 GLIGEN 모델을 기반으로 하며, JSON 형식의 좌표 문자열을 파싱하여 텍스트 바운딩 박스의 위치와 크기를 정의합니다.

GLIGENTextBoxApplyBatchCoords는 배치 생성 과정에서 특정 텍스트 콘텐츠의 공간적 위치를 정밀하게 제어하기 위한 노드입니다. 핵심 기능은 일련의 좌표점을 수신하고 지정된 텍스트 프롬프트를 이미지 생성 캔버스의 특정 영역에 바인딩하여 텍스트 기반의 공간 구성 안내를 가능하게 합니다. 이 노드는 시간에 따라 또는 배치별로 요소 위치를 변경해야 하는 워크플로를 위해 설계되었습니다.

노드 기능

이 노드는 기술적으로 GLIGEN 모델을 기반으로 하며, JSON 형식의 좌표 문자열을 파싱하여 텍스트 바운딩 박스의 위치와 크기를 정의합니다. 잠재 공간(latent space)의 입력을 받아 배치 크기를 결정하고, 공간 제약 정보를 텍스트 프롬프트와 함께 조건화 데이터(conditioning data)에 인코딩하여 최종적으로 위치 정보가 융합된 조건화 데이터 흐름을 출력합니다. 좌표 입력 형식은 Spline Editor 노드와 직접 호환되도록 설계되어 복잡한 운동 궤적 계획에 용이합니다.

노드 파라미터 설명 - GLIGENTextBoxApplyBatchCoords

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`conditioning_to`	CONDITIONING	예	-	-	기존 조건화 데이터를 수신합니다. 이 노드는 새로운 공간적 텍스트 제약 정보를 여기에 추가합니다.
`latents`	LATENT	예	-	-	잠재 공간 표현(latent representation)을 제공하며, 주로 생성 과정의 배치 크기를 결정하는 데 사용됩니다.
`clip`	CLIP	예	-	-	텍스트 인코더를 제공하여 입력된 텍스트 프롬프트를 인코딩합니다. 메인 프롬프트와 동일한 CLIP 모델을 사용해야 합니다.
`gligen_textbox_model`	GLIGEN	예	-	-	로드된 GLIGEN 모델에 연결합니다. 이 모델은 공간 제약 로직을 처리합니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`coordinates`	STRING	예	-	-	바운딩 박스 위치를 정의하는 JSON 형식의 좌표 문자열을 수신합니다. 일반적으로 Spline Editor 노드에서 가져옵니다.
`text`	STRING	예	-	-	공간적 위치 제약을 적용할 텍스트 설명 부분을 입력합니다.
`width`	INT	예	128	8 - 4096 (간격: 8)	GLIGEN 텍스트 바운딩 박스의 너비를 설정합니다. 범위는 8부터 4096까지이며, 조정 간격은 8입니다.
`height`	INT	예	128	8 - 4096 (간격: 8)	GLIGEN 텍스트 바운딩 박스의 높이를 설정합니다. 범위는 8부터 4096까지이며, 조정 간격은 8입니다.
`size_multiplier`	FLOAT	아니오	[1.0]	1.0	-

출력 (Outputs)

파라미터 이름	데이터 타입	설명
conditioning	CONDITIONING	공간 제약 정보가 추가된 최종 조건화 데이터를 출력합니다.
coord_preview	IMAGE	좌표와 바운딩 박스 위치를 미리 보기 위한 시각화 이미지를 출력합니다.

사용 시나리오

이 노드는 주로 AnimateDiff-Evolved와 결합된 애니메이션 생성 워크플로에 적용됩니다. 예를 들어, 사용자는 먼저 Spline Editor 노드를 사용하여 여러 키프레임에서 물체(예: "나비 한 마리")의 비행 경로를 그린 다음, 생성된 좌표 시퀀스와 해당 텍스트 프롬프트를 이 노드에 입력하여 생성된 비디오 시퀀스에서 나비의 이동 궤적과 출현 위치를 정밀하게 제어할 수 있습니다.

주의사항

이 노드는 별도로 다운로드해야 하는 전용 GLIGEN 모델 파일과 함께 사용해야 합니다. 입력된 좌표 문자열은 유효한 JSON 형식이어야 하며, 정의된 바운딩 박스 위치는 캔버스 범위를 벗어나지 않아야 합니다. 그렇지 않으면 예측할 수 없는 생성 결과가 발생할 수 있습니다.