You need to enable JavaScript to run this app. SwiftUI中如何按中轴轨迹顺序为UIBezierPath实现填充动画
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 10:54:07