estimate_pages: 줄 캐시 없는 덧말·글자 겹치기의 줄 폭·높이 계산

[airmang]

검사한 공개 main은 97670eb2462e106134633acd78a8097d96db0fdd입니다(Python 3.13.13, macOS). 아래 입력은 저장소에 포함되어 있습니다. 추가 참조 검증은 아직 실행하지 않았으며, 관찰 결과를 바탕으로 엔진 지원을 확대하기 위한 과제입니다. core에 외부 실행 환경 의존을 추가하는 제안은 아닙니다.

현재 제한

외부 입력 hwpxlib_corpus/reader_writer__SimpleCompose.hwpx와 reader_writer__SimpleDutmal.hwpx는 원본에서 pages=1을 반환합니다. section XML의 hp:linesegarray를 제거한 진단 복사본에서는 각각 compose in a paragraph without a layout cache, dutmal in a paragraph without a layout cache로 거부됩니다.

hwpxlib_corpus/error__20250808__2015년_12월_재난안전종합상황_분석_및_전망.hwpx도 원본에서는 84를 반환하지만 캐시 제거 후 compose로 거부됩니다. 84쪽의 실제 정확성은 이번에 검증하지 않았습니다. 캐시 제거는 진단 변형이며 원본의 자연 상태나 모든 편집의 동작으로 주장하지 않습니다.

신규 저작에서도 직접 재현됩니다:

from hwpx import HwpxDocument
from hwpx.experimental import estimate_pages
for kind in ("dutmal", "compose"):
    with HwpxDocument.new() as doc:
        p = doc.add_paragraph("본문")
        if kind == "dutmal":
            doc.shapes.add_dutmal("본문", "덧말", paragraph=p)
        else:
            doc.shapes.add_composed_character("가나", paragraph=p)
        print(kind, estimate_pages(doc))

처리 요청

글자 크기·겹침 종류·덧말 위치·문단 폭을 바꾼 참조 저장본에서 줄 시작점과 높이를 관찰해 주세요. 기존 캐시를 읽는 지원에 더해 새 저작과 실제 편집 후 배치도 계산하는 것이 목표입니다. 관련 코드: src/hwpx/layout/pages.py와 src/hwpx/form_fit/measure.py. #303의 캐시 있는 문단 지원을 확장하는 별도 범위입니다.

검증 원칙

입력 SHA-256·산출물 해시를 기록하고, 페이지 렌더와 한컴 재저장 HWPX를 비교해 회귀 기준으로 남겨 주세요. 캐시가 있는 원본과 편집으로 캐시가 무효화된 경우를 구분하고, 검증 환경에 따라 결과가 다르면 별도 기준으로 기록해야 합니다. 미지원 이유를 제거하거나 파일이 열리는 것만으로 완료하지 않습니다.

[airmang]

#323에서 고쳤습니다. 한/글이 저장한 문서로 확인한 규칙입니다.

• 글자 겹치기와 덧말은 그 run의 글자처럼 제자리에서 폭을 차지하고, 줄은 보통 글자처럼 나뉩니다(본문과 표 칸 모두).
• 글자 겹치기의 폭은 틀(원·사각형 등)이 있거나 펼침(SPREAD)이면 한글 한 글자의 폭이고, 틀 없이 겹치면(CHAR, OVERLAP) 가장 넓은 글자의 폭입니다. 줄 높이는 바뀌지 않습니다.
• 덧말의 폭은 본말의 폭입니다. 덧말이 더 길어도 같습니다.
• 덧말이 든 줄의 높이는 1/1800인치 단위로 셉니다. 위 덧말은 본말 크기에 덧말 크기(비율이 0이면 50%)를 더하고, 아래 덧말은 본말 크기의 91/100(버림)에 덧말 크기를 더합니다.
• 위·아래가 아닌 자리의 덧말, 줄 간격이 퍼센트가 아닌 문단의 덧말, 글자처럼 두지 않은 개체 곁의 경우는 구체적인 사유와 함께 지원 밖으로 둡니다.

참고로 error__20250808__2015년_12월_재난안전종합상황_분석_및_전망.hwpx는 한/글에서 75쪽입니다. 추정값 84쪽과의 차이는 글자 겹치기와 관계없는 다른 배치 문제라 따로 봅니다.