UIBezierPath对象是CGPathRef数据类型的封装。path如果是基于矢量形状的，都用直线和曲线段去创建。我们使用直线段去创建矩形和多边形，使用曲线段去创建弧（arc），圆或者其他复杂的曲线形状。每一段都包括一个或者多个点，绘图命令定义如何去诠释这些点。每一个直线段或者曲线段的结束的地方是下一个的开始的地方。每一个连接的直线或者曲线段的集合成为subpath。一个UIBezierPath对象定义一个完整的路径包括一个或者多个subpaths。

使用UIBezierPath类可以创建基于矢量的路径，这个类在UIKit中。它是基于Core Graphics对CGPathRef数据类型和path绘图属性的一个封装，所以是需要图形上下文的CGContextRef，所以一般UIBezierPath在drawRect中使用。使用此类可以定义简单的形状，如椭圆或者矩形，或者有多个直线和曲线段组成的形状。

• UIBezierPath的使用方法：
  （1）创建一个Bezier path对象。
  （2）使用方法moveToPoint:去设置初始线段的起点。
  （3）添加line或者curve去定义一个或者多个subpaths。
  （4）改变UIBezierPath对象跟绘图相关的属性。

我们可以设置stroked path的属性lineWidth和lineJoinStyle。也可以设置filled path的属性usesEvenOddFillRule

本文分为三大模块：属性、类方法、实例方法。

属性

• 1. CGPath :
     将UIBezierPath类转换成CGPath，和UIColor的CGColor类似
• 2. empty：
     只读类型，路径上是否有有效的元素
• 3. bounds：
     和view的bounds是不一样的，它获取path的X坐标、Y坐标、宽度，但是高度为0
• 4. currentPoint：
     当前path的位置，可以理解为path的终点
• 5. lineWidth：
     可以理解为路径的宽度
• 6. lineCapStyle：
     path端点样式，有3种样式

typedef CF_ENUM(int32_t, CGLineCap) {
    kCGLineCapButt,  默认的
    kCGLineCapRound, 轻微圆角
    kCGLineCapSquare 正方形
};

• 7. lineJoinStyle：
     path拐角样式，也有3种样式

typedef CF_ENUM(int32_t, CGLineJoin) {
    kCGLineJoinMiter, 默认的表示斜接
    kCGLineJoinRound, 圆滑衔接
    kCGLineJoinBevel  斜角连接
};

• 8. miterLimit：
     最大斜接长度，怎么理解呢？就是上图中拐角处外面尖角和内部尖角的距离。但是这个只有在kCGLineJoinMiter情况下使用才有效果，如果这个miterLimit小于斜接长度，就成为了kCGLineJoinBevel类型

     
     image.png

/* 
 最大斜接长度   斜接长度指的是在两条线交汇处内角和外角之间的距离
 只有lineJoin属性为kCALineJoinMiter时miterLimit才有效
 边角的角度越小，斜接长度就会越大。
 为了避免斜接长度过长，我们可以使用 miterLimit属性。
 如果斜接长度超过 miterLimit的值，边角会以 lineJoin的 "bevel"即kCALineJoinBevel类型来显示
*/

• 9. UIRectCorner
     圆角 分为四种情况

typedef NS_OPTIONS(NSUInteger, UIRectCorner) {
    UIRectCornerTopLeft     = 1 << 0,
    UIRectCornerTopRight    = 1 << 1,
    UIRectCornerBottomLeft  = 1 << 2,
    UIRectCornerBottomRight = 1 << 3,
    UIRectCornerAllCorners  = ~0UL
};

类方法

• 创建并且返回一个新的 UIBezierPath 对象

// 根据一个Rect画一个矩形曲线
+ (instancetype)bezierPath;

• 通过一个矩形, 创建并且返回一个新的 UIBezierPath 对象

/**
 *  根据一个Rect画一个椭圆曲线  Rect为正方形时画的是一个圆
 *  @param rect CGRect一个矩形
 */
+ (instancetype)bezierPathWithRect:(CGRect)rect;

• 通过一个指定的矩形中的椭圆形, 创建并且返回一个新的 UIBezierPath 对象

/**
 *  根据一个Rect画一个圆角矩形曲线 (Radius:圆角半径)   当Rect为正方形时且Radius等于边长一半时画的是一个圆
 *  @param rect CGRect一个矩形
 */
+ (instancetype)bezierPathWithOvalInRect:(CGRect)rect;

• 根据一个圆角矩形, 创建并且返回一个新的 UIBezierPath 对象

/**
 *  根据一个Rect画一个圆角矩形曲线   当Rect为正方形时且Radius等于边长一半时画的是一个圆
 *  @param rect         CGRect一个矩形
 *  @param cornerRadius 圆角半径
 */
+ (instancetype)bezierPathWithRoundedRect:(CGRect)rect 
                             cornerRadius:(CGFloat)cornerRadius; 
// rounds all corners with the same horizontal and vertical radius

• 根据一个圆角矩形, 创建并且返回一个新的 UIBezierPath 对象

