class UIBezierPath : NSObject

UIBezierPath 是由直线和曲线线段组成的路径，可以在自定义视图中渲染该路径。它属于 UIKit 框架。

最初使用 UIBezierPath 这个类只是为了指定路径的几何形状，如矩形、椭圆和弧，也可以定义混合了直线和曲线线段的复杂多边形。定义形状之后，您可以使用这个类的其他方法在当前绘图上下文中呈现路径。

UIBezierPath 对象在渲染过程中将路径的几何形状与描述路径的属性组合在一起。可以分别设置几何图形和属性，并可以独立地更改它们。

当通过 UIBezierPath 绘制圆时，其其实角度和方向如下图所示：

基本API的使用

便捷初始化器绘制路径

override func draw(_ rect: CGRect) {
    // 1、绘制矩形路径
    let rectPath = UIBezierPath(rect: CGRect(x: 50, y: 50, width: 100, height: 100))
    // 设置描边颜色，和线宽
    rectPath.lineWidth = 2.0
    UIColor.red.setStroke()
    // 关闭路径，会把路径的第一个点和最后一个点相连
    rectPath.close()
    // 对路径进行描边
    rectPath.stroke()
        
    // 2、绘制矩形内切圆路径
    let ovalPath = UIBezierPath(ovalIn: CGRect(x: 50, y: 50, width: 50, height: 100))
    ovalPath.lineWidth = 1.0
    UIColor.blue.setStroke()
    ovalPath.close()
    ovalPath.stroke()
        
    // 3、根据 圆角半角(cornerRadius) 绘制带圆角的矩形
    let roundPath = UIBezierPath(roundedRect: CGRect(x: 100, y: 70, width: 80, height: 100), cornerRadius: 20)
    roundPath.lineWidth = 3.0
    UIColor.green.setStroke()
    roundPath.close()
    roundPath.stroke()
        
    // 4、根据 指定需要圆角处 和 圆角半径 绘制矩形
    let byRoundPath = UIBezierPath(roundedRect: CGRect(x: 25, y: 25, width: 100, height: 50), byRoundingCorners: [.topLeft, .bottomLeft], cornerRadii: CGSize(width: 20, height: 50))
    byRoundPath.lineWidth = 1.0
    UIColor.yellow.setStroke()
    byRoundPath.close()
    byRoundPath.stroke()
        
    // 5、绘制圆弧路径
    let arcPath = UIBezierPath(arcCenter: CGPoint(x: 25, y: 150), radius: 50, startAngle: 0, endAngle: CGFloat.pi / 3, clockwise: true)
    arcPath.lineWidth = 5.0
    UIColor.purple.setStroke()
    //arcPath.close() 未进行闭合路径，所以绘制的是弧，而不是扇形
    arcPath.stroke()
}
``` 

### 影响绘制的基本属性

1、绘制一条线，设置线条的起始端点样式，连接处的形状，曲线的平坦度

```swift
override func draw(_ rect: CGRect) {
    let path = UIBezierPath()
    // 移动到指定点
    path.move(to: CGPoint(x: 50, y: 50))
    // 向当前路径添加一条直线
    path.addLine(to: CGPoint(x: 50, y: 150))
    path.addLine(to: CGPoint(x: 150, y: 150))
        
    path.addArc(withCenter: CGPoint(x: 100, y: 100), radius: 50, startAngle: 0, endAngle: -CGFloat.pi / 2, clockwise: false)
        
    path.lineWidth = 10
    UIColor.red.setStroke()
        
    // 路径起始点和结束点的形状
    //.butt(默认值，始末端为方形)；.round(始末端为半圆圆弧结束)；.square(始末端为方形，会往外延伸一半的宽度)
    path.lineCapStyle = .round
        
    // 连接段之间的接头的形状
    // .bevel(方形的连接，默认值)；.miter(尖角的接头，)；.round(圆形接头)
    path.lineJoinStyle = .round
        
    // 避免连接线段之间的连接点尖峰的极限值。默认的斜接限制为10
    // 当 path.lineJoinStyle = .miter 时，可以设置此值调整斜接
    //        path.miterLimit = 10
        
    // 弯曲路径的渲染精度。平坦度默认值为0.6。
    // 它表示真实曲线上的点和渲染曲线上的点之间的最大允许距离(以像素为单位)。数值越小，曲线越平滑，但需要更多的计算时间。
    // 较大的值会导致更多的锯齿曲线，但是渲染速度会快得多。
    // 通常情况下不更改此值，只是在一些临时操作时，通过增大此值，以减少绘制形状所需的时间。
    //path.flatness = 0.6
    path.stroke()
}

