Refs #938

문제

samples/복학원서.hwp의 중앙 JPEG 워터마크가 rhwp SVG / WebCanvas / rhwp-studio overlay 경로에서 큰 회색 사각형 배경처럼 보입니다.

원본 JPEG에는 alpha 채널이 없고 near-white 배경 픽셀이 포함되어 있습니다. 기존 렌더러는 이 JPEG 전체에 밝기/대비 보정, opacity, blend 처리를 적용했기 때문에 워터마크 문양뿐 아니라 JPEG 배경 영역까지 함께 보정되어 사각형 흔적이 남았습니다.

원인

한컴 PDF 출력 결과는 JPEG 원본에 SVG/CSS 필터를 실시간 적용한 결과라기보다, 워터마크 톤을 흰 배경 위에 미리 합성한 opaque 이미지에 가깝습니다.

따라서 기존처럼 JPEG 전체를 반투명 필터 이미지로 취급하면 다음 차이가 생깁니다.

• near-white 배경 픽셀도 필터/opacity 대상이 되어 회색 사각형이 남음
• SVG 렌더러와 rhwp-studio overlay가 서로 다른 필터 경로를 타며 톤 차이가 커짐
• WASM overlay 경로에서는 JPEG decode feature가 없어 동일 보정을 적용하기 어려움

수정

워터마크성 JPEG에 한해 한컴 출력에 가까운 opaque PNG로 미리 bake한 뒤, 모든 렌더 경로가 이 baked PNG를 사용하도록 맞췄습니다.

• src/renderer/svg.rs
  • PicEffect != RealPic, 밝기/대비 보정값, JPEG MIME/시그니처, near-white 배경 비율을 함께 확인해 워터마크성 JPEG만 감지
  • near-white 픽셀은 opaque white로 유지
  • 비흰색 워터마크 픽셀은 한컴 PDF 참고 렌더에 가까운 gray ramp로 변환
  • baked PNG에는 기존 SVG 필터와 opacity=0.17을 다시 적용하지 않음
• src/document_core/queries/rendering.rs
  • overlay image JSON에 bakedWatermark: true 추가
  • overlay 경로에서도 동일한 baked PNG data URL을 반환
• src/renderer/web_canvas.rs
  • WebCanvas 직접 렌더 경로도 baked PNG를 사용하고 중복 필터 적용을 생략
• rhwp-studio/src/view/page-renderer.ts
  • bakedWatermark overlay는 CSS filter, mix-blend-mode, opacity를 적용하지 않음
• Cargo.toml
  • WASM에서도 JPEG decode가 가능하도록 image crate feature에 jpeg 추가
• 테스트
  • tests/issue_938.rs 추가
  • tests/issue_514.rs의 JPEG 워터마크 기대값 갱신
  • tests/golden_svg/issue-677/bokhakwonseo-page1.svg 갱신

시각 비교

아래 이미지는 PR 작성 후 수동 첨부 예정입니다. 한컴 PDF는 CONTRIBUTING 안내에 따라 절대 기준이 아니라 참고 렌더로 사용합니다.

작업 전 렌더 (upstream/devel)	작업 후 렌더 (이 PR)	한컴 PDF (복학원서-2022.pdf)

검증

통과:

• cargo test --release --test issue_938 --test issue_514 --test issue_516 --test svg_snapshot
• cargo check --target wasm32-unknown-unknown --release --lib
• npm run build (rhwp-studio)
• git diff --cached --check

확인했지만 통과하지 않은 항목:

• cargo test --release --lib
  • 결과: 1296 passed / 1 failed / 2 ignored
  • 실패 테스트: renderer::layout::integration_tests::tests::test_548_cell_inline_shape_first_line_indent_p8
  • 이번 PR은 해당 layout 테스트가 의존하는 배치 로직 파일을 수정하지 않습니다.
• cargo clippy --release --lib -- -D warnings
  • 실패 위치: src/diagnostics/hwp5_contract_probe.rs:366
  • lint: clippy::unnecessary_unwrap
  • 이번 PR에서 수정하지 않은 기존 diagnostics 코드입니다.

리뷰 포인트

• 워터마크 판별 조건을 의도적으로 좁게 두었습니다. 일반 JPEG/PNG/PCX 이미지에는 기존 경로가 유지됩니다.
• baked PNG는 opaque 출력입니다. 투명 PNG로 만드는 방식도 검토했지만, 한컴 PDF 참고 렌더와 톤이 더 벌어져 최종안에서 제외했습니다.
• 중앙 워터마크 위치에는 아직 작은 차이가 남아 있습니다. 이 PR은 파일별 위치 보정을 넣지 않고, #938의 배경 사각형/톤 문제만 처리합니다.
• 다른 워터마크 파일을 테스트하면서 발견한 PageBackground/fill-mode 문제는 별도 이슈 PageBackground 이미지 fill_mode(Center 등)가 전체 페이지 늘림으로 렌더링됨 #975 로 분리했습니다.