NormalizedAmplitudeToMask

NormalizedAmplitudeToMask 노드는 0에서 1 사이의 값으로 제한된 오디오 진폭을 나타내는 부동 소수점 배열을 입력으로 받습니다.

NormalizedAmplitudeToMask 노드는 정규화된 오디오 진폭 데이터를 이미지 마스크로 변환하는 오디오 구동 도구입니다. 이 노드는 오디오 처리와 이미지 생성 간의 다리 역할을 하여 사용자가 사운드 강도에 따라 시각적 요소를 동적으로 생성하거나 영향을 미칠 수 있도록 합니다.
AudioScheduler 노드에 대한 브리지 역할을 합니다.

노드 기능

이 노드는 0에서 1 사이의 값으로 제한된 오디오 진폭을 나타내는 부동 소수점 배열을 입력으로 받습니다. 핵심 메커니즘은 선택적 프레임 오프셋 매개변수를 통해 진폭 데이터의 시간 정렬을 조정한 다음, 지정된 모양, 위치, 크기 및 색상 모드에 따라 사용자 정의 캔버스에 해당 마스크를 생성하는 것입니다. 원형, 정사각형, 삼각형 또는 모양을 지정하지 않은 마스크 영역 생성을 지원합니다.

노드 매개변수 설명 - NormalizedAmplitudeToMask

연결 입력 (Inputs)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`normalized_amp`	NORMALIZED_AMPLITUDE	예	-	-	normalized_amp (입력 매개변수): 정규화된 오디오 진폭 데이터를 입력합니다. 값은 0에서 1 사이여야 합니다. 이는 마스크 생성의 핵심 구동 데이터입니다.

컨트롤 매개변수 (Parameters)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`shape`	COMBO	예	none	"none", "circle", "square", "triangle"	"circle"(원형), "square"(정사각형) 또는 "triangle"(삼각형) 중 선택합니다.
`color`	COMBO	예	amplitude	"white", "amplitude"	color (입력 매개변수): 마스크 영역 내의 값(색상)을 결정합니다. "white"(흰색, 값 1) 또는 "amplitude"(입력된 정규화 진폭 값을 해당 영역의 강도로 사용) 중 선택할 수 있습니다.
`width`	INT	예	512	16 - 4096 (간격: 1)	width (입력 매개변수): 출력 마스크 이미지의 너비를 설정합니다. 범위는 16부터 4096 픽셀까지이며 간격은 1입니다.
`height`	INT	예	512	16 - 4096 (간격: 1)	height (입력 매개변수): 출력 마스크 이미지의 높이를 설정합니다. 범위는 16부터 4096 픽셀까지이며 간격은 1입니다.
`frame_offset`	INT	예	0	-255 - 255 (간격: 1)	frame_offset (입력 매개변수): 오디오와 비디오의 동기화를 조정하기 위해 입력 진폭 데이터에 대한 시간 오프셋(프레임 수)입니다. 범위는 -255부터 255까지이며 간격은 1입니다.
`location_x`	INT	예	256	0 - 4096 (간격: 1)	location_x (입력 매개변수): 캔버스에 그려질 모양의 수평 중심 위치(X 좌표)를 지정합니다. 범위는 0부터 4096까지이며 간격은 1입니다.
`location_y`	INT	예	256	0 - 4096 (간격: 1)	location_y (입력 매개변수): 캔버스에 그려질 모양의 수직 중심 위치(Y 좌표)를 지정합니다. 범위는 0부터 4096까지이며 간격은 1입니다.
`size`	INT	예	128	8 - 4096 (간격: 1)	size (입력 매개변수): 그려질 모양의 기본 크기(예: 반지름 또는 변 길이)를 제어합니다. 범위는 8부터 4096까지이며 간격은 1입니다.

출력 (Output)

매개변수 이름	데이터 타입	설명
MASK	MASK	MASK (출력 매개변수): 오디오 진폭에 따라 생성된 이미지 마스크를 출력합니다.

사용 시나리오

비디오 또는 애니메이션 생성 워크플로에서 이 노드는 매우 유용합니다. 예를 들어, 음악의 리듬(진폭)을 노드에 연결하여 음악의 드럼 비트에 따라 크기가 변하는 원형 마스크를 생성한 다음, 이 마스크를 사용하여 다른 레이어의 표시 영역을 제어함으로써 음악 시각화 효과를 만들 수 있습니다. 이 노드는 주로 AudioScheduler와 같은 오디오 노드와 함께 사용됩니다.

주의사항

사용 시 입력된 진폭 데이터는 반드시 [0, 1] 범위로 정규화된 배열이어야 합니다. 생성된 마스크의 크기는 사용자가 설정한 캔버스 너비와 높이에 제한되며, 모양의 위치 및 크기 매개변수는 캔버스 경계를 초과해서는 안 됩니다. 그렇지 않으면 마스크 영역의 일부가 보이지 않게 됩니다.