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

circle as cubic — κ constant

원을 polynomial cubic만으로는 정확히 표현할 수 없습니다. 대신 4개의 quarter cubic으로 매우 가깝게 근사하고, 제어점 오프셋은 상수 κ (kappa) 하나로 고정됩니다.

데모에서 볼 것

  • 파란 cubic — 1/4 원 (단위 원의 한 사분면)
  • 회색 점선 <circle r="100"> — 참조 원
  • readout: CIRCLE_CUBIC_KAPPA = 4(√2−1)/3 ≈ 0.5522847498

데모 path (반지름 100, 중심 (100,100)):

M 100 0
C 100 55.23  44.77 100  0 100
     ↑ cp1.y = 100·κ    ↑ cp2.x = 100·κ

κ 정의

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

// κ = 4(√2 − 1) / 3 ≈ 0.5522847498
// 제어점이 축 방향으로 κ·radius 만큼 떨어짐
위치제어점 (단위 원, 1사분면)
P0(1, 0)
P1(1, κ)
P2(κ, 1)
P3(0, 1)
import { unitCircleQuarterCubics } from "svg-matrix-core";

const [quarter] = unitCircleQuarterCubics();
// { p0, p1, p2, p3 } — 반지름 1, 원점 중심의 한 사분면
// 실제 UI: translate·scale·rotate 후 4번 반복

전체 원 = 같은 패턴을 90°씩 회전한 4× C 또는 <circle> / A.

오차

κ는 최대 radial error를 최소화하는 고전 상수입니다. 아이콘·UI loader에서는 눈에 안 띕니다. 공학 도면·궤도 시뮬레이션은 <circle> / A / NURBS(082).

vs arc A

정확도path d엔진
<circle>정확요소 별도DOM
A elliptical arc정확 호native 011arcSegmentToCubics → C (053)
4× κ cubic~0.03% r (typ.)cubic-onlyCIRCLE_CUBIC_KAPPA
import { convertArcsInPathD } from "svg-matrix-core";

convertArcsInPathD("M 0 50 A 50 50 0 0 1 100 50");
// A 제거, κ 근사 cubic 연속

cubic-only 편집기·boolean·052 adaptive는 import 시 A→cubic 변환이 일반적.

생성 패턴 (앱 코드)

function circleAsPathD(cx, cy, r) {
  const k = CIRCLE_CUBIC_KAPPA * r;
  return [
    `M ${cx + r} ${cy}`,
    `C ${cx + r} ${cy - k} ${cx + k} ${cy - r} ${cx} ${cy - r}`,
    `C ${cx - k} ${cy - r} ${cx - r} ${cy - k} ${cx - r} ${cy}`,
    `C ${cx - r} ${cy + k} ${cx - k} ${cy + r} ${cx} ${cy + r}`,
    `C ${cx + k} ${cy + r} ${cx + r} ${cy + k} ${cx + r} ${cy}`,
    "Z"
  ].join(" ");
}

부호·시계 방향은 좌표계에 맞게 조정.

Core API

  • CIRCLE_CUBIC_KAPPA, unitCircleQuarterCubics — geometry.js
  • arcSegmentToCubics, convertArcsInPathD — arc.js / engine.js

관련

  • 011 A · 053 arc→cubic · 082 rational 정확 원

오늘의 핵심

UI 원 = κ·radius로 control 생성. 정확 원이 필요하면 circle/A를 유지하고, cubic-only 파이프라인에 넣을 때만 κ 또는 convertArcsInPathD를 쓰세요.

최근 수정: 26. 5. 17. PM 4:35
Contributors: jinho.park.s3, Cursor
Next
rational curves & exact arcs