2、填充路径使用的规则
当使用如下两种规则来判断当前区域是否填充时，需要在该路径区域内给定的一点向路径边界外的一点绘制一条射线，然后按照如下规则判断是否填充：

• even-odd rule(奇偶规则填充)，如果射线与路径交叉总数为奇数则填充该点所在的区域，为偶数则不填充。
• non-zero rule(非零环绕数原则)，从左到右的路径相交计数为+1，从右到左的路径相交计数为-1。如果交叉点的和非零，则该点所在区域被填充；如果和为0，则不填充该区域。

下面例子我们外圆使用顺时针方向绘制，内圆使用逆时针方向绘制：

override func draw(_ rect: CGRect) {
    // 1、绘制外圆，顺时针方向绘制圆
    let outerPath = UIBezierPath()
    outerPath.addArc(withCenter: CGPoint(x: 100, y: 100), radius: 80, startAngle: 0, endAngle: CGFloat.pi * 2, clockwise: true)
    outerPath.close()
        
    // 2、绘制内圆，逆时针方向绘制圆
    let innerPath = UIBezierPath()
    innerPath.addArc(withCenter: CGPoint(x: 100, y: 100), radius: 50, startAngle: 0, endAngle: CGFloat.pi * 2, clockwise: false)
    innerPath.close()
        
    // 3、添加路径，并设置填充规则
    let path = UIBezierPath()
    path.append(outerPath)
    path.append(innerPath)
        
    // 是否在绘制路径时使用奇偶缠绕规则，默认值为false
    // 为true，则使用奇偶规则填充路径；为false，则使用非零环绕数原则填充。
    path.usesEvenOddFillRule = true
        
    UIColor.blue.setStroke()
    path.lineWidth = 3.0
    path.stroke()
        
    UIColor.yellow.setFill()
    path.fill()
}

3、带有混合模式的描边和填充
blendMode: 混合模式决定了如何和已经存在的被渲染过的内容进行合成。具体可以参看：Core Graphics 混合模式的各种表现

override func draw(_ rect: CGRect) {
    let outerPath = UIBezierPath(rect: CGRect(x: 50, y: 50, width: 100, height: 100))
    UIColor.red.setFill()
    outerPath.close()
    outerPath.fill()
        
    let innerPath = UIBezierPath(rect: CGRect(x: 75, y: 75, width: 50, height: 50))
    UIColor.blue.setFill()
    innerPath.close()
    // 使用指定的 混合模式 和 透明度 绘制接收器路径所包围的区域
    // blendMode：混合模式决定了如何和已经存在的被渲染过的内容进行合成
    innerPath.fill(with: .difference, alpha: 1.0)
    //innerPath.fill() 
}

4、以虚线的形式描边路径

override func draw(_ rect: CGRect) {
    let path = UIBezierPath()
    path.move(to: CGPoint(x: 20, y: 100))
    path.addLine(to: CGPoint(x: 200, y: 100))
        
    let dotLine: [CGFloat] = [2, 5, 5, 10]
    /* 设置路径描边样式
     * -pattern 一个[CGFloat]，其中包含线段的长度 和 间隔 交替出现，即第一个表示长度，第二个表示间隔，第三个长度，间隔...
     * -count 表示pattern的个数
     * -phase 开始绘制 pattern 的偏移量。如，模式5-2-3-2的相位值为6将导致绘图从第一个间隙的中间开始。
     */
    path.setLineDash(dotLine, count: dotLine.count, phase: 0)
        
    path.lineWidth = 3.0
    UIColor.red.setStroke()
    path.stroke()
}

学习博客

iOS开发 UIBezierPath学习

iOS UIBezierPath(贝塞尔曲线)