3.3 KiB
3.3 KiB
| name | description | type |
|---|---|---|
| 페어링 인덱스 master = roofLines 정책 | skeleton-utils.js 라인 페어링 정렬 master 를 wallLines→roofLines 로 변경한 정책 (2026-04-27) | project |
정책: src/util/skeleton-utils.js (13421359) 의 라인 페어링 정렬에서 roofLines 를 단일 master 로 사용. wall.lines / wall.baseLines 는 roofLines 의 raw 인덱스 1:1 매핑으로 정렬.
Why:
- 사용자 원칙: "인덱스가 여기에는 생명이다. leftTop(최저 좌표) 꼭짓점에서 시작해 CCW 로 그려 나간다."
- 사용자가 다각형을 시계방향(CW)으로 그릴 수도 있음 → 그래서 인덱스를 다시 세워야 한다. 항상 최저 좌표(leftTop, min-Y → min-X) 를 #1 로 놓고 CCW 로 재정렬해 정규화. 사용자의 그리는 방향(CW/CCW)에 무관하게 고유한 시작점/순서를 보장.
- 종전 master 였던
wallLines (= wall.lines)는useMode.js:1880,usePropertiesSetting.js:165,useRoofShapePassivitySetting.js:242에서 재할당 가능 → 시작점 산정이 흔들릴 위험. roofLines는 외곽(처마) 경계라 사용자 mutation 영향 없음 → 시작점 안정.- B-7 OVER 시 보조라인이 B-5/B-3 위치에 그려진 간헐 버그가 정렬 master 흔들림에서 비롯됐을 가능성.
How to apply:
- ensureCounterClockwiseLines 의 입력은 roofLines (master). leftTop = min-Y → tiebreak min-X 꼭짓점에서 CCW.
- wall.lines, wall.baseLines 는 raw 인덱스 보존이 전제 (코드상 페어링 1:1 가정).
_keyOfEdge는 좌표를 0.1 단위로 라운드 후 양 끝점 정렬 키 생성 → 부동소수점 drift 흡수.ensureCounterClockwiseLines내부 graph 키도 0.1 단위 round (2026-05-06 추가) — caller_keyOfEdge와 동일 정책으로 통일.- 매핑 실패 시 fallback 으로 sortRoofLines 항목 자체를 사용 (안전망).
- 추후 wall.* 가 수정될 때 raw 인덱스가 보존되는지 검증 필요. 만약 깨진다면 매핑 키를 좌표 대신 라인 ID 기반으로 변경 검토.
ensureCounterClockwiseLines drift 보강 (2026-05-06):
- 증상: 같은 도형인데 간헐적으로 인덱스 시작점/순서가 바뀌는 현상 (사용자가 다시 그리면 정상화).
- 원인: 함수 내부
graphMap 키가 raw 좌표 (${line.x1},${line.y1}) 라서 drift (e.g. 100.0 vs 100.0000001) 로 같은 점이 별개 노드로 등록 → graph 끊어짐 → traversal 중도 break → result.length < lines.length → 페어링 어긋남. - 수정 위치 (
skeleton-utils.js:3463)::3469-3480graph 빌드 시 endpoint 좌표Math.round(v*10)/10로 round, 이웃 객체{x,y}도 rounded 저장 (후속${n.x},${n.y}키가 graph 키와 일치):3528isReversed비교를 정확비교 →Math.abs(line.x1 - next.x) > 0.05approx (round 절반 임계). raw line.x1 vs rounded next.x 불일치 false-positive 차단
- 영역 외 보존: atan2 / area 부호 / result 라인 좌표는 raw 그대로 (다운스트림 정확도 유지).
- 정상 케이스 (drift 없음) 동작 변화 없음. 100.0 round = 100.0.
관련:
feedback_over_move_silent_skip.md(OVER 클램핑 정책)project_over_move_red_helper_deferred.md(빨강 보조선 별건 이슈)project_parallel_collapse_fix.md(평행 이동 SK 붕괴)feedback_same_point_tolerance.md(좌표 매칭 tolerance)