CropImage
어떤 노드인가요?
CropImage 노드는 이미지 자르기(크롭), 확대/축소(줌), 회전 기능을 정밀하게 제어할 수 있는 노드입니다. 이미지의 특정 영역을 선택하고, 줌 효과를 적용하며, 이미지를 회전하여 워크플로우에 완벽한 구도를 맞출 수 있습니다.
언제 사용하나요?
다음과 같은 상황에서 이 노드를 사용합니다:
- 특정 크기나 종횡비로 이미지 자르기
- 이미지의 특정 핵심 영역에 초점 맞추기
- 디테일을 확대하기 위한 줌 효과 적용
- 이미지의 방향을 올바르게 맞추기 위한 회전
- 워크플로우 전체에서 일관된 이미지 크기 유지
- 이미지에서 불필요한 영역 제거
- 특정 출력 규격에 맞춘 이미지 준비
사용 방법
기본 설정
- 워크플로우에 CropImage 노드를 추가합니다.
- 이미지 소스를 "input_image" 입력에 연결합니다.
- 자를 영역의 좌표와 크기를 설정합니다.
- 필요에 따라 줌 및 회전 값을 조정합니다.
- 처리된 이미지가 "output" 파라미터를 통해 출력됩니다.
파라미터 (Parameters)
크롭 설정
- left (0 이상, 기본값: 0): 픽셀 단위의 크롭 영역 왼쪽 시작점
- top (0 이상, 기본값: 0): 픽셀 단위의 크롭 영역 상단 시작점
- width (1 이상, 기본값: 100): 픽셀 단위의 크롭 영역 너비
- height (1 이상, 기본값: 100): 픽셀 단위의 크롭 영역 높이
변형 설정
-
zoom (1.0 이상, 기본값: 1.0): 크롭 영역의 줌 배율
- 1.0 = 줌 없음 (원본 크기)
- 1.0 초과 = 확대 (Zoom in)
- 1.0 미만 = 축소 (Zoom out)
-
rotate (도(degrees), 기본값: 0): 회전 각도
- 양수(+) 값: 시계 방향 회전
- 음수(-) 값: 반시계 방향 회전
출력 (Outputs)
- output: 크롭 및 변형이 완료된 이미지
예시
일반적인 이미지 크롭 워크플로우:
- LoadImage를 사용하여 이미지를 불러옵니다.
- 해당 이미지를 CropImage 노드의 "input_image" 파라미터에 연결합니다.
- 크롭 영역을 설정합니다:
- 왼쪽에서 100픽셀 지점부터 시작하도록 left를 100으로 설정
- 상단에서 50픽셀 지점부터 시작하도록 top을 50으로 설정
- 가로 400픽셀 크기로 자르기 위해 width를 400으로 설정
- 세로 300픽셀 크기로 자르기 위해 height를 300으로 설정
- (선택 사항) 변형 효과 추가:
- 크롭 영역을 20% 확대하기 위해 zoom을 1.2로 설정
- 이미지를 시계 방향으로 15도 회전하기 위해 rotate를 15로 설정
- "output"을 DisplayImage에 연결하여 결과를 확인합니다.
중요 참고 사항
- 실시간 미리보기: 파라미터를 조정하면 변경 사항이 실시간으로 적용됩니다.
- 경계 검사(Boundary Checking): 자르기 영역이 이미지 경계를 벗어나지 않도록 노드가 자동으로 관리합니다.
- 고품질 리샘플링: 줌 및 회전 시 고품질 리샘플링 알고리즘을 사용합니다.
- RGBA 지원: RGBA 이미지의 투명도를 그대로 유지합니다.
자주 묻는 질문 및 문제 해결
- 크롭 영역 비어 있음: width와 height가 0보다 큰지 확인하세요.
- 이미지 외부 크롭: left + width 및 top + height가 원본 이미지 크기를 초과하지 않는지 확인하세요.
- 예상치 못한 결과: 지정한 크롭 좌표가 원본 이미지 경계 내에 있는지 확인하세요.
기술 세부 정보
이 노드는 다음 작업을 수행합니다:
- 크롭(Crop): 이미지에서 지정된 직사각형 영역을 추출합니다.
- 줌(Zoom): 고품질 리샘플링을 사용하여 잘라낸 영역을 확대/축소합니다.
- 회전(Rotate): 중심점을 기준으로 이미지를 회전합니다.
- 경계 관리(Boundary Management): 모든 작업이 유효한 이미지 범위 내에서 유지되도록 보장합니다.
이를 통해 전문가급 이미지 크롭 및 변형 기능을 제공합니다.