SwiftUI中如何按中轴轨迹顺序为UIBezierPath实现填充动画
SwiftUI 沿自定义中轴轨迹分步填充轮廓的实现方案
核心实现逻辑
- 不直接对轮廓做形变或整体裁切,绑定统一的0~1范围动画进度值,把进度映射为中轴轨迹上的动态跟随坐标
- 以动态跟随点为中心生成圆形遮罩,覆盖在主轮廓上层,遮罩随动画进度沿中轴移动时,视觉上呈现轮廓顺着中轴方向逐步显现的效果,完全匹配预先定义的轨迹箭头方向
- 全部使用SwiftUI原生能力实现,兼容现有代码结构,无第三方依赖
代码实现
首先引入系统框架,补充路径计算的基础扩展(用于计算轨迹长度、获取对应进度的路径点):
import SwiftUI import UIKit extension Path { /// 计算路径总长度,采用分段近似法保证计算精度 var totalLength: CGFloat { var total: CGFloat = 0 var prevPoint: CGPoint? for element in self.cgPath.makeIterator() { switch element { case .moveToPoint(let start): prevPoint = start case .addLine(let end): guard let prev = prevPoint else { break } total += prev.distance(to: end) prevPoint = end case .addQuadCurve(let end, let control): guard let prev = prevPoint else { break } let steps = 20 var stepPrev = prev for i in 1...steps { let t = CGFloat(i)/CGFloat(steps) let point = quadPoint(at: t, start: prev, end: end, control: control) total += stepPrev.distance(to: point) stepPrev = point } prevPoint = end case .addCurve(let end, let c1, let c2): guard let prev = prevPoint else { break } let steps = 30 var stepPrev = prev for i in 1...steps { let t = CGFloat(i)/CGFloat(steps) let point = cubicPoint(at: t, start: prev, end: end, control1: c1, control2: c2) total += stepPrev.distance(to: point) stepPrev = point } prevPoint = end default: break } } return total } /// 获取路径上指定长度位置的坐标点 func point(atLength length: CGFloat) -> CGPoint { var accumulated: CGFloat = 0 var prevPoint: CGPoint? for element in self.cgPath.makeIterator() { switch element { case .moveToPoint(let start): prevPoint = start case .addLine(let end): guard let prev = prevPoint else { break } let segLength = prev.distance(to: end) if accumulated + segLength >= length { let t = (length - accumulated)/segLength return CGPoint(x: prev.x + (end.x - prev.x)*t, y: prev.y + (end.y - prev.y)*t) } accumulated += segLength prevPoint = end case .addQuadCurve(let end, let control): guard let prev = prevPoint else { break } let steps = 20 let stepLength = totalLength / CGFloat(steps) var stepPrev = prev for i in 1...steps { let t = CGFloat(i)/CGFloat(steps) let point = quadPoint(at: t, start: prev, end: end, control: control) if accumulated + stepLength >= length { return point } accumulated += stepLength stepPrev = point } prevPoint = end case .addCurve(let end, let c1, let c2): guard let prev = prevPoint else { break } let steps = 30 let stepLength = totalLength / CGFloat(steps) var stepPrev = prev for i in 1...steps { let t = CGFloat(i)/CGFloat(steps) let point = cubicPoint(at: t, start: prev, end: end, control1: c1, control2: c2) if accumulated + stepLength >= length { return point } accumulated += stepLength stepPrev = point } prevPoint = end default: break } } return cgPath.currentPoint } private func quadPoint(at t: CGFloat, start: CGPoint, end: CGPoint, control: CGPoint) -> CGPoint { let mt = 1 - t let x = mt*mt*start.x + 2*mt*t*control.x + t*t*end.x let y = mt*mt*start.y + 2*mt*t*control.y + t*t*end.y return CGPoint(x: x, y: y) } private func cubicPoint(at t: CGFloat, start: CGPoint, end: CGPoint, control1: CGPoint, control2: CGPoint) -> CGPoint { let mt = 1 - t let x = mt*mt*mt*start.x + 3*mt*mt*t*control1.x + 3*mt*t*t*control2.x + t*t*t*end.x let y = mt*mt*mt*start.y + 3*mt*mt*t*control1.y + 3*mt*t*t*control2.y + t*t*t*end.y return CGPoint(x: x, y: y) } } extension CGPoint { func distance(to point: CGPoint) -> CGFloat { sqrt(pow(point.x - x, 2) + pow(point.y - y, 2)) } }
保留原有自定义的轮廓和中轴路径,不需要做修改:
struct myShape: Shape { func path(in rect: CGRect) -> Path { let p = UIBezierPath() p.move(to: CGPoint(x: 147, y: 32)) p.addQuadCurve(to: CGPoint(x: 203, y: 102), controlPoint: CGPoint(x: 181, y: 74)) p.addQuadCurve(to: CGPoint(x: 271, y: 189), controlPoint: CGPoint(x: 242, y: 166)) p.addQuadCurve(to: CGPoint(x: 274, y: 217), controlPoint: CGPoint(x: 287, y: 204)) p.addQuadCurve(to: CGPoint(x: 229, y: 235), controlPoint: CGPoint(x: 258, y: 229)) p.addQuadCurve(to: CGPoint(x: 193, y: 235), controlPoint: CGPoint(x: 204, y: 241)) p.addQuadCurve(to: CGPoint(x: 190, y: 219), controlPoint: CGPoint(x: 183, y: 231)) p.addQuadCurve(to: CGPoint(x: 143, y: 71), controlPoint: CGPoint(x: 199, y: 195)) p.addQuadCurve(to: CGPoint(x: 125, y: 33), controlPoint: CGPoint(x: 134, y: 55)) p.addCurve(to: CGPoint(x: 147, y: 32), controlPoint1: CGPoint(x: 113, y: 5), controlPoint2: CGPoint(x: 128, y: 9)) p.close() return Path(p.cgPath) } } struct myMedian: Shape { func path(in rect: CGRect) -> Path { let p = UIBezierPath() p.move(to: CGPoint(x: 196, y: 226)) p.addLine(to: CGPoint(x: 209, y: 220)) p.addLine(to: CGPoint(x: 226, y: 195)) p.addLine(to: CGPoint(x: 170, y: 86)) p.addLine(to: CGPoint(x: 142, y: 43)) p.addLine(to: CGPoint(x: 131, y: 39)) return Path(p.cgPath) } }
重构主视图逻辑,加入动态遮罩驱动分步填充:
struct DrawCharacter: View { // 动画进度 0~1 @State private var animationProgress: CGFloat = 0 // 预加载中轴路径,避免重复计算 private let medianPath = myMedian().path(in: CGRect(x: 0, y: 0, width: 300, height: 300)) var body: some View { ZStack(alignment: .topLeading){ myShape() .fill(.black) // 动态遮罩控制轮廓显示范围 .mask( Canvas { context, size in let currentPoint = medianPath.point(atLength: animationProgress * medianPath.totalLength) // 遮罩半径,可根据轮廓大小调整 let maskRadius: CGFloat = 120 context.addPath(Path(ellipseIn: CGRect( x: currentPoint.x - maskRadius, y: currentPoint.y - maskRadius, width: maskRadius*2, height: maskRadius*2 ))) context.fillPath(in: .black) } ) // 保留中轴红色箭头的可视化效果 myMedian() .stroke(.red, lineWidth: 2) } .frame(width: 300, height: 300) .onAppear { // 线性动画匹配中轴移动节奏 withAnimation(.linear(duration: 2.5)) { animationProgress = 1 } } } }
调试适配要点
- 遮罩半径可根据轮廓宽度调整:半径越大,填充边缘过渡越平缓;半径越小,填充边界越锐利
- 贝塞尔曲线的长度近似计算精度满足日常动画需求,需要更高流畅度时可适当提高分段数steps的取值
- 若出现动画移动方向和中轴箭头反向的问题,检查
myMedian中路径的创建顺序,保证轨迹起点对应动画初始位置
内容的提问来源于stack exchange,提问作者kirkyoyx
相关产品推荐
相关产品推荐