/**
 *  根据一个Rect针对四角中的某个或多个角设置圆角
 *
 *  @param rect        CGRect一个矩形
 *  @param corners     允许指定矩形的部分角为圆角，而其余的角为直角，取值来自枚举 
 *  @param cornerRadii  指定了圆角的半径，这个参数的取值是 CGSize 类型，也就意味着这里需要给出的是椭圆的半径。
 */
+ (instancetype)bezierPathWithRoundedRect:(CGRect)rect 
                        byRoundingCorners:(UIRectCorner)corners 
                              cornerRadii:(CGSize)cornerRadii;

• 通过一个圆弧, 创建并且返回一个新的 UIBezierPath 对象

/**
 *  以某个中心点画弧线
 *  @param center     指定了圆弧所在正圆的圆心点坐标
 *  @param radius     指定了圆弧所在正圆的半径
 *  @param startAngle 指定了起始弧度位置  注意: 起始与结束这里是弧度 
 *  @param endAngle   指定了结束弧度位置  
 *  @param clockwise  指定了绘制方向，以时钟方向为判断基准   看下图
 */
+ (instancetype)bezierPathWithArcCenter:(CGPoint)center 
                                 radius:(CGFloat)radius 
                             startAngle:(CGFloat)startAngle 
                               endAngle:(CGFloat)endAngle 
                              clockwise:(BOOL)clockwise;

2452150-5bf0e532c2a0f6d9.jpg

• 通过一个 CGPath, 创建并且返回一个新的 UIBezierPath 对象

/**
 *  根据CGPath创建并返回一个新的UIBezierPath对象
 *  @param CGPath CGPathRef
 */
+ (instancetype)bezierPathWithCGPath:(CGPathRef)CGPath;

实例方法

• 将 UIBezierPath 对象的 currentPoint 移动到指定的点

/**
 *  设置第一个起始点到接收器
 *  @param point 起点坐标
 */
- (void)moveToPoint:(CGPoint)point;

• 在当前子路径中追加一条直线

/**
 *  附加一条直线到接收器的路径
 *  @param point 要到达的坐标
 */
- (void)addLineToPoint:(CGPoint)point;

• 在当前 子路经中追加一条 三次贝塞尔曲线

/**
 *  该方法就是画三次贝塞尔曲线的关键方法，以三个点画一段曲线，一般和moveToPoint:配合使用。其实端点为moveToPoint:设置，终止端点位为endPoint；。控制点1的坐标controlPoint1，这个参数可以调整。控制点2的坐标是controlPoint2。
 *
 *  @param endPoint      终点坐标
 *  @param controlPoint1 控制点1
 *  @param controlPoint2 控制点2  看下图
 */
- (void)addCurveToPoint:(CGPoint)endPoint 
          controlPoint1:(CGPoint)controlPoint1 
          controlPoint2:(CGPoint)controlPoint2;

2452150-fabfa795e061d718.jpg

• 在当前 子路经中追加一条 二次贝塞尔曲线

/**
 *  画二次贝塞尔曲线，是通过调用此方法来实现的。一般和moveToPoint:配合使用。endPoint终端点，controlPoint控制点，对于二次贝塞尔曲线，只有一个控制点
 *  @param endPoint     终点坐标
 *  @param controlPoint 控制点  看下图
 */
- (void)addQuadCurveToPoint:(CGPoint)endPoint 
               controlPoint:(CGPoint)controlPoint;

2452150-3d4952efead3a84c.jpg

• 在当前子路径中追加一条圆弧

/**
 *  添加一个弧线 与bezierPathWithArcCenter:radius:startAngle:endAngle:clockwise:区别是bezierPathWithArcCenter它是初始化一个弧线,addArcWithCenter是添加一个弧线,共同点就是参数都一样
 *  @param center     指定了圆弧所在正圆的圆心点坐标
 *  @param radius     指定了圆弧所在正圆的半径
 *  @param startAngle 指定了起始弧度位置
 *  @param endAngle   指定了结束弧度位置
 *  @param clockwise  指定了绘制方向，以时钟方向为判断基准
 */
- (void)addArcWithCenter:(CGPoint)center 
                  radius:(CGFloat)radius 
              startAngle:(CGFloat)startAngle 
                endAngle:(CGFloat)endAngle 
               clockwise:(BOOL)clockwise NS_AVAILABLE_IOS(4_0);

• 关闭当前子路经

/**
 *  闭合线使用这个方法起始点与终点将相连
 */
- (void)closePath;

• 删除 UIBezierPath 对象中的所有点, 效果也就等同于删除了所有子路经

/**
 *  移除所有坐标点
 */
- (void)removeAllPoints;

• 将指定 UIBezierPath 中的内容添加到当前 UIBezierPath 对象中

// Appending paths
// 添加一个paths UIBezierPath
- (void)appendPath:(UIBezierPath *)bezierPath;

• 创建并返回一个新的BezierPath, 这个 BezierPath 的方向是原 BezierPath 的反方向

// Modified paths
// 创建并返回一个与当前路径相反的新的贝塞尔路径对象
- (UIBezierPath *)bezierPathByReversingPath NS_AVAILABLE_IOS(6_0);

• 用指定的仿射变换矩阵变换路径的所有点

// Transforming paths
// 用指定的仿射变换矩阵变换路径的所有点
- (void)applyTransform:(CGAffineTransform)transform;