첫 글자 장식: SDK로 DoubleLine·Margin 구조와 크기 산정 규칙 확인

[airmang]

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

재현

현재 TripleLine만 지원합니다. 아래 호출은 두 스타일 모두 HwpxValueError(code="shape-drop-cap-style-unsupported")로 거부됩니다.

from hwpx import HwpxDocument
for style in ("DoubleLine", "Margin"):
    with HwpxDocument.new() as doc:
        p = doc.add_paragraph("본문")
        doc.shapes.add_drop_cap("가", width=3000, height=4500, style=style, paragraph=p)

이 제한은 src/hwpx/oxml/drop_cap.py에 명시된 계약입니다. 외부 코퍼스에는 TripleLine 예시만 확인되어 다른 스타일의 실문서 빈도는 이번에 증명하지 않았습니다. 낮은 우선순위의 관찰 과제로 등록합니다.

SDK 관찰 요청

실제 SDK가 두 스타일을 저작할 수 있는지 먼저 확인해 주세요. 스타일·글꼴·글자 크기를 바꾼 한컴 저장본에서 rect/drawText/배치 속성과 박스 크기 관계를 비교하면, 구조가 같다는 추측 없이 지원을 확대할 근거가 됩니다. 현재 폭/높이 자동 산정도 근거가 없어 호출자가 직접 지정합니다.

완료 기준은 확인된 스타일별 구조/배치 규칙과 렌더 비교입니다. 자동 크기 계산은 충분한 관찰 근거가 있을 때 별도 계약으로 추가하고, SDK 액션이 없거나 근거가 부족하면 명시적 미지수로 남겨 주세요. 상위 도형 지원 과제 #51과 연관됩니다.

검증 원칙

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

[airmang]

한/글이 읽고 다시 저장한 결과로 확인했습니다.

• 한/글의 자동화 명령으로는 첫 글자 장식을 새로 만들 수 없었습니다. 그래서 python-hwpx가 만든 TripleLine 장식에서 dropcapstyle과 hp:parameterset 값만 바꾼 문서를 한/글에서 열고 다시 저장했습니다.
• 구조: 세 스타일 모두 같은 hp:rect + hp:drawText입니다. 한/글은 dropcapstyle과 parameterset 값(DoubleLine 1, TripleLine 2, Margin 3)을 그대로 저장합니다. 두 값이 어긋나면 parameterset 값을 따릅니다.
• 배치: 상자 크기가 같으면 세 스타일의 화면이 같습니다. 스타일 값이 아니라 상자 높이가 본문을 밉니다. 문단 위에서 k번째 줄(0부터)은 k × 줄 간격 < 상자 높이이면 상자 옆으로 가고, 상자 폭 + 오른쪽 바깥 여백(850)만큼 들여써집니다. 10pt 160%, 16pt 160%, 10pt 250%에서 경계값(k × 줄 간격과 +1)으로 확인했습니다.
• 크기: 한/글이 저장한 TripleLine 문서(10pt, 160%)의 상자는 4200 = 2 × 1600 + 1000, 곧 (N−1) × 줄 간격 + 본문 글자 높이이고, 안쪽 글자 크기도 4200입니다. 이 식은 줄 간격이 100% 이상이면 위 규칙에 따라 늘 N줄을 옆으로 보냅니다. 한/글 대화상자가 다른 글자 크기에서도 같은 식을 쓰는지는 확인하지 못했습니다.
• Margin: 같은 모양과 크기로 쓰면 한/글은 다른 스타일과 똑같이 그립니다(여백으로 옮기지 않음). 대화상자가 Margin에서 상자를 어디에 두는지는 확인할 수 없어 미지수로 둡니다.

#327로 DoubleLine을 같은 구조에 parameterset 1로 지원했고, Margin은 계속 거부합니다. 크기 자동 계산은 넣지 않았습니다. 넣는다면 "N줄을 옆으로 보내는 크기"((N−1) × 줄 간격 + 본문 글자 높이)로 따로 정의하는 것이 근거와 맞습니다.