배경

Task #516 (`PageLayerTree image brightness/contrast` + 다층 레이어 도입) 의 후속으로 분리.

본 이슈는 그림 워터마크 효과의 회색조 처리 + 투명도 조절 의 정합한 시각 알고리즘 정의를 다룬다.

결함

`samples/복학원서.hwp` 의 가운데 고려대학교 엠블럼 (s0:pi=2 bin_id=2 JPEG, BehindText, IR `effect=GrayScale brightness=-50 contrast=70 watermark=custom`):

• rhwp Web Canvas 출력: 회색조 + multiply blend 적용 → 검정에 가까운 진한 회색 으로 표시
• 한컴 출력: 같은 IR 값 → 연한 회색 + 흐릿함 (워터마크 본질 시각)

본 결함의 본질 (Task #516 결함 2 분석 결과)

CSS filter `brightness(0.5) contrast(1.7)` (IR 값 그대로 매핑) + `mix-blend-mode: multiply` 만으로는 한컴 워터마크 시각 정합 불가.

가능한 본질:

1. HWP IR 값 ↔ 한컴 GUI 표시값 매핑이 swap 또는 비선형 — IR 의 b/c 값과 한컴이 보여주는 시각이 다른 매핑
2. 한컴 워터마크 효과 ON 시 추가 시각 처리 (예: opacity / 투명도 강제 보정) — IR 에 저장 안 되는 한컴 자체 보정
3. 편집자가 의도한 시각이 한컴 출력 시각 — IR 값 충실 적용은 편집자 의도 왜곡

작업지시자 정합

한컴을 믿으면 안 됨. 자체적으로 D-1 로 우리는 해석하면 될 듯합니다.

→ rhwp 자체 시각 해석 정의. 한컴 시각은 참고만 하고 권위 미입증 (메모리 `feedback_pdf_not_authoritative`).

본 task 의 범위

포함

• 워터마크 식별 시 (IR `effect != RealPic && (brightness != 0 || contrast != 0)`) rhwp 자체 흐림 처리 알고리즘 정의
• multiply blend 외 추가 시각 처리 (opacity / 추가 brightness 보정 / blend mode 변경 등)
• 편집자 의도 (IR b/c 값) 보존 + 워터마크 시각 본질 (흐릿함 + 텍스트 가독성 보장) 균형
• 한컴 자동 프리셋 (`b=70, c=-50`) 정합 fixture 추가 시 시각 검증

제외

• HWP 스펙 / 한컴 hwpconverter 의 정확한 매핑 알고리즘 조사 (장기 별도 task)
• IR 값 자체 변환 (parser/serializer 영역)

정정 후보

작업지시자 권장: D-1.

의존성 (선행 task)

• Task rhwp-studio (web) 에서 그림 회색조/밝기/대비 효과가 적용되지 않음 — CLI SVG 와 정합성 회귀 #516 ✅ 완료 — 다층 레이어 도입 + Web Canvas effect 적용 + dump/JSON `watermark` 필드 + hit-test 옵션 3-C
• 본 task 는 Task rhwp-studio (web) 에서 그림 회색조/밝기/대비 효과가 적용되지 않음 — CLI SVG 와 정합성 회귀 #516 의 시각 정정만 별도 분리

정답지

• 한컴 2010 + 한컴 2022 출력 (참고만, 권위 미입증)
• rhwp 자체 시각 해석 (작업지시자 시각 판정 기준)

환경

• 버전: 본 사이클 (v0.7.9 devel) 의 다층 레이어 도입 후
• 샘플: samples/복학원서.hwp (가운데 고려대학교 엠블럼)
• 정답지: rhwp 자체 시각 해석 + 작업지시자 판정