Image Annotation 위젯과 저장 흐름
Image Annotation은 이미지의 관심 영역에 사각형을 그리는 위젯입니다. 기존 주석 객체를 읽어 상자를 표시하고 새 사각형의 좌표를 변수로 내보냅니다.
주석은 위젯 안에 영구 저장하지 않습니다. 온톨로지 객체로 저장하면 검색, 필터, 링크와 권한을 적용하고 다른 앱에서도 사용할 수 있습니다. 실제 저장은 액션이 수행합니다.
가상 데이터 모델
예제는 이미지를 가진 Inspection Photo와 상자를 저장하는 Image Annotation을 사용합니다. 실제 온톨로지에는 그에 맞는 유형과 액션을 준비합니다.
| 주석 속성 또는 관계 | 구성 |
|---|---|
| Annotation ID | 주석을 구분하는 고유 String 기본 키 |
| Bounding box | 픽셀 좌표를 x1, y1, x2, y2 형식으로 저장하는 String 속성. 왼쪽 위와 오른쪽 아래의 좌표입니다. |
| Color | 선택적인 hex 색 String. 예는 #FF0000입니다. |
| 대상 이미지 링크 | Image Annotation에서 Inspection Photo로 연결하는 다대일 링크 등, 주석이 어느 이미지에 속하는지 나타내는 관계 |
생성 액션
새 주석 객체를 만드는 액션에 bounding box 문자열, 현재 Inspection Photo 참조와 선택적인 color 입력을 준비합니다. 액션은 고유 Annotation ID를 만들고 상자 속성 및 이미지 연결을 설정하도록 구성합니다.
필요하면 기존 주석을 삭제하거나 수정하는 액션도 정의합니다. 임시 검토가 아니라 실제 저장을 하려는 경우 시나리오가 필요하지 않습니다. 시나리오는 운영 데이터에 반영하기 전의 가정 분석과 검토가 필요한 경우에 사용합니다.
위젯 입력
Image source는 미디어 URL 또는 단일 객체의 미디어 참조 속성을 사용합니다. URL 입력에서 지원하는 형식은 .png, .jpg, .jpeg, .bmp와 .webp입니다. 데이터셋 URL의 형식은 Media Preview에 설명한 트랜잭션 또는 브랜치 보기 경로를 사용합니다. 외부 URL은 플랫폼의 Content Security Policy에 맞춰 허용되어 있어야 합니다.
Annotation objects에는 현재 Inspection Photo와 연결된 주석만 필터링하여 지정합니다. 다른 이미지의 상자가 겹쳐 보이지 않도록 대상 이미지와 집합을 연결합니다. 이미지 하나당 최대 1,000개 주석을 지원합니다.
Bounding box property에는 상자 문자열 속성을, 선택적인 Color property에는 hex 색 속성을 고릅니다.
그리기와 선택 출력
Current bounding box selection은 사용자가 그리고 있는 사각형의 픽셀 좌표를 가진 String 변수입니다. 형식은 x1, y1, x2, y2이며 이 변수를 생성 액션에 전달합니다.
Active annotation object는 사용자가 선택한 기존 주석 객체를 나타내는 객체 집합 변수입니다. 새 상자의 좌표와 저장된 주석의 선택은 별도의 값입니다.
온톨로지에 반영
- 사용자가 사각형을 그리면 위젯이 Current bounding box selection에 좌표를 씁니다.
- On annotation create의 이벤트로 저장 동작을 연결하거나 별도의 Button Group에서 사용자가 확인한 뒤 생성 액션을 실행하도록 합니다.
- 액션의 기본값에서 bounding box에는 그 좌표 변수를, subject object에는 현재 표시하는 Inspection Photo를 지정합니다. 색은 변수 또는 고정 hex 값으로 전달할 수 있습니다.
- 액션이 주석을 생성하고 이미지에 연결하면 주석 객체 집합을 다시 읽어 저장된 상자를 표시합니다.
액션의 권한과 제출 조건은 실제 저장에 적용됩니다. PDF의 여러 줄 텍스트 주석은 다른 좌표 자료형을 쓰는 PDF Viewer에서 구성합니다.