ImageTransformByNormalizedAmplitude

ImageTransformByNormalizedAmplitude 노드는 기술적으로 NORMALIZED_AMPLITUDE 타입의 배열과 일괄 IMAGE 이미지를 입력으로 받습니다.

ImageTransformByNormalizedAmplitude 노드는 입력된 오디오 진폭 데이터에 따라 이미지를 동적으로 변환할 수 있는 이미지 처리 노드입니다. 핵심 기능은 오디오의 정규화된 진폭 값을 이미지의 스케일링 및 이동 연산으로 매핑하여 오디오 리듬과 동기화된 시각적 변화 효과를 생성하는 것입니다.

노드 기능

이 노드는 기술적으로 NORMALIZED_AMPLITUDE 타입의 배열과 일괄 IMAGE 이미지를 입력으로 받습니다. 내부적으로 진폭 값을 [0, 1] 범위로 자르고, 진폭 값을 기반으로 이미지의 크롭 크기를 계산하여 스케일링 효과를 구현합니다. 또한, 노드는 누적 모드를 지원하여 연속적인 진폭 변화를 누적시켜 더 강렬한 시각적 임팩트를 생성할 수 있습니다. 처리된 이미지는 IMAGE 형식으로 출력되며, 입력과 동일한 배치 구조를 유지합니다.

노드 파라미터 설명 - ImageTransformByNormalizedAmplitude

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`normalized_amp`	NORMALIZED_AMPLITUDE	예	-	-	normalized_amp (입력 파라미터): 이미지 변환을 구동하는 데 사용되는 정규화된 오디오 진폭 데이터를 받습니다. 값의 범위는 0.0에서 1.0 사이로 제한됩니다.
`image`	IMAGE	예	-	-	image (입력 파라미터): 변환할 원본 이미지 배치를 입력합니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`zoom_scale`	FLOAT	예	0.0	-1.0 - 1.0 (단계 크기: 0.001)	zoom_scale (입력 파라미터): 진폭이 이미지 스케일에 영향을 미치는 기본 계수를 제어합니다. 범위는 -1.0에서 1.0이며, 단계 크기는 0.001입니다.
`x_offset`	INT	예	0	-	x_offset (입력 파라미터): 이미지의 수평 방향(X축) 기본 오프셋을 설정합니다. 범위는 시스템 최대 해상도에 따라 제한됩니다.
`y_offset`	INT	예	0	-	y_offset (입력 파라미터): 이미지의 수직 방향(Y축) 기본 오프셋을 설정합니다. 범위는 시스템 최대 해상도에 따라 제한됩니다.
`cumulative`	BOOLEAN	예	False	-	cumulative (입력 파라미터): 누적 모드를 활성화합니다. True로 설정하면 진폭 효과가 프레임별로 누적되어 변환 강도가 증가합니다.

출력

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	IMAGE (출력 파라미터): 진폭에 의해 구동된 변환을 거친 이미지 배치를 출력합니다.

사용 시나리오

오디오를 결합하여 비디오를 생성하는 워크플로에서의 대표적인 사용 사례입니다. 사용자는 AudioScheduler 노드에서 출력된 정규화된 진폭 데이터를 이 노드에 연결하고, 동시에 일련의 키프레임 이미지를 입력할 수 있습니다. 노드는 오디오의 실시간 진폭에 따라 각 프레임 이미지에 대해 다양한 수준의 스케일링과 오프셋을 자동으로 적용하여, 음악 리듬에 따라 "뛰거나" 또는 "호흡하는" 동적 비디오 시퀀스를 생성합니다.

주의사항

이 노드는 올바른 진폭 데이터 형식을 보장하기 위해 ComfyUI-AudioScheduler 확장과 함께 사용되도록 설계되었습니다. 입력된 이미지 배치의 수는 진폭 배열의 길이와 일치해야 하며, 그렇지 않으면 오류가 발생할 수 있습니다.