OffsetMaskByNormalizedAmplitude

OffsetMaskByNormalizedAmplitude 노드는 MASK 타입의 마스크와 NORMALIZED_AMPLITUDE 타입의 정규화된 진폭 시퀀스를 주요 입력으로 받습니다. 이 노드는 AudioScheduler 노드(https://github.com/a1lazydog/ComfyUI-AudioScheduler)로의 브리지 역할을 합니다.

OffsetMaskByNormalizedAmplitude 노드는 오디오 기반의 마스크 변환 도구입니다. 이 노드의 핵심 기능은 입력된 정규화된 진폭 값을 기반으로 마스크 이미지를 동적으로 이동하거나 회전시켜, 오디오의 리듬이나 강도 변화를 시각적인 동적 효과로 변환하는 것입니다.

노드 기능

이 노드는 MASK 타입의 마스크와 NORMALIZED_AMPLITUDE 타입의 정규화된 진폭 시퀀스를 주요 입력으로 받습니다. 내부적으로, 진폭 값에 사전 설정된 오프셋(x, y)이나 각도 승수(angle_multiplier)를 곱하여 각 프레임별 마스크의 변위나 회전 각도를 계산하며, PyTorch의 roll 및 rotate 함수를 사용하여 변환을 수행합니다. 진폭 값은 자동으로 [0, 1] 범위로 잘리며, 이는 변환의 안정성을 보장합니다.

노드 파라미터 설명 - OffsetMaskByNormalizedAmplitude

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`normalized_amp`	NORMALIZED_AMPLITUDE	예	-	-	: 정규화된 진폭 시퀀스로, 값의 범위는 0.0에서 1.0 사이로 제한되며, 마스크의 오프셋과 회전량을 구동하는 데 사용됩니다.
`mask`	MASK	예	-	-	: 오프셋 또는 회전 변환이 적용될 마스크입니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`x`	INT	예	0	-4096 - MAX_RESOLUTION (스텝: 1)	: 마스크의 수평 방향(X축) 기준 오프셋 강도를 제어합니다. 범위는 -4096부터 MAX_RESOLUTION까지이며, 스텝은 1입니다.
`y`	INT	예	0	-4096 - MAX_RESOLUTION (스텝: 1)	: 마스크의 수직 방향(Y축) 기준 오프셋 강도를 제어합니다. 범위는 -4096부터 MAX_RESOLUTION까지이며, 스텝은 1입니다.
`rotate`	BOOLEAN	예	False	-	: 부울 스위치입니다. True로 설정하면 진폭 기반의 마스크 회전 기능이 활성화됩니다.
`angle_multiplier`	FLOAT	예	0.0	-1.0 - 1.0 (스텝: 0.001)	: 회전 각도 승수로, 진폭과 함께 회전 각도를 결정합니다. 범위는 -1.0부터 1.0까지이며, 스텝은 0.001입니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
mask	MASK	: 오프셋 또는 회전 변환이 적용된 새로운 마스크입니다.

사용 시나리오

구체적인 응용에서, 이 노드는 주로 AudioScheduler 시리즈 노드와 함께 사용되어 음악 시각화나 오디오 반응형 애니메이션을 생성하는 데 활용됩니다. 예를 들어, 비디오 생성 워크플로에서 음악의 진폭 분석 결과를 이 노드에 입력하여 전경 마스크의 위치나 회전을 제어할 수 있습니다. 이를 통해 마스크의 움직임 리듬이 음악의 비트와 동기화되어 역동적인 시각 효과를 생성할 수 있습니다.

주의사항

사용 시 주의할 점은, 마스크의 오프셋과 회전은 진폭의 순간값을 기반으로 계산되므로, 과도한 변위 값은 이미지 경계에서 원치 않는 순환 감싸기 효과를 초래할 수 있습니다. 또한, 진폭 입력은 반드시 정규화된 데이터여야 합니다.