fineAi Image Processing Tool — Release Notes

증강(Augmentation)·정렬(Alignment)·전처리 기능을 제공하는 fineAi Image Processing Tool의 버전별 변경 이력입니다.

• 실행 파일: dist\fineAi_Image_Processing_Tool_v<버전>.exe (PyInstaller onefile, 현재 릴리스만 git으로 추적)
• 소스: Image_Processing_Tool_Aug_v<버전>.py + 동명 .spec
• 로그/설정: 실행 파일 옆 logs\, config\ 폴더에 자동 생성

---

v1.6.2 (2026-08-04) — 성능 개선 릴리스

빌드: 20260804.125851 / 커밋: 53b6bcd

기본값 Augment(Factor 5, Random ±5°) 실행 속도를 대폭 개선했습니다. 2448×2048 PNG 실측 기준 장당 ~4.3초 → ~0.26초 (약 16배). 병목의 90% 이상이 PIL PNG 인코더(기본 압축 level 6)에 있었습니다.

변경 사항

• PNG 저장을 압축 level 1로 저장 — 인코딩 약 5배 고속화. 무손실은 그대로 유지되며 파일 크기만 ~10% 증가합니다. PNG 외 포맷(BMP/JPG/TIFF)은 기존과 동일합니다.
• 출력 이미지 병렬 저장 — 입력 1장당 출력물(기본 6장)을 ThreadPoolExecutor (최대 8 스레드)로 동시에 저장합니다. PIL 인코더가 GIL을 해제하므로 코어 수에 비례해 빨라집니다. 저장 실패 시 오류 처리는 기존과 동일하게 파일 단위로 동작합니다.
• 회전 경로 단순화 — rotate(expand=True) 후 중앙 crop 하던 것을 rotate(expand=False) 한 번으로 대체(결과 동일, 비용 절반). 차이는 회전 경계의 고립 픽셀 0.003% 미만(캔버스 정수 반올림)으로 증강 품질에 영향 없습니다.
• 로그 스로틀 — 저장 로그와 파일별 타이밍 로그를 10건마다 1회로 축소. 저장 실패 로그는 즉시 출력합니다. (LOG_EVERY 상수로 조정 가능)

호환성

• 설정 파일(config_align.ini, config_aug.ini) 형식 변경 없음.
• 출력 파일명 규칙 변경 없음.

---

v1.6.1 (2026-07-21 ~ 07-22)

git 저장소 최초 등록 버전. 커밋: f6fe5c5(최초 등록), 237ac86(실행 파일명 정리), 536dd52(아래 기능 추가)

변경 사항

• Shape (PCA) 정렬 방식 추가 — 원형이 아닌 임의 형상 제품 정렬 지원. 이미지 모멘트 무게중심으로 위치를, 주축(2차 모멘트)으로 방향을 구하고 180° 모호성은 3차 모멘트(무거운 쪽이 전방)로 해소합니다. 좌우 대칭 부품도 비대칭 특징(돌기) 기준으로 방향을 잡습니다. shape_axis = auto|major|minor, open_ksize(despeckle) 파라미터 추가.
  • 시트벨트 버클 13장 검증: 전량 tab-up 정렬, 평균 중심 오차 ~1.7px.
• Target Position — 정렬 결과의 중심 위치를 출력의 임의 지점 (target_x, target_y, 0.5/0.5=중앙)으로 지정 가능. Ring/Shape/Center-Only 모두 적용.
• 정렬 튜너 확장 — Method·Shape-Axis 선택, Open Kernel·Target Pos X/Y 슬라이더, 방식별 컨트롤 활성화, Shape 전용 오버레이(주축+방향 화살표) 추가.
• GUI 멈춤("응답 없음") 수정 — 워커 스레드에서 Tkinter를 직접 호출하던 것이 원인. 검증·파라미터 수집은 메인 스레드(prepare_processing)에서, 무거운 루프는 워커 (run_processing_worker)에서 수행하고 모든 GUI 접근은 스레드 안전 큐로 마샬링합니다.
• 배포 실행 파일명을 fineAi_Image_Processing_Tool_v1.6.1.exe로 정리.

호환성

• Ring 방식과 기존 EarBand 설정은 완전 호환. [aligner] 설정에 method / open_ksize / shape_axis / target_x / target_y 키가 추가되었으며 구버전 설정 파일은 안전한 기본값으로 로드됩니다.

---

v1.6.0 이전

git 저장소 등록 이전 버전(v0.1.x ~ v1.6.0)의 소스와 spec은 저장소 루트 및 backup\ 폴더에 파일로 보존되어 있으며, 별도의 변경 이력은 관리되지 않았습니다. v1.6.0의 도움말 시스템 도입 내역은 v1_6_0_도움말시스템_가이드.md를 참고하세요.