Path bending
Use arcBendTransform or pathBendTransform with transformPath. See the
composable transforms reference for signatures and examples.
baseline is top, center (default), bottom, or an absolute source Y value.
align is start (default), center, or end. fit is none (default) or
stretch. offset moves along the guide; normalOffset moves along its normal.
Both default to zero. Positive normal displacement is to the right of traversal.
overflow is error (default), extend (continue the endpoint tangent), or
wrap (closed guides only). Circular arc angles use radians and a nonzero signed
sweep of at most one revolution. Path guides must be one smooth directed contour;
corners and cusps are rejected. Unlike envelope guides, closed bend guides support
wrapping. Source-frame height may be zero for a baseline-only bend.
API details from source
Section titled “API details from source”
PathBendArc
Section titled “PathBendArc”Circular guide geometry used when bending a path along an arc.
interface PathBendArcRelated API: PathBendArc.
See also
Section titled “See also”View source — packages/core/src/lib/geometry/path-bending.ts:15
Properties and methods
Section titled “Properties and methods”
cx
readonly cx: numberHorizontal coordinate of the center. See PathBendArc.
View source — packages/core/src/lib/geometry/path-bending.ts:17
cy
readonly cy: numberVertical coordinate of the center. See PathBendArc.
View source — packages/core/src/lib/geometry/path-bending.ts:19
radius
readonly radius: numberRadius in the coordinate system of this geometry or effect. See PathBendArc.
View source — packages/core/src/lib/geometry/path-bending.ts:21
startAngle
readonly startAngle: numberAngle at which the arc or slice begins. See PathBendArc.
View source — packages/core/src/lib/geometry/path-bending.ts:23
sweep
readonly sweep: numberAngular extent of the arc. See PathBendArc.
View source — packages/core/src/lib/geometry/path-bending.ts:25
PathBendAlign
Section titled “PathBendAlign”Placement of the source along the beginning, center, or end of a bending guide.
type PathBendAlign = 'start' | 'center' | 'end'Related API: PathBendAlign.
See also
Section titled “See also”View source — packages/core/src/lib/geometry/path-bending.ts:32
PathBendBaseline
Section titled “PathBendBaseline”The source baseline used for bending: an edge, center, or explicit coordinate.
type PathBendBaseline = 'center' | 'top' | 'bottom' | numberRelated API: PathBendBaseline.
See also
Section titled “See also”View source — packages/core/src/lib/geometry/path-bending.ts:38
PathBendFit
Section titled “PathBendFit”Whether bending preserves source length or stretches it to the guide.
type PathBendFit = 'none' | 'stretch'Related API: PathBendFit.
See also
Section titled “See also”View source — packages/core/src/lib/geometry/path-bending.ts:44
PathBendOverflow
Section titled “PathBendOverflow”Policy for source geometry extending beyond a bending guide.
type PathBendOverflow = 'error' | 'extend' | 'wrap'Related API: PathBendOverflow.
See also
Section titled “See also”View source — packages/core/src/lib/geometry/path-bending.ts:50
Implementation guidance for agents
Section titled “Implementation guidance for agents”Read the Drawing, layout, and effects companion for ownership, adaptation, failure modes, and verification. Agent start provides the version-selection workflow.
Complete minimal examples
Section titled “Complete minimal examples”- Arc and path bending: Bend geometry around an arc and along a guide with explicit placement options. Plain source
Documentation version
Section titled “Documentation version”Documentation built with @pibbl/core 0.0.2, revision 2dccb19. ALPHA — NOT FOR PRODUCTION USE.