그룹 resize: 구성원 좌표·행렬을 참조 결과와 비교하고 크기 변경 계약 확정

[airmang]

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

현재 구조 관찰

외부 입력 tests/fixtures/hwpxlib_corpus/reader_writer__SimpleContainer.hwpx에서 그룹의 orgSz는 17372×3250, 직속 구성원은 pic, pic, line 3개입니다. 그룹의 resize(34744, 6500) 호출 후 그룹 크기는 두 배가 되지만 구성원 3개의 XML은 바이트 동일했습니다.

from hwpx import HwpxDocument
from lxml import etree
with HwpxDocument.open("tests/fixtures/hwpxlib_corpus/reader_writer__SimpleContainer.hwpx") as doc:
    s = next(s for p in doc.paragraphs for s in p.shapes if s.shape_type == "container")
    children = [c for c in s.element if etree.QName(c).localname in {"pic", "line"}]
    before = [etree.tostring(c) for c in children]
    s.resize(34744, 6500)
    print(len(children), before == [etree.tostring(c) for c in children])  # 3 True

처리 요청

같은 원본의 그룹 크기를 바꾼 참조 저장본과 렌더를 확보하고 그룹/구성원의 크기·offset·변환 행렬을 비교해 주세요. 현재 결과의 시각적 오류 여부는 아직 검증하지 않았습니다. 따라서 구성원 XML이 그대로라는 사실만으로 결함이라고 단정하지 않습니다.

한컴의 실제 규칙을 기준으로 현재 resize()가 의도한 표시 크기를 만드는지 판정하고, 필요하다면 그룹 변환을 수정하거나 그룹 전용 API/명확한 거부 계약을 정해 주세요. 그림 2개와 선의 상대 위치·크기를 실제 렌더로 확인하고 회귀검사를 추가하는 것이 완료 기준입니다. 관련 코드: src/hwpx/oxml/objects.py의 resize/_scale_geometry.

검증 원칙

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

[airmang]

한/글이 그린 결과와 한/글이 다시 저장한 파일로 확인했습니다.

• 한/글은 묶음을 hp:sz 크기로 그립니다. sz만 두 배로 바꾸면 구성원이 두 배로 그려지고, curSz만 바꾸면 그대로입니다. orgSz, curSz, 행렬, 구성원 XML은 그림을 바꾸지 않습니다. 그래서 고치기 전의 resize()도 의도한 크기로 그려졌고(두 배, 폭만 모두), 한/글이 크기를 바꾼 모양과 화면이 같았습니다.
• 다만 저장 모양이 다릅니다. 한/글은 크기를 바꾼 묶음에서 orgSz를 원래 크기로 두고, curSz·sz를 새 크기로, 묶음 scaMatrix를 새 크기/원래 크기로 씁니다. 구성원마다 첫 scaMatrix에 같은 배율과 이동(오프셋 × (배율 − 1))을 넣고, 구성원 curSz = orgSz × 배율로 씁니다. 고치기 전 resize()는 orgSz까지 새 크기로 바꿔서, 한/글이 그 파일을 다시 저장하면 curSz가 표시 크기의 두 배로 기록됐습니다.

#322에서 resize()가 위 한/글 모양대로 쓰도록 고쳤습니다. 묶음 안 묶음과 python-hwpx가 만든 묶음까지, 한/글이 다시 저장한 파일을 fixture로 구조를 비교하는 회귀검사가 들어 있습니다.