곡선·스마트 연결선 저작: SDK 저장본으로 bbox·부착점·변환 행렬 규칙 확보

[airmang]

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

확인한 지원 공백

현재 전용 곡선/스마트 연결선 저작 API는 없고 기존 요소는 읽기·보존으로 다룹니다. docs/support-matrix.md에 다음 미확정 규칙이 기록되어 있습니다:

• tests/fixtures/hwpxlib_corpus/reader_writer__SimpleCurve.hwpx: 곡선 bbox가 앵커점 bbox보다 커 정확한 곡선 적합/크기 산정 근거가 부족함.
• tests/fixtures/hwpxlib_corpus/reader_writer__SimpleConnectLine.hwpx: 다른 도형을 잇는 subjectIDRef, offset, orgSz/curSz, scale/translation 행렬의 관계가 미확정.

이는 새 시각적 실패를 재현한 버그가 아니라 구현 근거가 부족한 저작 지원 공백입니다. 상위 도형 저작 이슈 #51을 구체화하는 과제입니다.

SDK 관찰 요청

먼저 해당 편집 액션이 실제 SDK에서 가능한지 확인해 주세요. 가능하다면 곡선의 한 점, 연결 대상, 대상 도형 위치/크기를 하나씩 바꿔 저장한 A/B 구조와 렌더 기준을 확보해 주세요. 비부착 연결선과 도형에 붙은 연결선을 구분하고, 회전/리사이즈 뒤 관계도 관찰해 주세요.

완료 기준은 외부 입력에서 확인한 사용 형태를 지원하는 명시적 저작 계약과 SDK 렌더 비교입니다. 표본 몇 개에서 임의의 전체 곡선 적합 공식을 추정하거나, 관계가 불명확한 좌표를 조용히 생성하지 않습니다.

검증 원칙

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

[airmang]

한/글이 그린 결과와 다시 저장한 파일로 확인했습니다. 두 입력의 값을 하나씩 바꿔 봤습니다.

곡선

• 한/글은 hp:seg 좌표를 sz/orgSz 배율로 그립니다. 점 하나를 옮기고 크기를 그대로 두면, 곡선은 새 점을 지나 제대로 그려지지만 한/글도 orgSz·sz를 다시 계산하지 않습니다. 그래서 크기 상자는 쓰는 쪽이 정해야 합니다.
• 한/글이 저장한 곡선의 상자는, 앵커를 지나는 Catmull-Rom 곡선(제어점은 이웃 점 차이의 1/6)을 구간마다 16단계 꺾은선으로 근사한 상자와 같습니다(SimpleCurve는 16636×21360으로 정확히 같음). 최상위의 CURVE만 있는 곡선에서 맞고, LINE 구간이 섞이거나 묶음 안에 있는 곡선에서는 맞지 않아 그런 곡선의 상자는 계산하지 않는 것이 맞다고 봅니다.

연결선

• 도형에 붙은 연결선(subjectIDRef)은 한/글이 그릴 때 대상 도형의 현재 위치·크기와 subjectIdx(0 위, 1 오른쪽, 2 아래, 3 왼쪽 가운데)로 경로를 다시 계산합니다. 대상을 옮기거나 키우면 선이 따라가지만, 다시 저장해도 startPt·endPt·sz는 바뀌지 않습니다.
• 떼어 낸 연결선(subjectIDRef="0")은 저장된 좌표 그대로 그립니다.
• STRAIGHT는 두 부착점 사이 직선, STROKE는 한/글이 정하는 꺾인 경로입니다. ARC는 제어점 없이는 알맞게 그려지지 않았습니다.

#332로 doc.shapes.add_curve()와 add_connector()를 더했습니다. 곡선은 CURVE 구간만 쓰고, 상자는 위 규칙으로 계산합니다. LINE이 섞인 곡선과 묶음 안 곡선은 쓰지 않습니다. 연결선은 두 도형의 변 가운데(subjectIdx 0~3)에 붙이고, 저장 좌표를 그 점으로 계산해 한/글 화면과 맞춥니다. STRAIGHT와 STROKE만 쓰고 ARC는 거부합니다.