Skip to content

UIBezierPath ​

UIBezierPath 表示一条路径:由直线段、曲线段和圆弧连成的几何形状。矩形、椭圆、圆角矩形、圆弧有现成的创建方法,其他形状用「移动到一点、连线到下一点」的方式一段一段画出来。

路径只描述形状。它没有颜色,没有线宽,创建之后屏幕上不会出现任何东西。路径有三个用处:

  • 赋给 CAShapeLayer 的 path,由形状图层把它画出来。
  • 赋给关键帧动画的 path,让图层沿着它移动,见动画。
  • 调 containsPoint(),判断一个点是否在形状内部。

继承关系:EventTarget → NSObject → UIBezierPath

UIBezierPath 不能被继承,见原生类。怎么画出常见的形状,见指南画一条路径。

构造函数 ​

UIBezierPath()

创建一条空路径,之后用画线的方法一段一段加进去。

静态方法 ​

这几个方法都返回新建的 UIBezierPath:

方法说明
UIBezierPath.bezierPathWithRect()矩形
UIBezierPath.bezierPathWithOvalInRect()矩形的内切椭圆。矩形是正方形时是圆
UIBezierPath.bezierPathWithRoundedRect()圆角矩形,可以只让某几个角是圆角
UIBezierPath.bezierPathWithArcCenter()一段圆弧

实例属性 ​

属性说明
isEmpty 只读路径里是否什么都没有
bounds 只读包住整条路径的矩形,不含线宽
currentPoint 只读当前点:下一段线从这里开始
usesEvenOddFillRulecontainsPoint() 用哪种规则判断内部

实例方法 ​

画线的方法从当前点画到新的一点:

方法说明
moveToPoint()开始一段新的子路径,不画线
addLineToPoint()画直线
addCurveToPoint()画三次贝塞尔曲线,两个控制点
addQuadCurveToPoint()画二次贝塞尔曲线,一个控制点
addArcWithCenter()加一段圆弧
closePath()画直线回到这段子路径的起点
removeAllPoints()清空路径

组合、变换和查询:

方法说明
appendPath()把另一条路径加进这一条
applyTransform()移动、缩放、旋转这条路径
bezierPathByReversingPath()形状相同、方向相反的一条新路径
containsPoint()一个点是否在形状内部

事件 ​

路径不派发事件。路径只会被代码修改,修改之后读属性就是新的值。

路径由什么组成 ​

一条路径由一段或几段子路径组成。每段子路径是一串首尾相接的线段:

再调一次 moveToPoint() 就开始第二段子路径,它和前一段不相连。一条路径里可以有多个互不相连的形状。

路径创建之后可以继续修改:追加线段、追加另一条路径、做变换、清空。

坐标和角度 ​

坐标和长度的单位是点(pt)。x 轴朝右,y 轴朝下。路径里的坐标没有固定的原点:赋给形状图层之后,按那个图层自己的坐标系解释,原点是图层的左上角。

接受 CGPoint、CGRect、CGSize 的参数,也接受字段相同的普通对象,比如 { x: 10, y: 20 },见结构体。

角度的单位是弧度,不是度。180° 是 Math.PI。0 弧度指向正右方。因为 y 轴朝下,角度增大的方向在屏幕上是顺时针:

角度方向
0正右
Math.PI / 2正下
Math.PI正左
-Math.PI / 2,或 Math.PI * 1.5正上

画圆弧时的 clockwise 决定从起始角度到结束角度走哪一边:true 沿屏幕上的顺时针方向走,false 沿逆时针方向走。同样的两个角度,两种走法得到的是一个圆上互补的两段弧。

上表的方向和 clockwise 在屏幕上的走向来自 iOS 的定义,未在模拟器验证。

线宽和颜色在图层上 ​

线有多粗、什么颜色、端点和拐角是什么形状、是不是虚线、形状内部填什么颜色,这些都是 CAShapeLayer 的属性,不在路径上。同一条路径可以赋给几个图层,各自用不同的线宽和颜色画出来。

形状图层和关键帧动画保存的是赋值那一刻的形状。之后再修改这条路径,图层和动画不会跟着变,要再赋值一次。「不重新赋值时图层不变」未在模拟器验证。

示例 ​

一条折线和一个扇形 ​

从空白 App 开始,在一块灰色的区域里画一条蓝色的折线和一个橙色的扇形。

