Bounding Box Editor

프로그램 소개/무엇인지

Bounding Box Editor은 이미지 내 객체에 직사각형 및 다각형 형태의 경계 상자 주석을 생성할 수 있는 JavaFX 기반 데스크톱 애플리케이션입니다. mfl28이 개발한 이 도구는 객체 탐지 모델 학습을 위한 데이터 준비에 특화되어 있으며, Pascal VOC 및 YOLO와 같은 산업 표준 형식으로 주석을 내보내고 가져올 수 있습니다. 소스 코드는 GitHub에서 공개되어 있으며, GPL v3 라이선스 하에 배포됩니다.

주요 기능

주석 생성 및 편집

이미지에 직사각형(클릭 기반 정점 입력 또는 자유형 그리기 모드)과 다각형 형태의 경계 상자를 생성할 수 있습니다. 사용자는 마우스로 객체를 둘러싸는 형태를 그린 후 라벨을 지정하여 주석을 추가할 수 있습니다.

형식 지원 및 변환

생성된 주석은 JSON, Pascal VOC 형식의 XML 파일, 그리고 YOLO 형식의 TXT 파일로 내보낼 수 있습니다. 반대로 이러한 형식의 파일을 불러와 기존 주석을 편집하거나 재사용할 수 있습니다. 가져오기 시 형식 오류가 있을 경우 검증 및 오류 보고 기능이 작동합니다.

라벨 및 태그 관리

Pascal VOC 형식에 정의된 트렁케이티드, 어려운, 가려진, 포즈, 액션과 같은 속성을 bounding box에 태그로 추가할 수 있습니다. 또한 라벨 계층 구조를 지원하여 상위-하위 라벨 관계가 XML 출력에 반영되도록 할 수 있습니다.

이미지 탐색 및 조직

좌측 사이드 패널에 썸네일 기반 이미지 목록을 표시하여 폴더 내 이미지 파일을 빠르게 탐색하고 검색할 수 있습니다. 이를 통해 대량의 이미지에 대한 주석 작업을 효율적으로 수행할 수 있습니다.

예측 힌트 통합

사용자는 자체 Torch Serve 엔드포인트를 연결하여 모델의 경계 상자 예측 결과를 주석 생성의 힌트로 활용할 수 있습니다. 이는 반자동 워크플로우를 가능하게 하여 주석 속도를 높일 수 있습니다.

다운로드·설치 방법

Windows 사용자는 공식 GitHub 릴리스 페이지에서 boundingboxeditor-2.8.0.exe 설치 프로그램을 다운로드하여 실행할 수 있습니다. 또는 Chocolatey 패키지 관리자를 통해 choco install boundingboxeditor 명령으로 설치할 수 있습니다. 설치 없이 사용하고 싶은 경우, boundingboxeditor-portable-windows.zip 포터블 버전을 다운로드하여 압축을 해제한 후 바로 실행할 수 있습니다.

기본 사용법/명령어

애플리케이션을 실행하면 중앙에 이미지 표시 영역과 좌측에 파일 목록 패널, 상단에 메뉴 바가 나타납니다. 이미지를 불러온 후 도구 모음에서 직사각형 또는 다각형 주석 도구를 선택하여 이미지 위에 그릴 수 있습니다. 주석이 생성되면 속성 패널에서 라벨과 태그를 수정할 수 있습니다. 상단 메뉴의 File → Export을 통해 원하는 형식(JSON, VOC XML, YOLO TXT)으로 주석을 저장할 수 있습니다. 자세한 사용법은 공식 위키의 User Manual에서 gif 애니메이션과 함께 확인할 수 있습니다.

이런 경우에 유용합니다

객체 탐지 모델을 위한 학습 데이터셋을 준비해야 하는 연구자 및 개발자에게 유용합니다. 예를 들어, 도로 위의 차량, 보행자, 신호등 등을 이미지에 주석으로 표시하여 YOLO 또는 Faster R-CNN과 같은 모델의 ground truth 레이블을 생성할 수 있습니다. 이미지 분류 작업에서 특정 객체의 위치를 표시해야 하는 경우에도 활용할 수 있습니다.

지원 환경·시스템 요구사항

이 애플리케이션은 Windows 10 이상, macOS 10.14 이상, 그리고 주요 Linux 배포판에서 실행됩니다. Windows 배포판은 jpackage를 통해 패키징되어 별도의 Java 런타임 설치를 요구하지 않을 수 있지만, 소스 코드로부터 빌드하려면 JDK 11+와 Gradle 5+가 필수입니다. 그래픽 환경을 필요로 하므로 headless 서버에서는 실행할 수 없습니다.

최신 버전·업데이트

현재 최신 버전은 2.8.0이며, GitHub 릴리스 페이지에서 각 플랫폼별 설치 프로그램과 포터블 버전을 확인할 수 있습니다. 업데이트는 새로운 릴리스가 게시될 때마다 제공되며, 릴리스 노트는 현재 제공된 증거에 상세히 포함되어 있지 않습니다.

제한 사항·확인 사항

이 애플리케이션은 GUI 기반 프로그램이므로 명령어만으로 전체 기능을 자동화하기에는 한계가 있습니다. 테스트 실행 시 일부 UI 테스트는 헤드리스 모드에서 동작하지 않으며, 이는 TestFX 및 JUnit 5 기반 테스트 프레임워크의 제한 사항입니다. 소스 코드로부터 빌드를 원하는 경우 Gradle과 Java JDK가 사전에 설치되어 있어야 합니다.