Task #860: HWP3/HWP5/HWPX 의 EMF/WMF image 콘텐츠 렌더 정정

[jangster77]

Summary

• BMP → PNG 변환 (Stage A-C): EMF/WMF 의 inner BMP image data URI 가 data:image/bmp 였으나 rsvg-convert / 브라우저 미지원 → data:image/png 로 재인코딩 (graceful fallback 유지)
• WMF SVG viewBox 자동 확장 (Stage A-C + D): SetWindowExt 가 actual element bbox 보다 작은 경우 element 의 max(x+width, y+height) + min(x, y) 까지 양방향 자동 확장
• viewBox origin 적용 (Stage D): SetWindowOrg 의 origin 을 viewBox 시작점으로 사용
• y-flip framework (Stage D): SetWindowExt y < 0 (Cartesian) 감지 + <g transform="translate(0,vb_h) scale(1,-1)"> wrap (현재 sample 미적용, 다른 sample 대비)
• closes HWP3 sample14 의 그림(bin_id=2) 내부 콘텐츠 누락 — 박스 외곽만 렌더, 내부 텍스트 안 보임 #860

본질: samples/hwp3-sample14.hwp (및 HWP5/HWPX 변환본) 의 그림 (bin_id=2, 149.9×41.9mm TAC) 내부 콘텐츠 (terminal-style "If you leave me now..." 등) 렌더링 누락. 한컴 한글 2022 PDF (권위) 와 시각 다름.

2 layers 본질 진단:

1. BMP MIME 미지원 (rsvg-convert / 브라우저) → PNG 로 재인코딩
2. WMF SVG converter 의 viewBox 가 element bbox cover 못 함 → 자동 확장

CLAUDE.md HWP3 규칙 정합

본 PR 의 모든 변경은 EMF/WMF format 공통 모듈 의 처리 결함 정정. HWP3 전용 분기 추가 없음:

• src/emf/converter/, src/wmf/converter/ 는 EMF/WMF format 처리 (HWP3/HWP5/HWPX 모두에서 사용)
• 공통 모듈 (src/renderer/, src/renderer/layout.rs, src/document_core/) 에 HWP3 전용 분기 없음
• 변경이 모든 포맷에 동일 적용 (HWP3 sample14 / HWP5 변환본 / HWPX 변환본 모두 fix 됨)

잔여 (별도 deep task 권장)

• element y 좌표 sequence 자체가 한컴과 반대 (rhwp: 캡션 outline 위 + BMP 박스 아래 / 한컴: 박스 위 + 캡션 아래)
• WMF spec 정밀 분석 + 좌표계 재설계 필요. 본 PR scope 보다 큼.

Test plan

• cargo build --release: 성공
• cargo test --release --lib: 1230 passed, 0 failed, 2 ignored
• cargo clippy --release --lib: 0 warnings, 0 errors
• 9 sample 회귀 검증 (페이지 수 / overflow 모두 baseline 정합):
  • hwp3-sample14.hwp: 11 페이지, overflow 0 ✓
  • hwp3-sample14-hwp5.hwp: 11 페이지 ✓
  • hwp3-sample14-hwp5.hwpx: 11 페이지 ✓
  • hwp3-sample13.hwp: 3 페이지 ✓
  • hwp3-sample13-hwp5.hwp: 3 페이지 ✓
  • hwp3-sample13-hwp5.hwpx: 3 페이지 ✓
  • exam_eng.hwp: 8 페이지, overflow 12 = baseline 12 ✓
  • exam_math.hwp: 20 페이지 ✓
• hwp3-sample14 page 2 시각: BMP image 콘텐츠 (terminal screenshot) 정상 표시 (한컴 PDF 정합)
• WASM build 검증 (Docker 환경 필요, 사용자 검증 권장)
• browser 시각 검증 (rhwp-studio)

변경 파일

소스:

• src/emf/converter/player.rs (BMP→PNG 변환)
• src/wmf/converter/svg/util.rs (BMP→PNG 변환)
• src/wmf/converter/svg/mod.rs (viewBox 양방향 자동 확장 + y-flip transform framework + helper)
• src/wmf/converter/svg/device_context.rs (Window y_inverted + viewBox origin)
• src/emf/tests.rs (test assert PNG/BMP fallback 둘 다 허용)

샘플 + PDF:

• samples/hwp3-sample13(-hwp5).{hwp,hwpx}, hwp3-sample14(-hwp5).{hwp,hwpx}
• pdf/hwp3-sample{13,14}-hwp5-2022.pdf (권위 자료)

문서:

• mydocs/plans/task_m100_860{,_impl,_v2,_v2_impl}.md
• mydocs/working/task_m100_860{,_stage_a,_stage_b,_stage_c,_stage_d_a,_v2}.md

🤖 Generated with Claude Code