爱心曲线跳动动画与无缝循环 GIF 实现:p5.js 与 Processing 双版本解析(Coding Challenge 134.2)

原创2026-10-12 12:09:541,915 阅读
文章标签:教程文档示例工程

爱心曲线跳动动画与无缝循环 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?从代码结构可以提炼出三个关键设计:

  1. 相位归一化:percent = (counter % totalFrames) / totalFrames 保证无论运行多久,动画状态只取决于 percent 这一个变量,percent 从 0 逼近 1 后必然回到 0,不存在「越跑越偏」的累积漂移。
  2. 增删对称:前半周期 push 顶点数恰好等于后半周期 splice 移除的顶点数(各 120 个),周期边界处 heart 数组近乎为空,首帧与末帧状态高度一致。
  3. 缩放同周期: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 的具体贡献在于给出了「正弦缩放(呼吸)+ 顶点队列增删(描画与擦除)」这一对组合拳:前者制造大小脉动,后者制造轮廓伸缩,二者叠加便产生了心跳的观感。

参考资料与仓库内延伸阅读

上述挑战与教程代码均位于本仓库的 CodingChallenges 目录下,可直接阅读源码对照学习。

登录后查看全文
website-archive