TEAChart 绘图原理剖析:用 Core Graphics 从零实现时钟图与柱状图

原创2026-10-16 18:01:49134 阅读

TEAChart 绘图原理剖析:用 Core Graphics 从零实现时钟图与柱状图

TEAChart 是一款轻量直观的 iOS 图表库,内置时钟图、柱状图和贡献度图三种图表。这篇文章带你深入源码,剖析它是如何用 Core Graphics(CGContext)从零实现时钟图与柱状图的——读懂这两张图的绘制管线,你就掌握了 iOS 自定义图表绘制的大部分核心技巧。

一、先认识 TEAChart 的架构 🗂️

TEAChart 的设计非常简单:三种图表各是一个继承自 UIView 的视图,统一的"伞头文件" TEAChart.h 一次导入全部类型:

图表类型 实现文件 核心绘制手段
时钟图(扇形时间环) TEAClockChart.m CGContextAddArc 弧线扇形
柱状图 TEABarChart.m CGContextFillRect 矩形填充
贡献度图(GitHub 风格) TEAContributionGraph.m 网格矩形 + 按值分色

三个类共享同一个骨架:初始化时 loadDefaults 设默认值 → 系统回调 drawRect: 画图表 → 每个属性的 setter 都调用 setNeedsDisplay 触发重绘。以 TEAClockChart.m 为例:

- (void)loadDefaults {
    self.opaque = NO;
    _fillColor   = [UIColor colorWithRed:0.922 green:0.204 blue:0.239 alpha:0.25];
    _strokeColor = [UIColor colorWithWhite:0.85 alpha:1];
    _borderWidth = 2;
}

而 TEAClockChart.m 中每个 setter 都只差一行:

- (void)setData:(NSArray *)data {
    _data = data;
    [self setNeedsDisplay];   // 数据一变,就请求重绘
}

这就是最典型的"数据驱动渲染"闭环:改属性 → 标记脏区 → 系统调用 drawRect: → 重新画一遍。

二、渲染基石:drawRect 与 CGContext

所有图表的绘制都发生在 drawRect: 方法里,流程固定为三步:

  1. 拿到画布:CGContextRef context = UIGraphicsGetCurrentContext();
  2. 构建路径:用弧线、直线、矩形等命令在画布上"描线"
  3. 填充或描边:CGContextFillPath / CGContextFillRect / CGContextStrokePath

理解了这三步,下面两种图表的实现就只是一堆坐标计算而已。

三、时钟图 TEAClockChart 的实现原理 🕐

时钟图把 24 小时映射成一个圆环,每个时间段画成一块半透明的扇形。完整绘制逻辑在 TEAClockChart.m 的 drawRect: 中。

1. 时间转角度:把分钟映射到 2π

核心公式只有两行(TEAClockChart.m):

CGFloat startMinutes = startComp.hour * 60 + startComp.minute;
CGFloat startAngle   = startMinutes / (24 * 60) * (2 * M_PI) - M_PI_2;
  • 一天共 24×60 = 1440 分钟,startMinutes / 1440 就是它占整圆的比例;
  • 减去 M_PI_2(90°)是关键一笔:CG 的 0° 指向 3 点钟方向,转 90° 之后 0 点才正好落在 12 点正上方,符合时钟直觉。

2. 弧线 + 圆心连线 = 一块扇形

扇形不需要什么"扇形 API",两条命令即可拼出(TEAClockChart.m):

CGContextBeginPath(context);
CGContextAddArc(context, originX, originY, radius * 0.9, startAngle, endAngle, 0);
CGContextAddLineToPoint(context, originX, originY);  // 弧线末端拉一条线回圆心
CGContextFillPath(context);                          // 闭合区域一次填色

两个小细节很见功力:

  • 方向参数为 0 即是顺时针:UIKit 视图会把 Y 轴翻转,源码注释也特意写明 "UIView flips the Y-coordinate, so 0 is actually clockwise",这是很多初学者的踩坑点;
  • 半径用 radius * 0.9:刻意比视图半径小一圈,给外圈圆环留出空间,避免扇形和描边打架。

3. 外圈圆环与 24 个刻度

圆环就是椭圆路径描边(TEAClockChart.m):

CGContextSetLineWidth(context, self.borderWidth);
[self.strokeColor setStroke];
CGContextAddEllipseInRect(context, rect);   // margin = 0.1 控制圆环粗细位置
CGContextStrokePath(context);

24 个刻度则演示了 CTM 变换的经典套路(TEAClockChart.m):

for (NSInteger i = 0; i < 24; i += 1) {
    CGContextSaveGState(context);
    CGContextTranslateCTM(context, originX, originY);   // 原点到圆心
    CGContextRotateCTM(context, i * M_PI / 12);         // 每小时旋转 15°
    CGContextMoveToPoint(context, 0, radius);
    CGContextAddLineToPoint(context, 0, radius - radius * lengthFactor);
    CGContextStrokePath(context);
    CGContextRestoreGState(context);
}