js
application.addEventListener('sceneconnect', (e) => {
  const win = new UIWindow(e.scene);
  const page = new UIViewController();
  page.view.backgroundColor = 'systemBackground';
  win.rootViewController = page;
  win.makeKeyAndVisible();

  const card = new UIView();
  card.frame = new CGRect(20, 100, 300, 160);
  card.backgroundColor = 'secondarySystemBackground';
  page.view.addSubview(card);

  // 折线:移动到起点,再依次连到后面三个点
  const line = new UIBezierPath();
  line.moveToPoint(new CGPoint(24, 130));
  line.addLineToPoint(new CGPoint(68, 60));
  line.addLineToPoint(new CGPoint(104, 96));
  line.addLineToPoint(new CGPoint(148, 30));

  // 路径自己不显示。交给形状图层,线宽和颜色设在图层上
  const lineLayer = new CAShapeLayer();
  lineLayer.path = line;
  lineLayer.fillColor = null;
  lineLayer.strokeColor = 'systemBlue';
  lineLayer.lineWidth = 3;
  lineLayer.frame = card.bounds;
  card.layer.addSublayer(lineLayer);

  // 扇形:从圆心出发,画一段弧,再回到圆心
  const center = new CGPoint(224, 80);
  const pie = new UIBezierPath();
  pie.moveToPoint(center);
  pie.addArcWithCenter(center, {
    radius: 56, startAngle: -Math.PI / 2, endAngle: Math.PI / 3, clockwise: true,
  });
  pie.closePath();

  const pieLayer = new CAShapeLayer();
  pieLayer.path = pie;
  pieLayer.fillColor = 'systemOrange';
  pieLayer.frame = card.bounds;
  card.layer.addSublayer(pieLayer);
});

效果

  • 屏幕上方出现一块 300 × 160 pt 的浅灰色区域。
  • 区域左半边有一条 3 pt 粗的蓝色折线,共三段。
  • 区域右半边有一个橙色的扇形,半径 56 pt,从正上方开始沿顺时针方向扫过 150°。

这段代码没有作为一个整体在模拟器运行过。其中用到的每个 API 都在验收用例里运行过。

更多写法见指南画一条路径。

对应的 iOS API ​

ObjCJS
[UIBezierPath bezierPath]new UIBezierPath()
[UIBezierPath bezierPathWithRect:r]UIBezierPath.bezierPathWithRect(r)
[UIBezierPath bezierPathWithOvalInRect:r]UIBezierPath.bezierPathWithOvalInRect(r)
[UIBezierPath bezierPathWithRoundedRect:r cornerRadius:8]UIBezierPath.bezierPathWithRoundedRect(r, { cornerRadius: 8 })
[UIBezierPath bezierPathWithRoundedRect:r byRoundingCorners:UIRectCornerTopLeft cornerRadii:s]UIBezierPath.bezierPathWithRoundedRect(r, { byRoundingCorners: ['topLeft'], cornerRadii: s })
UIRectCornerAllCorners['topLeft', 'topRight', 'bottomLeft', 'bottomRight']
[UIBezierPath bezierPathWithArcCenter:c radius:50 startAngle:0 endAngle:M_PI clockwise:YES]UIBezierPath.bezierPathWithArcCenter(c, { radius: 50, startAngle: 0, endAngle: Math.PI, clockwise: true })
[path moveToPoint:p]path.moveToPoint(p)
[path addLineToPoint:p]path.addLineToPoint(p)
[path addCurveToPoint:p controlPoint1:a controlPoint2:b]path.addCurveToPoint(p, { controlPoint1: a, controlPoint2: b })
[path addQuadCurveToPoint:p controlPoint:c]path.addQuadCurveToPoint(p, { controlPoint: c })
[path addArcWithCenter:c radius:r startAngle:s endAngle:e clockwise:YES]path.addArcWithCenter(c, { radius: r, startAngle: s, endAngle: e, clockwise: true })
[path closePath]path.closePath()
[path removeAllPoints]path.removeAllPoints()
[path appendPath:other]path.appendPath(other)
[path applyTransform:t]path.applyTransform(t)
[path bezierPathByReversingPath]path.bezierPathByReversingPath()
[path containsPoint:p]path.containsPoint(p)
path.emptypath.isEmpty
path.usesEvenOddFillRulepath.usesEvenOddFillRule
shapeLayer.path = path.CGPathshapeLayer.path = path
path.lineWidth = 3,再 [path stroke]shapeLayer.lineWidth = 3,线宽在图层上

参见 ​

  • 画一条路径:矩形、圆弧、扇形、曲线、几个形状放一起、点击判断
  • CAShapeLayer:把路径画出来,线宽、颜色、虚线都在它上面
  • 动画:让图层沿路径移动,或者让形状从一条路径变成另一条
  • 结构体:CGPoint、CGRect、CGSize、CGAffineTransform
  • 单位