Split Masks 🎥🅥🅗🅢 (SplitMasks) - ComfyUI-VideoHelperSuite

Split Masks 🎥🅥🅗🅢 노드는 기술적 구현 관점에서, 일반적으로 다중 프레임 마스크로 구성된 시퀀스를 나타내는 MASK 타입의 텐서(Tensor)를 입력으로 받습니다.

Split Masks 노드는 마스크 시퀀스를 처리하는 도구로, 핵심 기능은 지정된 인덱스 위치를 기준으로 입력된 마스크 시퀀스를 앞뒤 두 개의 독립적인 부분으로 분할하는 것입니다. 이 작업은 간단하고 직관적이며, 사용자가 연속적인 마스크 프레임을 그룹별로 관리하기 쉽게 해줍니다.

노드 기능

기술적 구현 관점에서, 이 노드는 일반적으로 다중 프레임 마스크로 구성된 시퀀스를 나타내는 MASK 타입의 텐서(Tensor)를 입력으로 받습니다. 노드 내부에서는 정수 인덱스 split_index를 사용하여 분할 작업을 수행하며, 원본 시퀀스를 지정된 인덱스에서 절단하여 두 개의 새로운 마스크 시퀀스를 생성합니다. 출력되는 두 개의 MASK는 각각 분할점 이전과 이후의 모든 프레임에 해당하며, 이 두 새로운 시퀀스 각각에 포함된 프레임 수도 함께 출력됩니다.

노드 매개변수 설명 - Split Masks 🎥🅥🅗🅢

연결 입력 (Inputs)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`mask`	MASK	예	-	-	mask (입력 매개변수): 입력 마스크 시퀀스, 분할될 원본 다중 프레임 마스크 데이터입니다.

컨트롤 매개변수 (Parameters)

매개변수 이름	데이터 타입	필수	기본값	범위/옵션	설명
`split_index`	INT	예	0	BIGMIN - BIGMAX (단계: 1)	split_index (입력 매개변수): 분할을 수행할 인덱스 위치로, 범위에 특별한 제한이 없으며 단계는 1입니다. 이 인덱스 이전의 프레임은 첫 번째 그룹에, 이후(포함)의 프레임은 두 번째 그룹에 속합니다.

출력 (Output)

매개변수 이름	데이터 타입	설명
MASK_A	MASK	MASK_A (출력 매개변수): 분할 후 얻은 첫 번째 마스크 시퀀스입니다.
A_count	INT	A_count (출력 매개변수): 첫 번째 마스크 시퀀스 `MASK_A`에 포함된 프레임 수입니다.
MASK_B	MASK	MASK_B (출력 매개변수): 분할 후 얻은 두 번째 마스크 시퀀스입니다.
B_count	INT	B_count (출력 매개변수): 두 번째 마스크 시퀀스 `MASK_B`에 포함된 프레임 수입니다.

사용 시나리오

실제 워크플로우에서, 비디오의 마스크를 구간별로 처리해야 할 때 이 노드는 매우 유용합니다. 예를 들어, 100프레임으로 구성된 객체 마스크 시퀀스가 있고, 앞의 30프레임은 한 가지 인페인팅 알고리즘을, 뒤의 70프레임은 다른 알고리즘을 사용하고 싶을 수 있습니다. 이때 이 노드를 사용하여 split_index를 30으로 설정하면 마스크 시퀀스를 두 부분으로 분할한 후, 각각을 서로 다른 후속 처리 분기로 보낼 수 있습니다.

주의사항

사용 시 split_index 값이 유효한 범위 내에 있어야 합니다. 인덱스가 0이면 첫 번째 출력 시퀀스는 비어 있습니다. 인덱스가 입력 시퀀스의 총 프레임 수와 같거나 크면 두 번째 출력 시퀀스가 비어 있습니다.

Split Masks 🎥🅥🅗🅢 노드 소스 코드 링크

Split Masks 🎥🅥🅗🅢 노드는 ComfyUI-VideoHelperSuite 노드 패키지에서 제공됩니다.

Split Masks 🎥🅥🅗🅢(SplitMasks)

Split Masks