ImageAndMaskPreview

ImageAndMaskPreview 노드는 SaveImage 클래스를 상속하지만, 주요 목적은 영구 저장이 아닌 임시 미리보기 이미지를 생성하는 것입니다.

ImageAndMaskPreview 노드는 이미지와 마스크를 미리보기 위한 유틸리티 도구입니다. 핵심 기능은 사용자가 이미지나 마스크를 개별적으로 확인하거나, 지정된 색상과 불투명도로 마스크를 이미지 위에 오버레이하여 마스크 영역을 직관적으로 검사할 수 있도록 하는 것입니다.

노드 기능

이 노드는 SaveImage 클래스를 상속하지만, 주요 목적은 임시 미리보기 이미지를 생성하는 것입니다. 마스크 색상을 정의하기 위해 RGB 튜플, RGBA 튜플, 16진수 코드 등 다양한 색상 형식을 지원합니다. 이미지와 마스크가 모두 제공되면, 노드는 설정된 불투명도와 색상으로 마스크를 이미지에 합성합니다. 둘 중 하나만 제공되면 해당 요소의 미리보기를 직접 출력합니다.

노드 파라미터 설명 - ImageAndMaskPreview

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`image`	IMAGE	아니오	-	-	미리보기하거나 마스크를 합성할 선택적 입력 이미지입니다.
`mask`	MASK	아니오	-	-	미리보기하거나 이미지와 합성할 선택적 입력 마스크입니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`mask_opacity`	FLOAT	예	1.0	0.0 - 1.0 (단계: 0.01)	이미지 위에 오버레이되는 마스크의 전체 불투명도를 제어합니다. 범위는 0.0(완전 투명)부터 1.0(완전 불투명)이며, 조정 단계는 0.01입니다.
`mask_color`	STRING	예	255, 255, 255	-	RGBA(예: "255,255,255,128") 또는 16진수(예: "#FF0000") 형식입니다.
`pass_through`	BOOLEAN	예	거짓	-	활성화하면 노드는 인터페이스 미리보기를 비활성화하고 출력 포트에서 직접 합성된 이미지 데이터를 전달합니다.

Output 출력

파라미터 이름	데이터 타입	설명
composite	IMAGE	-

사용 시나리오

이미지 처리 워크플로에서 이 노드는 매우 유용합니다. 예를 들어, 마스크를 생성한 후 이 노드에 연결하고 mask_color를 눈에 띄는 빨간색으로 조정하여 마스크가 목표 영역을 정확하게 덮고 있는지 빠르게 확인할 수 있습니다. 또는 비디오 합성 프로세스 전에 pass_through 기능을 활용하여 합성 결과를 후속 애니메이션 합성 노드로 직접 전달하여 프로세스를 중단하지 않고 미리보기를 확인할 수 있습니다.

주의사항

pass_through 모드를 활성화하면 노드는 인터페이스에 미리보기 이미지를 표시하지 않고 출력 포트에서 직접 합성 결과를 전달한다는 점에 유의해야 합니다. 또한 마스크 색상은 RGBA 형식을 지원하므로, 색상 자체에 독립적인 투명도를 지정할 수 있으며 이는 전체 mask_opacity 파라미터와 함께 작용합니다.