| name | gt-image-analyze |
| description | Image branch analysis after overall and text handoff: inventory every text-bearing texture and lock its original typography, color, outline, material, lighting, spacing, atmosphere, edit regions, anchors, canvas, alpha, atlas, style, and image scope before translation. Use when starting or resuming image analysis for a game localization project. |
gt-image-analyze — 이미지 브랜치 I1: 이미지 분석
이미지 안의 문자를 실제로 번역해야 하는지와 재삽입 계약을 확정한다. 생성·수정은 하지
않으며, 파일명이나 빈 목록만으로 N/A를 추정하지 않는다.
입력 조건
gt-analyze의 전체 컨테이너 inventory와 ANALYSIS.mdgt-text-review의 text_status=review_ready handoff와 준비된 glossary·STYLEPROJECT.md의 image_scope, 원본 inventory, target language slot- 플랫폼·엔진의 texture/atlas/alpha/import 문서와
$GT_HOME/common/image-translation-contract.md
text handoff 또는 font_status=verified가 없으면 이미지 안의 텍스트가 번역어와 일치하는지
검증할 수 없으므로 BLOCKED다. image_scope=pending이면 먼저 범위를 판정한다.
절차
SAFETY.md, project-structure.md, preflight-checks.md, 플랫폼·엔진 문서를 읽고
프로젝트·원본 해시·canonical 경로를 literal로 확정한다.- 범위 판정: 컨테이너 엔트리 전수 목록을 만들고 이미지가 없거나 게임별 근거상
번역 대상이 없으면
image_scope=N/A와 0건 근거를 PROJECT.md/IMAGE_ANALYSIS.md에
기록한다. 대상이 하나라도 있거나 확인할 수 없으면 required 또는 BLOCKED로 둔다.
- 이미지 전수 inventory: 경로·stable key·포맷·canvas·색상 모드·alpha·압축·mip·
원본 SHA-256·언어 variant·runtime consumer를 기록한다. 아틀라스는 page·x/y·width/
height·padding·UV 원점·sprite/region ID까지 기록한다.
- 문자 영역 확인: 시각 검사와 엔진 metadata를 교차 확인해 실제 문자 영역·보존 영역·
일반 이미지·미확인을 분리한다. OCR/파일명은 후보 근거일 뿐 완료 근거가 아니다.
- 분위기·스타일·보존 계약: 원어 이미지의 시대감·장르·온도감·명도/채도·감정과
서체 계열/인상·획 굵기/끝 모양·크기, 색/그라데이션, 외곽선/그림자/발광,
표면 질감/재질/광원 반응, 자간/행간/baseline/정렬, 여백·레이어·clear bbox·clip·
active/inactive 관계를 stable key와 region별로 각각 서술한다. 이 값은 이후 imagegen
prompt의
preserve_atmosphere, preserve_typography, preserve_color,
preserve_outline_shadow, preserve_material_lighting, preserve_spacing_baseline에 그대로
연결한다. 각 문자 영역의 exact edit_regions, anchor,
정렬, baseline을 실제 metadata/시각 검사로 고정한다. 빈 값·N/A·추측값은 허용하지 않는다.
원본 해상도·캔버스·alpha·atlas 좌표를 임의로 바꾸지 않는 기준을 정한다. alpha는
기본 exact이며, 글자 glyph 자체가 alpha에 들어 있음을 증명한 행만
edit-region-only로 선언한다.
- 계획표 작성:
30_translation/image_translation/IMAGE_PLAN.tsv에 required 대상
전부를 identified로 기록한다. 같은 stable key를 text manifest에 중복 등록하지 않는다.
IMAGE_GENERATION_MANIFEST.tsv의 stable key는 물리 raster 파일 단위로 두고, 한 atlas의
여러 region ID를 그 bitmap과 edit_regions에 연결한다. 각 stable key는 이후 내장
image_gen.imagegen을 같은 reference·prompt로 최소 3회 독립 호출할 수 있도록
for_translation/attempts/ 경로와 호출당 처리할 전체 선언 영역을 계획한다.
- 비파괴 reference 준비:
10_extract 원본을 수정하지 않고
image_translation/reference/에 byte-exact reference를 만든다. reference hash가 원본과
다르거나 symlink/reparse point면 BLOCKED다.
- 해시·경로 검증: reference와 for_translation을 혼동하지 않고 canonical 상대 경로,
대소문자, 원본 hash, 예상 대상 수를 재확인한다. 생성기는 원본/reference에 쓸 권한이 없다.
산출물
30_translation/image_translation/IMAGE_ANALYSIS.md30_translation/image_translation/IMAGE_SOURCE_INVENTORY.tsv30_translation/image_translation/IMAGE_PLAN.tsv (required일 때)- stable key별 atmosphere와 typography/color/outline-shadow/material-lighting/spacing-baseline,
edit region·anchor, canvas/alpha/atlas 계약과 byte-exact reference
image_scope=N/A이면 0건 inventory·판정 근거·생략 상태 기록
완료 기준
완료 시 gt-image-translate로 진행하며 사용자 승인을 기다리지 않는다.
