TEAChart 绘图原理剖析:用 Core Graphics 从零实现时钟图与柱状图
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: 方法里,流程固定为三步:
- 拿到画布:
CGContextRef context = UIGraphicsGetCurrentContext(); - 构建路径:用弧线、直线、矩形等命令在画布上"描线"
- 填充或描边:
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赋一个数组(柱状图是NSArrayofNSNumber,时钟图是 TEATimeRange 时间区间数组),图表立刻出现,无需任何额外配置。
七、小结: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 绘图就再没有秘密了。
