Create Audio Mask (CreateAudioMask) - ComfyUI-KJNodes

지원 중단됨: 이 노드는 지원이 중단되어 KJNodes/deprecated 카테고리로 이동되었습니다. 향후 업데이트에서 제거될 수 있습니다. 오디오 기반 마스크 생성에는 대체 노드를 사용하는 것을 고려하세요.

Create Audio Mask 노드는 지정된 경로의 WAV 오디오 파일을 로드하고, librosa 라이브러리를 사용하여 단시간 푸리에 변환(STFT)을 계산하여 스펙트럼 데이터를 얻습니다.

Create Audio Mask 노드는 오디오 파일의 스펙트럼 정보를 기반으로 일련의 이미지 마스크를 동적으로 생성할 수 있습니다. 핵심 기능은 오디오의 진폭 변화를 시각적인 원형 마스크 시퀀스로 변환하여, 후속 이미지 처리나 비디오 합성에 오디오 리듬과 동기화된 시각적 요소를 제공합니다.

노드 기능

이 노드는 지정된 경로의 WAV 오디오 파일을 로드하고, librosa 라이브러리를 사용하여 단시간 푸리에 변환(STFT)을 계산하여 스펙트럼 데이터를 얻습니다. 노드는 설정된 프레임 수에 따라 스펙트럼에서 해당 시간 세그먼트의 평균 진폭을 추출하고, 이 진폭 값에 스케일 계수를 곱하여 원형의 반지름을 계산합니다. 최종적으로 지정된 크기의 캔버스 중심에 흰색 원형(또는 반전된 경우 검은색 원형) 이미지를 생성합니다.

노드 파라미터 설명 - Create Audio Mask

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`invert`	BOOLEAN	예	False	-	invert (입력 파라미터): 마스크 색상을 반전시킵니다. False일 때는 흰 배경에 검은 원을 생성하고, True일 때는 검은 배경에 흰 원을 생성합니다.
`frames`	INT	예	16	1 - 255 (스텝: 1)	frames (입력 파라미터): 생성할 이미지 마스크의 총 프레임 수를 설정합니다. 범위는 1에서 255입니다.
`scale`	FLOAT	예	0.5	0.0 - 2.0 (스텝: 0.01)	scale (입력 파라미터): 원형 반지름의 스케일 계수를 제어합니다. 범위는 0.0에서 2.0이며, 스텝은 0.01입니다.
`audio_path`	STRING	예	audio.wav	-	audio_path (입력 파라미터): 입력 오디오 파일의 경로 문자열을 지정합니다. 기본값은 현재 디렉토리의 "audio.wav" 파일을 읽습니다.
`width`	INT	예	256	16 - 4096 (스텝: 1)	width (입력 파라미터): 출력 마스크 이미지의 너비 픽셀 값을 설정합니다. 범위는 16에서 4096입니다.
`height`	INT	예	256	16 - 4096 (스텝: 1)	height (입력 파라미터): 출력 마스크 이미지의 높이 픽셀 값을 설정합니다. 범위는 16에서 4096입니다.

Output 출력

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	IMAGE (출력 파라미터): 생성된 이미지 시퀀스를 출력합니다. 오디오 스펙트럼에 대응하는 시각화된 마스크입니다.

사용 시나리오

음악 시각화 쇼트 비디오를 제작하거나 오디오와 영상의 동기화된 특수 효과가 필요한 워크플로우에서 이 노드는 매우 유용합니다. 생성된 이미지 시퀀스(마스크)를 이미지 블렌딩이나 리페인팅 영역 노드에 연결하여, 비디오 내 특정 요소(예: 빛의 후광, 입자)가 음악 리듬에 따라 나타나거나 사라지는 범위를 제어함으로써 오디오에 의해 구동되는 시각적 변화 효과를 구현할 수 있습니다.

주의사항

이 노드는 librosa 라이브러리에 의존합니다. 설치되어 있지 않으면 실행 오류가 발생합니다. 기본 오디오 경로는 "audio.wav"입니다. 파일이 ComfyUI 루트 디렉토리에 없을 경우, 노드가 파일을 올바르게 읽을 수 있도록 절대 경로를 사용해야 할 수 있습니다.

Create Audio Mask 노드 소스 코드 링크

Create Audio Mask 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Create Audio Mask(CreateAudioMask)