PathBuilder（路径构建器）

Path builder 是一个完整的 result builder，用于将 Path 提升到声明式的 SwiftUI 世界。这个 @resultBuilder 可以用于优雅且简洁地定义路径。SwiftUI 中缺失的文档空白通过使用古老但优秀的 CGMutablePath 知识来填补。

我只是想学习如何实现 result builders。在 SwiftUI 中玩动画路径时，我找到了一个完美的实验场所。

使用 PathBuilder，你可以这样写来绘制一个三角形

Path {
    Move(to: CGPoint(x: 50, y: 50))
    Line(to: CGPoint(x: 100, y: 100))
    Line(to: CGPoint(x: 0, y: 100))
    Close()
}

而不是更长的版本

Path { p in
    p.move(to: CGPoint(x: 50, y: 50))
    p.addLine(to: CGPoint(x: 100, y: 100))
    p.addLine(to: CGPoint(x: 0, y: 100))
    p.closeSubpath()
}

绘制 Swift Logo 可以像 这样 实现。

这里有很多基本的路径组件。你可以通过遵循 PathComponent 协议来创建一个新的组件。

• Arc – 向路径添加一段圆弧，通过半径和角度指定。
• Close – 关闭并完成路径中的一个子路径。
• Curve – 向路径添加一条三次贝塞尔曲线，通过指定的终点和控制点。
• Oval – 向路径添加一个椭圆，该椭圆适合在指定的矩形内。
• EmptySubpath – 添加空子路径，主要用作临时占位符。
• Line – 从当前点向指定点添加一条直线段。
• Lines – 向路径添加一系列连接的直线段。
• Move – 在指定点开始一个新的子路径。
• QuadCurve – 向路径添加一条二次贝塞尔曲线，通过指定的终点和控制点。
• Rect – 向路径添加一组矩形子路径。
• RelativeArc – 向路径添加一段圆弧，通过半径和角度差指定。
• RoundedRect – 向路径添加一个子路径，形状为具有圆角的矩形。
• TangentArc – 向路径添加一段圆弧，通过半径和两条切线指定。

• Loop – 循环遍历提供的序列，并为每个元素构建路径，将组件添加到路径。
• Subpath – 将另一个子路径对象分组并附加到路径，并可选择对其进行变换。

对于 Swift 5.1 到 5.3，请使用包版本 1.1.1。

否则，对于 2.0+ 版本，请使用最新的工具

• Xcode 12.5 或更高版本
• Swift 5.4 或更高版本
• iOS 13、macOS 10.15、watchOS 6.0、tvOS 13.0 或更高版本

在 Xcode 中使用 Swift Package Manager 或添加到你的 Package manifest 文件中。

欢迎所有贡献。

项目由 Matěj Kašpar Jirásek 创建。

项目根据 MIT 许可证 授权。