imageCropFromMask

imageCropFromMask 노드는 입력 이미지와 마스크를 마스크의 바운딩 박스 기준으로 크롭한 후, 크롭된 이미지, 크롭된 마스크, 바운딩 박스 좌표를 출력합니다. 이 노드는 EasyUse/Image 그룹에 속하며, 마스크된 피사체를 분리하여 추가 처리나 합성에 활용할 때 유용합니다.

입력

• image (IMAGE, 필수)
  크롭할 전체 해상도의 입력 이미지입니다.

• mask (MASK, 필수)
  크롭 영역을 결정하는 데 사용되는 마스크입니다. 노드는 마스크 영역을 감싸는 바운딩 박스에 맞춰 크롭합니다.

• image_crop_multi (FLOAT, 필수)
  이미지 크롭 시 마스크 바운딩 박스에 적용되는 배율입니다.
  기본값: 1 · 최소: 0 · 최대: 10 · 단계: 0.001

  값이 1이면 마스크 바운딩 박스에 정확히 맞춰 이미지가 크롭됩니다. 더 큰 값은 주변 맥락을 포함하도록 크롭 영역을 확장하고, 더 작은 값은 크롭 영역을 축소합니다.

• mask_crop_multi (FLOAT, 필수)
  마스크 크롭 시 마스크 바운딩 박스에 적용되는 배율입니다.
  기본값: 1 · 최소: 0 · 최대: 10 · 단계: 0.001

  이 값은 image_crop_multi와 독립적으로 작동하므로 이미지 출력과 마스크 출력에 서로 다른 크롭 크기를 사용할 수 있습니다.

• bbox_smooth_alpha (FLOAT, 필수)
  프레임 간 바운딩 박스의 평활화 계수입니다.
  기본값: 1 · 최소: 0 · 최대: 1 · 단계: 0.01

  값이 1이면 현재 프레임의 바운딩 박스를 그대로 사용합니다. 더 낮은 값은 현재 바운딩 박스를 이전 바운딩 박스와 혼합하므로 이미지 시퀀스나 애니메이션에서 지터(떨림)를 줄일 수 있습니다.

출력

• IMAGE
  마스크 바운딩 박스 기준으로 크롭된 입력 이미지이며, 크롭 크기에 image_crop_multi가 적용됩니다.

• MASK
  마스크 바운딩 박스 기준으로 크롭된 입력 마스크이며, 크롭 크기에 mask_crop_multi가 적용됩니다.

• BBOX
  크롭에 사용된 바운딩 박스 좌표입니다. BBOX 값을 필요로 하는 다른 노드에 전달할 수 있습니다.

사용 참고 사항

• 모든 입력은 필수입니다.
• image_crop_multi와 mask_crop_multi는 독립적이므로, 마스크 출력을 원본 마스크에 꼭 맞게 유지하면서 이미지 크롭은 추가 맥락을 포함하도록 여유 있게 설정하거나, 그 반대로 설정할 수 있습니다.
• 두 배율이 다르면 출력 이미지와 출력 마스크의 크기가 다를 수 있습니다.
• bbox_smooth_alpha는 마스크 바운딩 박스가 프레임 간에 빠르게 변하는 이미지 시퀀스를 처리할 때 특히 유용합니다.