SVG Graphics Geometry
Guide
css-matrix
Guide
css-matrix
  • Part 0. SVG 기초

    • SVG란 무엇인가
    • viewBox와 user space
    • transform attribute와 matrix
    • SVG 문서 구조와 기본 도형
  • Part 1. Path grammar

    • path d 명령어 — M, L, Z
    • H, V — 축 정렬 직선
    • C — cubic Bézier
    • Q — quadratic Bézier
    • S, T — smooth continuation
    • A — elliptical arc
    • path bounding box
  • Part 2. Stroke geometry

    • 점에서 stroke까지의 거리
    • join, cap, miter limit
    • stroke align과 outline 개념
    • miter length 공식
  • Part 3. Fill rules

    • nonzero vs evenodd
    • fill hit testing
  • Part 4. Path sampling

    • flatten tolerance
    • path length
    • point at length와 tangent
  • Part 5. Paint servers

    • linearGradient 좌표
    • clipPath와 mask 개념
  • Part 6. Path editor capstone

    • path handle 모델
    • handle hit testing
    • handle drag로 segment 갱신
    • mini path editor — SVG round-trip
  • Part 7. Fill & winding deep dive

    • winding vs ray casting
    • compound path — 여러 subpath
    • self-intersection
    • path boolean
    • fill vs stroke hit 우선순위
    • scanline parity
  • Part 8. Pattern & gradient

    • radialGradient
    • pattern tile
    • gradientUnits와 spreadMethod
  • Part 9. SVG filter & Figma effects

    • Figma DROP_SHADOW → SVG filter
    • filter chain 개요
    • blur · offset · merge
    • inner shadow
    • layer blur vs background blur
    • Figma effect 매핑표 전체
  • Part 10. Figma ↔ SVG bridge

    • vector network vs path d
    • fill · stroke export
    • boolean operations export
    • mask · clip export
  • Part 11. Icon design

    • pixel grid · optical alignment
    • fill vs stroke icons
    • symbol · sprite · currentColor
    • path simplification
  • Appendix A. SVG in CSS

    • currentColor · CSS theming
    • sprite data URI
    • SVG optimization pipeline
  • Appendix B. Engine extras

    • dash offset animation
    • adaptive flatten
    • arc → cubic 변환
    • multi-subpath editing
  • Part 12. Foundations primer

    • capability map
    • coordinate stack
  • Part 13. Figma ↔ SVG (deep)

    • Figma paint gap map
    • radial · angular gradient export
    • image · pattern fill
    • stroke align export
    • blend mode · layer opacity
  • Part 14. SVG spec breadth

    • markers — 화살표와 dash 끝
    • text · textPath
    • paint-order · opacity · filters
    • arc flatten 통합
  • Part 15. Curve calculus

    • de Casteljau subdivision
    • flatness와 chord error
    • 곡률 κ와 법선
    • arc center parameterization
    • G¹ smooth — S와 T
    • shoelace signed area
  • Part 16. Intersection & proximity

    • segment intersection
    • line ∩ cubic · curve ∩ curve
    • closest point on curve
  • Part 17. Offset curves

    • normal offset sampling
    • offset cusps
  • Part 18. Transform algebra

    • affine inverse & decompose
    • transform path vs group
  • Part 19. Rational curves

    • circle as cubic — κ constant
    • rational curves & exact arcs
  • Part 20. Tessellation & pixels

    • convex triangulation · ear clipping
    • evenodd parity → pixels
  • Part 21. Compositing math

    • Gaussian blur kernel
    • Porter–Duff & premultiplied α
  • Part 22. Math topic map

    • SVG 수학 주제 지도
  • Part 23. SVG animation

    • SMIL — animate 속성
    • SMIL — animateTransform
    • SMIL — animateMotion
    • stroke dash draw-on
    • CSS offset-path motion
    • path morph
    • JS motion along path
  • Part 24. Motion precision

    • uniform speed along path
    • cubic–cubic intersection
    • SVGPathElement length API
    • SMIL keyTimes & keySplines
    • degree elevation Q→C
  • Part 25. GPU mesh & WAAPI

    • triangulation with holes
    • WAAPI + SVG attributes
    • evenodd fill + triangle mesh

handle drag로 segment 갱신

handle을 드래그하면 segment graph가 바뀌고, 연결된 segment의 from/to가 동기화됩니다. 화면의 d 속성은 매 프레임 또는 mouseup 시 직렬화합니다.

데모에서 볼 것

  • createPathEditor — allowDrag: true
  • 파란 anchor, 흰 control — control polygon 점선
  • 드래그 시 readout에 live d 문자열 + handle 개수
  • path-editor.js가 updatePathHandle → pathDFromSegments 호출

updatePathHandle

import { updatePathHandle, pathDFromSegments, pathFromD } from "svg-matrix-core";

let { segments } = pathFromD(initialD);

function onHandleDrag(handleId, newPoint) {
  segments = updatePathHandle(segments, handleId, newPoint);
  const d = pathDFromSegments(segments);
  pathElement.setAttribute("d", d);
}

handleId 예: "c1:2" (segment 2의 cp1), "a:3" (segment 3의 anchor).

endpoint 동기화

한 anchor를 움직이면 **이전 segment의 to**와 **다음 segment의 from**이 같아야 합니다. core는 syncPathEndpoints로 이를 유지합니다.

import { pathFromD } from "svg-matrix-core";

// pathFromD = parse + syncPathEndpoints

드래그 중 끊긴 path가 보이면 sync가 빠진 것입니다.

path-editor 구조

  let segments = pathFromD(initialD).segments;
  // renderGuides: control polygon 점선
  // renderHandles: anchor/control 원
  // pointerdown → hitTestPathHandles → activeHandle
  // pointermove → updatePathHandle → pathDFromSegments

cubic control 가이드

C segment는 from–cp1, to–cp2 점선이 control polygon입니다. 008에서 본 네 점과 동일합니다.

Core API

  • updatePathHandle, updateSubpathHandle
  • pathDFromSegments, pathFromD, syncPathEndpoints
  • createPathEditor — path-editor.js

다음

  • 024 — 전체 mini editor

오늘의 핵심

편집 = segment graph mutation. d는 export/렌더용 캐시 문자열로 생각하면 아키텍처가 단순해집니다.

최근 수정: 26. 5. 17. PM 4:35
Contributors: jinho.park.s3, Cursor
Prev
handle hit testing
Next
mini path editor — SVG round-trip