爱心曲线跳动动画与无缝循环 GIF 实现:p5.js 与 Processing 双版本解析(Coding Challenge 134.2)
爱心曲线跳动动画与无缝循环 GIF 实现:p5.js 与 Processing 双版本解析(Coding Challenge 134.2)
本文围绕 Coding Challenge 134.2「Heart Curve GIF Loop」展开:在 134.1 用 Wolfram MathWorld 心形参数方程绘制静态爱心曲线的基础上,134.2 通过「模运算驱动的帧循环 + 顶点对称增删 + 正弦呼吸缩放」让爱心产生心跳般的搏动,并借助 Processing 的序列帧录制与 EZGIF 等合成工具导出可无缝循环的 GIF。读完本文,你将掌握完整的爱心曲线数学表达、p5.js 与 Processing 两套可运行代码的逐行原理,以及一套可复用到任意创意编程动画的「百分位驱动无缝循环」通用范式。
挑战背景:从静态心形到跳动循环
本挑战对应的文档为 _CodingChallenges/134.2-heart-curve-gif-loop.md,其核心目标一句话即可概括:将爱心曲线做成一颗持续跳动、可无缝循环的 GIF。文档元数据提供了关键信息:
- 视频编号:134.2,发布日期 2019-02-19;
- 关联仓库目录:CodingChallenges/CC_134_Heart_Curve_2,其中包含 P5 版 与 Processing 版 两套完整实现;
- 在线 p5.js Web Editor 草图 ID 为
C0kJ-BjYW; - 该视频是 134.1「Heart Curve」的续篇(见 134.1 挑战文档),前一篇负责把心形参数方程画出来,这一篇则让它动起来并循环。
文档还列出了本系列的创作灵感与工具来源:Saskia Freeke 的 Daily Art 每日艺术创作、Bees & Bombs 的动态循环美学、Golan Levin 的「Interactivity & Computation」课程,以及用于将序列帧合成为 GIF 的在线工具 EZGIF。这些线索共同指向一个技术主题:用代码生成循环往复的生成艺术(generative art loop)。
心形曲线的参数方程:一切跳动的基础
134.2 的动画本质上是把 134.1 已经实现的爱心曲线搬进一个循环时间轴里,因此先要理解这条曲线的数学来源。根据 134.1 文档,其引用的是 Wolfram MathWorld 上经典的心形参数方程(parametric heart curve):
x = 16 · sin³(a)
y = -(13 · cos(a) − 5 · cos(2a) − 2 · cos(3a) − cos(4a))
在 134.1 的 p5 源码 中,参数 a 从 0 递增到 TWO_PI(a += 0.1),每步计算一个顶点并推入 heart 数组,noLoop() 在描完一整圈后停止;Processing 版 的实现完全一致。两个版本都额外乘了一个缩放系数 r = height / 40,让曲线铺满画面。
关于该方程的值域(用于后续理解缩放逻辑):x = 16·sin³(a) 的取值在 [-16, 16];y 在 a = 0 时约为 -5(心形顶部),在 a = π 时约为 +15(心形底部尖端)。心形整体上下不对称,这是后续缩放与平移时要考虑的因素。这里的 - 号是 p5/Processing 坐标系中 y 轴向下生长所需的翻转,数学上等价于标准笛卡尔坐标中的正号表达。
p5.js 实现:240 帧驱动的跳动循环
P5 版 sketch.js 是理解整个挑战的核心,完整源码如下:
// Heart Curve
// Daniel Shiffman
// https://thecodingtrain.com/CodingChallenges/134.2-heart-curve-gif-loop.html
// https://youtu.be/l5I3Q1JFISE
// https://editor.p5js.org/codingtrain/sketches/C0kJ-BjYW
// I <3 you
const heart = [];
const totalFrames = 240;
let counter = 0;
function setup() {
createCanvas(windowWidth, windowHeight);
}
function draw() {
const percent = float(counter % totalFrames) / totalFrames;
render(percent);
counter++;
}
function render(percent) {
background(0);
translate(width / 2, height / 2);
stroke(255, 0, 200);
strokeWeight(4);
fill(150, 0, 100);
beginShape();
for (let v of heart) {
const a = map(percent, 0, 1, 0, TWO_PI * 2);
const r = map(sin(a), -1, 1, height / 80, height / 40);
vertex(r * v.x, r * v.y);
}
endShape();
if (percent < 0.5) {
const a = map(percent, 0, 0.5, 0, TWO_PI);
const x = 16 * pow(sin(a), 3);
const y = -(13 * cos(a) - 5 * cos(2 * a) - 2 * cos(3 * a) - cos(4 * a));
heart.push(createVector(x, y));
} else {
heart.splice(0, 1);
}
}
逐段拆解其设计:
1. 全局状态(第 8–10 行):heart 数组保存爱心轮廓的顶点(单位尺度,未缩放);totalFrames = 240 定义循环总帧数;counter 是逐帧递增的计数器。p5.js 默认 draw() 每秒执行约 60 次,240 帧意味着一个完整搏动周期约 4 秒。
2. 循环驱动(第 16–20 行):percent = float(counter % totalFrames) / totalFrames 是本挑战的灵魂。% totalFrames 把计数器永远限制在 [0, 240) 区间内,除以 totalFrames 后得到一个 [0, 1) 的归一化相位值 percent。同一段渲染函数在不同时间用不同的 percent 驱动,就构成了循环动画——这是贯穿 134.2 与后续 135 挑战的核心思想。
3. 呼吸缩放(第 30–31 行):绘制每个顶点前,先用 a = map(percent, 0, 1, 0, TWO_PI * 2) 把相位映射到 [0, 4π)(整整两周),再 r = map(sin(a), -1, 1, height / 80, height / 40) 让缩放系数 r 在 height/80(约为画面高度的 1/80)到 height/40(约 1/40)之间随正弦波动。由于 sin 在 4π 内完成两次完整振荡,爱心在一个循环周期内会缩放搏动两次,配合顶点轮廓的变化,视觉上就像「扑通、扑通」的心跳。最终顶点坐标为 r * v.x、r * v.y,即以画布中心为原点的均匀缩放。
4. 生长与擦除(第 36–43 行):这是让爱心「画出来又收回去」的机制。当 percent < 0.5(循环的前半段),用 a = map(percent, 0, 0.5, 0, TWO_PI) 将相位映射到 [0, 2π),逐帧把心形参数方程算出的新顶点 push 进数组——爱心轮廓被一笔一笔画出;当 percent >= 0.5(后半段),每帧 heart.splice(0, 1) 移除数组头部的顶点——轮廓再一笔一笔擦回。前半段新增、后半段删除,数量严格对称,保证一个周期结束时数组回到(近似)空状态,从而与下一周期无缝衔接。
5. 绘制本身(第 28–34 行):beginShape() / vertex() / endShape() 把所有顶点连成闭合填充形状;stroke(255, 0, 200) 是粉色描边、fill(150, 0, 100) 是紫红色填充、strokeWeight(4) 加粗描边,形成鲜明的视觉风格。
无缝循环的秘密:模运算与对称增删
为什么这段动画可以被导出成「无缝」循环 GIF?从代码结构可以提炼出三个关键设计:
- 相位归一化:
percent = (counter % totalFrames) / totalFrames保证无论运行多久,动画状态只取决于percent这一个变量,percent从 0 逼近 1 后必然回到 0,不存在「越跑越偏」的累积漂移。 - 增删对称:前半周期
push顶点数恰好等于后半周期splice移除的顶点数(各 120 个),周期边界处heart数组近乎为空,首帧与末帧状态高度一致。 - 缩放同周期:
r由sin(a)(周期2π,映射区间4π)驱动,在percent = 0与percent = 1时sin值相同,缩放状态同步复位。
从源码分析可以看到一个值得注意的细节:最后一帧(percent 接近 1)时 heart 中仍残留约 1 个顶点,而新周期的第一帧会先渲染再追加顶点,因此严格意义上首尾两帧并非逐像素相同;但在 240 帧、每秒 60 帧的动画中,这种单顶点级别的细微差异肉眼不可见,整体视觉循环是连续的。这也是 134.2 文档中「beating, looping GIF」效果的实现基础。
Processing 实现:序列帧录制与 GIF 导出
Processing 版 与 p5 版逻辑同源,但增加了录制模式,这是它作为 GIF 生产工具的关键差异:
// Heart Curve
// Daniel Shiffman
// https://thecodingtrain.com/CodingChallenges/134.2-heart-curve-gif-loop.html
// https://youtu.be/l5I3Q1JFISE
// https://editor.p5js.org/codingtrain/sketches/C0kJ-BjYW
// I <3 you
int totalFrames = 120;
int counter = 0;
boolean record = false;
ArrayList<PVector> heart = new ArrayList<PVector>();
float a = 0;
void setup() {
size(400, 400);
}
void draw() {
float percent = 0;
if (record) {
percent = float(counter) / totalFrames;
} else {
percent = float(counter % totalFrames) / totalFrames;
}
render(percent);
if (record) {
saveFrame("output/gif-"+nf(counter, 3)+".png");
if (counter == totalFrames-1) {
exit();
}
}
counter++;
}
void render(float percent) {
background(0);
translate(width/2, height/2);
stroke(255);
strokeWeight(4);
fill(150, 0, 100);
beginShape();
for (PVector v : heart) {
float a = map(percent, 0, 1, 0, TWO_PI*2);
float r = map(sin(a), -1, 1, height/80, height/40);
vertex(r * v.x, r * v.y);
}
endShape();
if (percent < 0.5) {
a = map(percent, 0, 0.5, 0, TWO_PI);
float x = 16 * pow(sin(a), 3);
float y = -(13 * cos(a) - 5*cos(2*a) - 2*cos(3*a)- cos(4*a));
heart.add(new PVector(x, y));
} else {
heart.remove(0);
}
}
录制流程的核心是 record 布尔标志(第 10 行):
- 预览模式(
record = false,默认):percent = float(counter % totalFrames) / totalFrames,与 p5 版一致,画布上无限循环播放跳动效果,供实时调试; - 录制模式(
record = true):percent = float(counter) / totalFrames,从 0 单调递增到接近 1,确保恰好录满一个完整周期、不多一帧不少一帧;每帧调用saveFrame("output/gif-" + nf(counter, 3) + ".png")把画面写成gif-000.png、gif-001.png…… 这样的序列帧(nf(counter, 3)是三位数补零格式化);当counter == totalFrames - 1时调用exit()自动结束程序。
录制完成后,把 output/ 目录下的 120 张 PNG 序列帧导入 EZGIF 等合成工具(134.2 文档 links 中列出的工具),设置合适的帧率(若源码帧率为 60fps,可用约 20fps 或按需调整),即可导出循环播放的 GIF。「先用归一化相位驱动渲染,再用录制模式逐帧输出序列帧」正是 135 号挑战「Making a GIF Loop in Processing」的通用方法论。
两个版本的差异也值得对照:
| 维度 | p5.js 版 | Processing 版 |
|---|---|---|
| 循环总帧数 | totalFrames = 240 |
totalFrames = 120 |
| 画布 | createCanvas(windowWidth, windowHeight) 跟随窗口 |
固定 size(400, 400) |
| 顶点容器 | 原生数组 heart |
ArrayList<PVector> |
| 移除顶点 | heart.splice(0, 1) |
heart.remove(0) |
| 描边颜色 | stroke(255, 0, 200)(粉色) |
stroke(255)(白色) |
| 录制能力 | 无内置录制,适合浏览器预览 | saveFrame + record 标志,可直接产序列帧 |
| 相位来源 | 恒为模运算循环 | 录制时切换为单调递增,保证单周期输出 |
运行与导出操作指南
p5.js 版:index.html 通过 CDN 引入 p5@1.4.1(<script src="https://cdn.jsdelivr.net/npm/p5@1.4.1/lib/p5.min.js"></script>)并加载 sketch.js,页面本身只有空的 <body>,画布由 p5 自动创建。在本地运行时,直接在浏览器打开 HTML 文件通常即可(p5 无需服务器即可运行),画布尺寸会跟随窗口大小自动调整,跳动循环即刻开始。也可以把代码粘贴到 p5.js Web Editor(草图 ID C0kJ-BjYW)在线运行。
Processing 版:用 Processing IDE 打开 CC_134_Heart_Curve_2.pde 直接运行即可预览;若想导出 GIF,先把第 10 行的 boolean record = false; 改为 true,重新运行后程序会在 output/ 目录生成 gif-000.png 至 gif-119.png 共 120 张序列帧并自动退出,最后用 EZGIF 等工具合成。注意 record 模式下 percent 不会取模回绕,因此录制的恰好是单个无缝周期。
通用化:把任意动画变成无缝循环 GIF
134.2 的价值不仅在于画一颗爱心,更在于它示范了一种可复用的循环动画模板,这一点在其姊妹挑战 135-gif-loop.md 中被明确系统化。对照 CC_135_GIF_Loop 的 p5 源码,可以看到完全一致的结构:
const totalFrames = 120; // ① 固定周期长度
let counter = 0; // ② 帧计数器
percent = float(counter % totalFrames) / totalFrames; // ③ 归一化相位
render(percent); // ④ 相位驱动渲染
counter++; // ⑤ 推进计数
任何需要循环的动画,都可以套用这个五步骨架:只要渲染函数只依赖 percent 这一个相位变量,且 percent = 0 与 percent = 1 时状态一致(或通过增删对称复位),动画就天然可无缝循环。134.2 的具体贡献在于给出了「正弦缩放(呼吸)+ 顶点队列增删(描画与擦除)」这一对组合拳:前者制造大小脉动,后者制造轮廓伸缩,二者叠加便产生了心跳的观感。
参考资料与仓库内延伸阅读
- 前篇静态版:134.1 Heart Curve 挑战文档 及其 p5 源码、Processing 源码;
- 循环 GIF 方法论:135 Making a GIF Loop in Processing 挑战文档;
- 同为心形数学曲线主题的姊妹挑战:133 Times Tables Cardioid;
- 数学基础:极坐标与三角函数教程(涵盖 polar-to-cartesian 转换,正是心形参数方程绘制的原理基础)。
上述挑战与教程代码均位于本仓库的 CodingChallenges 目录下,可直接阅读源码对照学习。