每画一笔刻度前 SaveGState、画完 RestoreGState,保证变换不会污染下一个刻度;lengthFactor 取 0.08 还是 0.04,则自动区分出整 6 小时的长刻度和小时短刻度。

四、柱状图 TEABarChart 的实现原理 📊

柱状图看似更简单,但藏着几个让图表"看起来专业"的关键技巧,全部在 TEABarChart.m 的 drawRect: 里。

1. 柱宽与柱高的换算

CGFloat barWidth  = (width - spacing * (numberOfBars - 1)) / numberOfBars;
CGFloat barHeight = barMaxHeight * [self.data[i] floatValue] / max;
  • 柱宽 = 可用宽度扣除所有间隙后平均分,间隙数永远是 n - 1 而不是 n;
  • 最大值 max 支持两种模式:autoMax = YES 时用 Key-Value Coding 的 @max.self 自动从数据里取最大值,否则用手动设置的 max 属性(见 TEABarChart.m)。

2. 像素对齐:柱子边缘为什么更锐利

这是新手最容易忽略、效果却最明显的一步(TEABarChart.m):

CGFloat barWidthRounded = ceil(barWidth);
CGFloat x = floor(i * (barWidth + self.barSpacing));
if (self.roundToPixel) {
    barHeight = (int)barHeight;
}

当矩形边缘落在像素中间时,系统会做抗锯齿,边缘发灰发虚。用 floor / ceil / 取整把坐标吸附到整数像素后,边缘就干脆利落。roundToPixel 被声明为 IBInspectable,还能在界面里直接开关。

3. 背景轨道、多色轮换与单字标签

绘制每一根柱子时,其实画了两个矩形:先铺一条贯穿全高的浅灰"轨道"背景,再叠加真正的数据柱(TEABarChart.m),这就是"柱子高度一目了然"的视觉来源。多色模式则用取模实现无限轮换:

UIColor *barColor = self.barColors ? self.barColors[i % self.barColors.count] : self.barColor;

x 轴标签直接复用文字绘制 API drawInRect:withAttributes:,字体大小跟随柱宽自适应(TEABarChart.m),源码注释也提醒:柱子很窄,标签最好只用一个字符。

五、彩蛋:贡献度图的网格与点击技巧 🔍

贡献度图(TEAContributionGraph.m)用 NSCalendar 算出每天的 weekday 和 weekOfMonth,把日期排进 7 列网格,再按"阈值分档"(minimumValueForGrade:)给每个格子选颜色——逻辑与 GitHub 头像旁的贡献热力图完全一致,是学习"数据分级映射到颜色"的好样本。

更有趣的是点击处理(TEAContributionGraph.m):在绘制每个格子的同时,往视图上动态添加一个同位置的透明 UIButton,并用关联对象把该日的日期和数值"藏"在按钮上。用真实控件换命中检测,简单粗暴却非常可靠。

六、值得借鉴的工程细节 💡

  • Interface Builder 可视化配置:三个图表类都标注了 IB_DESIGNABLE,常用属性标注 IBInspectable(如 TEAClockChart.h),于是颜色、间距、最大值等参数可以直接在 Xcode 的属性检查器里拖改,所见即所得,Demo 的 prepareForInterfaceBuilder 还会自动塞入示例数据。
  • VoiceOver 无障碍:每个图表都在绘制时同步生成 UIAccessibilityElement(TEAClockChart.m),每个扇形会朗读"xx 到 xx",每根柱子会朗读"标签 + 百分比",让视障用户也能"看懂"图表。
  • Demo 上手:示例工程 TEAViewController.m 展示了最简用法——给 data 赋一个数组(柱状图是 NSArray of NSNumber,时钟图是 TEATimeRange 时间区间数组),图表立刻出现,无需任何额外配置。

TEAChart 柱状图在 Interface Builder 属性检查器中的可视化配置面板

七、小结:iOS 从零画图表的三步清单 ✅

步骤 做什么 TEAChart 中的对应
1️⃣ 拿画布 重写 drawRect:,取 UIGraphicsGetCurrentContext() 三个图表的统一入口
2️⃣ 建路径 数据 → 坐标换算,用 AddArc / AddLineToPoint / FillRect 铺形状 时钟图角度公式、柱状图宽高换算
3️⃣ 填与描 FillPath / FillRect / StrokePath 落色 扇形填充、轨道背景、圆环描边

再叠加两个加分项:setter 中 setNeedsDisplay 实现数据驱动重绘、坐标取整实现像素对齐,你就有了从零实现任何 iOS 自定义图表的完整方法论。建议从 TEABarChart.m(约 130 行)读起,再到 TEAClockChart.m,最后挑战带委托数据源的 TEAContributionGraph.m,三步走完,Core Graphics 绘图就再没有秘密了。

登录后查看全文
TEAChart