HWPX: 온라인 데모에서 HWPX 1페이지 상단 이미지가 표시되지 않음

[Mireutale]

서울 문화예술단체 지원사업.hwpx.zip

현상

특정 HWPX 파일을 rhwp로 SVG 렌더링하면 1페이지 제목 영역의 이미지가 누락됩니다.

누락되는 이미지는 문화예술단체 지원사업 제목 오른쪽 위에 표시되어야 하는 이미지입니다. 원본 HWPX XML에는 내부표 첫
번째 셀에 hp:pic으로 존재하며, binaryItemIDRef="image2"를 참조합니다. 하지만 rhwp SVG 출력에는 해당 image2가
<image> 요소로 생성되지 않습니다.

재현 방법

웹 사이트에서 확인해보면, 제목 근처 이미지가 출력되지 않는 문제점

기대 결과

실제 결과

rhwp SVG 렌더링 결과에서는 해당 이미지가 표시되지 않습니다.

추가 확인:

• 원본 HWPX에는 binaryItemIDRef="image2" 그림이 존재함
• BinData/image2.png는 정상 PNG임
• 해당 그림은 내부표 첫 번째 셀에 위치함
• 생성된 SVG에는 image1만 로 출력되고, image2는 출력되지 않음

환경

• rhwp 버전: 최신 저장소 커밋 f4a4968
• 확인 방식: CLI/SVG 렌더링
• 비교 기준: 한컴독스 웹
• OS: macOS

[edwardkim]

해당 문제는 표의 캡션에 이미지를 사용한 케이스로 확인되었습니다. 캡션에 이미지를 넣고 그 이미지에 또 캡션을 지정해서 이미지를 넣는 재귀적인 문제가 발생되는 것을 아래한글에서 허용하는 것을 확인하였습니다. 몇 depth 까지 허용할지 고민해보겠습니다.

[oksure]

원인 위치를 추적해 공유합니다 (depth 정책 결정과 맞물린 부분이라 구현 대신 진단만 남깁니다).

렌더 경로 확인

layout_caption(src/renderer/layout/picture_footnote.rs)이 캡션 문단을 layout_composed_paragraph로 넘길 때 마지막 인자 para/bin_data_content를 None으로 고정 전달합니다. 이 두 인자는 "treat_as_char 이미지 인라인 렌더링에 사용"(paragraph_layout.rs doc 주석)이므로, 현재 구조상 캡션 안 이미지는 인라인/플로팅 어느 쪽도 렌더되지 않습니다.

본 샘플의 케이스 = 플로팅

첨부 샘플의 image2는 캡션 내부에서 textWrap="TOP_AND_BOTTOM", 즉 treat_as_char가 아닌 플로팅 배치입니다 (section0.xml의 <hp:caption> 내부 <hp:pic ... textWrap="TOP_AND_BOTTOM"> 확인). 따라서:

• (a) layout_caption에 para/bin_data_content를 스레딩하면 인라인(treat_as_char) 캡션 이미지는 살아나지만,
• (b) 본 샘플 같은 플로팅 캡션 이미지는 셀 경로(table_layout.rs)의 플로팅 배치 로직(앵커/줄 매핑/wrap)을 캡션 영역에도 적용해야 해소됩니다.

재귀 깊이 관련 참고

(a)만 적용하는 경우 paragraph_layout.rs의 인라인 이미지 경로는 layout_caption을 재호출하지 않으므로 "캡션 속 그림의 캡션"은 구조적으로 렌더되지 않습니다 — 인라인 한정으로는 추가 가드 없이 자연스럽게 depth 1이 됩니다. 플로팅 경로를 캡션에 어디까지 일반화할지가 depth 정책의 본론으로 보입니다.

방향이 정해지면 (a) 스레딩 부분은 PR로 기여하겠습니다.

[edwardkim]

@oksure 진단 감사합니다. 코드를 다시 확인했고, 진단이 정확합니다.

layout_caption이 layout_composed_paragraph를 호출할 때 마지막 인자들(para/bin_data_content 등)을 None으로 고정 전달하고 있습니다 (src/renderer/layout/picture_footnote.rs:656–659). 이 때문에 캡션 안의 treat_as_char 이미지가 인라인으로 렌더되지 않습니다.

방향 결정 — (a) 인라인 스레딩, depth 1

말씀하신 (a) / (b) 중 (a) 인라인 스레딩만 이번 범위로 진행해 주세요.

• (a) 인라인 캡션 이미지 (treat_as_char): layout_caption에 para/bin_data_content를 스레딩해 살립니다. 이 경로는 layout_caption을 재귀 호출하지 않으므로 진단에 적어 주신 대로 추가 가드 없이 자연스럽게 depth 1로 한정됩니다. "캡션 속 그림의 캡션"은 이번 범위에서 구조적으로 렌더되지 않는 것이 의도된 동작입니다.
• (b) 플로팅 캡션 이미지 (본 샘플 image2, textWrap="TOP_AND_BOTTOM"): 셀 플로팅 배치 로직(앵커/줄 매핑/wrap)을 캡션 영역으로 일반화하는 별개의 큰 작업이라, 별도 후속 이슈로 분리합니다. 본 샘플의 완전 해소는 그 후속에서 다룹니다.

작은 단위로 끊어 회전하려는 의도이니, 이번 PR은 (a)에 집중해 주세요.

PR 진행 안내

• base는 devel, 작업 브랜치에서 devel 타깃으로 PR 부탁드립니다.
• 캡션 내 인라인 이미지를 포함하는 회귀 테스트(또는 렌더 산출 비교) 한 건을 함께 넣어 주시면 좋겠습니다.
• 본 샘플(image2)은 플로팅이라 이번 (a) PR로는 화면에 안 나타나는 게 정상입니다. 따라서 이 이슈는 (a) PR merge 후에도 닫지 않고 (b) 후속까지 추적 상태로 둡니다. PR description에는 "depth 1 인라인 한정, 플로팅은 후속"임을 적어 주세요.

방향은 위로 확정합니다. 진행 부탁드립니다.

[postmelee]

PR #1551 이 merge되어 캡션 문단 안의 treat_as_char 인라인 이미지 렌더링 경로는 반영되었습니다.

• merge commit: a94e205
• 해결된 범위: layout_caption()에서 캡션 문단의 실제 para와 bin_data_content를 paragraph layout에 전달해 인라인 TAC picture가 ImageNode로 방출되도록 수정
• 검증: issue_1270_caption_inline_image 테스트에서 텍스트 포함 캡션과 picture-only 캡션 케이스 모두 통과

다만 이 이슈 첨부 샘플의 오른쪽 상단 SEOUL MY SOUL 로고는 캡션 내부 그림이지만 textWrap="TOP_AND_BOTTOM"인 플로팅 배치입니다. 이 범위는 #1551 에 포함하지 않았고, #1585 에서 별도로 추적합니다.

따라서 #1270은 아직 닫지 않고 open 상태로 유지합니다.