1. 项目概述：当数学之美遇见开源硬件

如果你对分形几何的奇妙图案着迷，同时又是一个喜欢动手折腾开源硬件的创客，那么“基于行空板K10的科赫雪花”这个项目，绝对能让你眼前一亮。它不是一个简单的图形绘制，而是一次将抽象的数学公式，通过一块小小的开源硬件，实时、动态地呈现在你面前的实践。科赫雪花，这个由瑞典数学家赫尔格·冯·科赫在1904年提出的经典分形，以其无限周长却有限面积的特性，长久以来吸引着数学爱好者和艺术家。现在，我们不再满足于在纸面或电脑屏幕上静态地欣赏它，而是要让它在行空板K10这块集成了屏幕、处理器和丰富接口的“口袋电脑”上“生长”出来。

这个项目的核心价值在于“融合”与“可视化”。它巧妙地将分形算法的计算逻辑（通常由Python等语言实现）与行空板K10的硬件能力（特别是其内置的LCD屏幕和图形库）结合起来。对于学习者而言，你能直观地理解递归算法是如何一步步构造出复杂图形的；对于创客来说，你获得了一个可交互、可扩展的数学艺术展示平台。你可以调整递归深度，观察雪花从简单三角形到极致复杂的变化过程；你也可以修改颜色、绘制速度，甚至结合板载的传感器（如陀螺仪、光线传感器），让雪花的形态或颜色随环境互动而变化。这不仅仅是一个编程练习，更是一个打通数学思维、编程逻辑和硬件交互的综合性项目，非常适合STEM教育、创客工作坊或个人兴趣探索。

2. 项目核心思路与方案选型

2.1 为什么选择行空板K10？

在众多开源硬件中，选择行空板K10作为本项目载体，是经过深思熟虑的。首先，行空板K10是一款专为Python编程教育和物联网开发设计的单板计算机，它原生支持运行完整的Python环境，这对于实现科赫雪花这类需要复杂计算的算法非常友好。我们无需像在Arduino上那样受限于C/C++和有限的内存，可以直接使用Python强大的数学库和简洁的语法。

其次，行空板K10硬件配置均衡且集成度高。它拥有一块2.8英寸的LCD电阻触摸屏，分辨率达到240*320。这意味着我们无需外接任何显示设备，就能直接进行图形输出，极大简化了项目搭建。其内置的ESP32双核处理器，提供了足够的算力来执行分形图形的递归计算和实时渲染。此外，板载的加速度计、陀螺仪、光线传感器、麦克风等丰富传感器，为项目的后期扩展（如手势控制雪花旋转、环境光改变雪花颜色）预留了无限可能。最后，行空板的Unihiker库对图形界面（GUI）开发做了大量封装，使得在屏幕上绘图变得像使用turtle库一样简单，降低了图形编程的门槛。

2.2 科赫雪花算法解析：递归的艺术

科赫雪花的生成，本质是一个递归过程。我们从一个正三角形（等边三角形）开始，这是递归的起点（0阶科赫曲线）。生成规则（科赫曲线）是：将一条线段三等分，然后以中间的一段为底边，向外（对于雪花，是向外）作一个等边三角形，最后去掉这个等边三角形的底边。将这个规则应用于初始三角形的每一条边，我们就得到了一个六角星形状，这是1阶科赫雪花。然后，对这个六角星的每一条边再次应用同样的规则，如此反复，每应用一次规则，图形的复杂度就增加一级，边缘的“锯齿”就更加精细。

用程序实现的关键在于递归函数的设计。函数需要接收四个参数：线段的两个端点坐标（(x1, y1),(x2, y2)），以及当前的递归深度depth。当depth为0时，函数直接绘制连接两端点的线段。当depth大于0时，函数需要计算出将线段三等分后的五个关键点（包括两个三等分点和新增的三角形顶点），然后对这四段新的线段（(x1,y1)->p1,p1->top,top->p2,p2->(x2,y2)）分别递归调用自身，且深度减1。通过这种方式，递归会层层展开，直到深度为0，最终绘制出无数条极短的线段，共同构成科赫雪花边缘的轮廓。

注意：递归深度是控制图形精细度和计算量的关键参数。深度每增加1，需要绘制的线段数量大约是原来的4倍。深度为3或4时，图形已经非常精美；深度超过6，计算量会急剧上升，可能导致行空板绘制缓慢甚至卡顿。需要在视觉效果和性能之间取得平衡。

2.3 技术栈与工具选型

本项目主要依赖行空板K10的官方开发环境和支持库。

1. 主控与开发平台：行空板K10，通过USB数据线连接电脑。
2. 编程语言：Python 3.x。这是行空板的主要支持语言，语法简洁，库生态丰富。
3. 核心图形库：unihiker库中的GUI类。这个库封装了底层屏幕操作，提供了高级的图形绘制接口（如画线、画圆、显示文本等），比直接操作帧缓冲区要方便得多。我们主要使用其draw_line()方法。
4. 辅助数学库：Python内置的math库，用于计算三角函数值（sin,cos），以确定等边三角形顶点的坐标。
5. 开发工具：推荐使用行空板官方推荐的MU编辑器或VSCode配合行空板插件进行代码编写和上传。它们提供了便捷的文件管理和串口终端功能。

这个技术栈组合确保了项目从算法实现到硬件交互的完整链路既高效又易于上手，特别适合有一定Python基础，希望探索硬件交互式图形编程的开发者。

3. 详细实现步骤与代码拆解

3.1 环境准备与项目初始化

首先，确保你的行空板K10已经通过USB线连接到电脑，并且电脑上已经安装了必要的驱动和开发环境（如MU编辑器）。行空板开机后，其屏幕会显示IP地址等信息，表明系统已就绪。

在MU编辑器中，新建一个Python文件，例如命名为koch_snowflake.py。我们需要先导入项目所需的库：

import time import math from unihiker import GUI # 导入unihiker的GUI模块

接下来，初始化GUI对象，它是我们与屏幕交互的入口：

# 初始化GUI gui = GUI()

为了获得更好的视觉体验，我们可以在绘制前清空屏幕，并设置一个背景色（可选）：

# 清屏（填充白色背景） gui.clear() # 或者使用 gui.fill(color="#FFFFFF")

3.2 核心递归函数实现

这是整个项目的灵魂。我们将定义一个名为draw_koch的函数，它负责根据给定的起点、终点和深度，递归地绘制科赫曲线的一段。

def draw_koch(x1, y1, x2, y2, depth): """ 递归绘制科赫曲线的一段。 参数: x1, y1: 线段起点坐标 x2, y2: 线段终点坐标 depth: 当前递归深度 """ if depth == 0: # 递归基：深度为0，直接绘制线段 gui.draw_line(x1, y1, x2, y2, width=2, color="#3498db") # 使用蓝色线条 else: # 计算线段的三等分点 dx = (x2 - x1) / 3 dy = (y2 - y1) / 3 # 点A和点B是两个三等分点 ax = x1 + dx ay = y1 + dy bx = x1 + 2 * dx by = y1 + 2 * dy # 计算向外凸起的等边三角形顶点坐标 # 首先计算线段的方向角 angle = math.atan2(dy, dx) # 线段方向的角度（弧度） # 三角形顶点位于AB线段的中垂线上，距离AB中点一定长度 # 等边三角形的高 = (边长 * sqrt(3)) / 2，这里边长是原线段的1/3 side_length = math.sqrt(dx**2 + dy**2) # 原线段1/3的长度 height = (side_length * math.sqrt(3)) / 2 # 计算中垂线的方向（原线段方向逆时针旋转90度） perp_angle = angle + math.pi / 2 # 计算AB线段的中点 mid_x = (ax + bx) / 2 mid_y = (ay + by) / 2 # 计算三角形顶点坐标 tx = mid_x + height * math.cos(perp_angle) ty = mid_y + height * math.sin(perp_angle) # 递归绘制四段新的线段 draw_koch(x1, y1, ax, ay, depth-1) # 第一段 draw_koch(ax, ay, tx, ty, depth-1) # 第二段，指向三角形顶点 draw_koch(tx, ty, bx, by, depth-1) # 第三段，从顶点回来 draw_koch(bx, by, x2, y2, depth-1) # 第四段

实操心得：在计算三角形顶点坐标时，使用向量和三角函数的方法比纯几何坐标计算更清晰、不易出错。关键是要理解，我们是在原线段1/3处（A点）和2/3处（B点）之间，构建一个向外的等边三角形。math.atan2(dy, dx)函数能正确处理所有象限的角度，比math.atan(dy/dx)更安全。

3.3 雪花绘制主逻辑与坐标计算

有了绘制一段曲线的函数，我们需要确定初始正三角形的三个顶点，并分别对三条边调用draw_koch函数。

def draw_snowflake(center_x, center_y, size, depth): """ 绘制一个完整的科赫雪花。 参数: center_x, center_y: 雪花中心坐标 size: 雪花的大小（可以理解为初始三角形外接圆的半径） depth: 递归深度 """ # 计算初始正三角形的三个顶点（顶点朝上） # 顶点1：正上方 x1 = center_x y1 = center_y - size # 顶点2：右下方 x2 = center_x + size * math.cos(math.radians(30)) y2 = center_y + size * math.sin(math.radians(30)) # 顶点3：左下方 x3 = center_x - size * math.cos(math.radians(30)) y3 = center_y + size * math.sin(math.radians(30)) # 分别绘制三条边 draw_koch(x1, y1, x2, y2, depth) # 边1-2 draw_koch(x2, y2, x3, y3, depth) # 边2-3 draw_koch(x3, y3, x1, y1, depth) # 边3-1

这里，我们假设雪花中心在屏幕坐标(center_x, center_y)，size决定了雪花的大小。通过三角函数计算出初始等边三角形的三个顶点坐标。注意，行空板屏幕的坐标系原点(0,0)在左上角，Y轴向下为正。我们的计算基于数学坐标系（Y轴向上为正），所以在实际绘制时，Y坐标可能需要根据屏幕尺寸做调整，或者我们直接接受这个坐标系，将雪花绘制在屏幕中央即可。

3.4 整合与交互：让雪花动起来

将以上部分整合，并添加一些交互元素，让项目更有趣。例如，我们可以让雪花从简单到复杂逐级绘制，形成一个动画过程。

def main(): # 获取屏幕尺寸（行空板K10为240*320） screen_width = 240 screen_height = 320 # 设置雪花中心位置和大小 center_x = screen_width // 2 center_y = screen_height // 2 snowflake_size = 80 # 根据屏幕调整，不要超出边界 # 清屏 gui.clear() # 逐级绘制雪花，形成生长动画 max_depth = 4 for depth in range(max_depth + 1): gui.clear() # 每次绘制前清屏，观察每一阶的变化 # 可以在屏幕上显示当前阶数 gui.draw_text(10, 10, f"深度: {depth}", font_size=12, color="#000000") draw_snowflake(center_x, center_y, snowflake_size, depth) time.sleep(1.5) # 每阶停留1.5秒 # 绘制完成后，显示最终信息 gui.draw_text(center_x - 40, screen_height - 30, "科赫雪花绘制完成！", font_size=12, color="#e74c3c") # 运行主程序 if __name__ == "__main__": main()

这段主程序实现了雪花从0阶（一个三角形）到4阶的逐级生长动画。每次绘制前清屏，并显示当前递归深度，让你能清晰看到分形结构是如何一步步变得复杂的。time.sleep(1.5)控制了每一帧的显示时间。

3.5 性能优化与绘制技巧

在行空板这样的嵌入式设备上绘制复杂图形，性能是需要考虑的因素。递归深度较大时，绘制操作会非常密集。这里有几个优化和增强体验的技巧：

1. 双缓冲绘制：unihiker的GUI库本身可能已经做了优化。但如果你发现绘制闪烁严重，可以考虑先在一个离屏的图像对象上绘制完成，再一次性更新到屏幕。不过，对于科赫雪花这种顺序生成的图形，逐线绘制也能看到生长过程，别有风味。
2. 动态颜色：可以让线条颜色随递归深度或线段顺序变化，增加视觉吸引力。例如，修改draw_koch函数中的color参数，使用一个根据深度计算的色值。

   # 示例：颜色随深度渐变 blue_intensity = int(50 + (depth / max_depth) * 200) # 假设max_depth已知 color_hex = f"#00{blue_intensity:02x}ff" gui.draw_line(x1, y1, x2, y2, width=2, color=color_hex)

3. 触摸交互：利用行空板的触摸屏，可以增加交互。例如，点击屏幕增加或减少递归深度，重新绘制。

   from unihiker import GUI, Audio gui = GUI() audio = Audio() def on_touch(x, y): global current_depth if y < 50: # 点击屏幕上部分 current_depth = min(current_depth + 1, 6) else: # 点击屏幕下部分 current_depth = max(current_depth - 1, 0) gui.clear() draw_snowflake(center_x, center_y, size, current_depth) audio.play('beep.wav') # 播放一个提示音 gui.on_touch(on_touch) # 绑定触摸事件

4. 绘制速度控制：如果希望看到每条线绘制的轨迹，可以在draw_koch函数的递归基（depth==0）里，绘制每条线段后加入一个极短的延时time.sleep(0.001)，但这会显著增加总绘制时间。

4. 常见问题与深度调试指南

在实际操作中，你可能会遇到一些问题。下面是一些常见情况的排查思路和解决方案。

4.1 图形绘制不出来或位置不对

这是最常见的问题，通常与坐标计算有关。

• 症状：屏幕一片空白，或者雪花只有一部分在屏幕内，甚至图形很奇怪。
• 排查步骤：
  1. 检查屏幕坐标：确认你使用的center_x,center_y和size值是否在屏幕范围内。行空板K10屏幕分辨率是240x320，原点(0,0)在左上角。可以先用gui.draw_line(0,0,239,319)画一条对角线，测试屏幕绘制是否正常。
  2. 验证顶点计算：在draw_snowflake函数中，打印出计算出的三个初始顶点坐标(x1,y1),(x2,y2),(x3,y3)，看看是否合理。例如，中心在(120,160)，size=80时，y1应该是80（160-80），这个点应该在屏幕上半部分。
  3. 简化测试：将递归深度设为0（draw_snowflake(..., depth=0)），理论上应该画出一个实心三角形。如果三角形都画不对，问题肯定出在初始顶点计算上。检查三角函数math.cos和math.sin的参数是否使用了弧度制。math.radians(30)将30度转换为弧度是正确的做法。
  4. 检查递归函数：将draw_koch函数暂时修改为在depth>0时也直接画线（不递归），看看是否能画出初始三角形的轮廓。

4.2 程序运行缓慢或卡死

递归深度太大是主因。

• 症状：绘制深度4或5时速度尚可，但深度到6或7时，程序响应极慢，甚至像卡死了一样。
• 原因分析：科赫曲线的递归调用次数呈指数增长。深度为n时，最终绘制的线段数量是3 * 4^n条。深度6时，线段数超过12万条，对行空板的CPU和图形绘制都是巨大压力。
• 解决方案：
  • 限制深度：在交互设置中，将最大深度限制在5或6以内。对于艺术展示，深度4或5的细节已经足够丰富。
  • 优化绘制：gui.draw_line每次调用都有开销。可以考虑将计算出的所有线段端点坐标先存储到列表中，最后用一次批量绘制命令（如果库支持）。但unihiker的GUI库目前可能没有这样的批量接口，逐线绘制是主要方式。
  • 关闭实时动画：如果使用了逐线绘制的动画效果（time.sleep），在绘制高深度雪花时务必去掉，先计算完再一次性快速绘制。

4.3 触摸交互无响应

如果添加了触摸交互代码但没有反应。

• 排查步骤：
  1. 检查事件绑定：确认gui.on_touch(callback_function)这行代码确实被执行了，并且callback_function函数名正确。
  2. 检查回调函数参数：触摸回调函数必须接受两个参数(x, y)。
  3. 打印触摸点：在回调函数开头添加print(f“Touched at ({x}, {y})”)，通过串口终端查看是否有输出，以确定触摸事件是否被触发。
  4. 主循环阻塞：如果你的main()函数结束后程序就退出了，那么事件监听器可能也随之结束。需要在主程序末尾添加一个无限循环来保持程序运行，等待触摸事件。例如：

     if __name__ == "__main__": main() # 初始化绘制 while True: # 保持程序运行，监听事件 time.sleep(0.1)

4.4 内存错误或递归深度限制

Python默认有递归深度限制（通常约1000层），但对于科赫雪花，我们远达不到这个深度就会因为计算量而变慢。不过，如果代码有误导致无限递归，则会很快达到递归深度限制并抛出RecursionError。

• 症状：程序很快崩溃，并报错RecursionError: maximum recursion depth exceeded。
• 检查：务必确保递归函数中，每次递归调用时，深度参数depth是在递减的（depth-1），并且一定有终止条件（if depth == 0）。

5. 项目扩展与创意玩法

基础功能实现后，这个项目还有巨大的扩展空间，可以充分挖掘行空板K10的硬件潜力。

5.1 结合传感器动态变化

让雪花与你互动：

• 光线传感器：根据环境光强度调整雪花的颜色或亮度。光线强时用冷色调（蓝色、青色），光线暗时用暖色调（橙色、红色）。

  from unihiker import GUI, Light light = Light() light_value = light.read() # 将光强映射到一个颜色值上

• 加速度计/陀螺仪：倾斜板子，让雪花沿着倾斜方向“飘落”或旋转。通过读取加速度计数据，计算板子的倾斜角度，动态调整雪花绘制的旋转角度。
• 麦克风：根据环境声音的大小，改变雪花的递归深度或“抖动”程度。声音越大，雪花分支的“抖动”随机偏移量越大，形成一种声控艺术效果。

5.2 生成艺术与参数随机化

引入随机性，创造独一无二的雪花：

• 随机分支角度：不严格遵循60度，让每次向外凸起的角度有一个小的随机偏移（例如55-65度），这样生成的每一片雪花都不同。
• 随机颜色：每条线段使用随机生成的颜色，形成五彩斑斓的雪花。
• 随机递归深度：对不同边甚至同一边的不同分段，采用略有差异的递归深度，生成不对称、更自然形态的分形图案。

5.3 多雪花与动画场景

创建一个动态的雪花场景：

• 生成多个雪花：在屏幕不同位置，用不同大小、颜色和深度绘制多个雪花。
• 飘落动画：让雪花从屏幕上方缓缓飘落，同时自身缓慢旋转。这需要用到简单的物理模拟（匀速或匀加速下落）和图形旋转知识（可以通过重新计算顶点坐标实现旋转）。
• 分形树与森林：将算法稍作修改，把“向外凸起”改为一定角度的“分叉”，就能绘制出著名的分形树。在屏幕上绘制一片分形树森林，结合日夜光感变化，会是一个极具观赏性的项目。

5.4 性能进阶：从递归到迭代

对于学有余力、想深入探究算法优化的朋友，可以尝试用迭代（循环+栈）的方式替代递归来实现科赫曲线。递归虽然代码简洁，但函数调用开销大。迭代算法需要自己维护一个栈来保存需要处理的线段状态（起点、终点、深度）。这种实现方式性能更高，也更适合理解递归的本质是“栈操作”。这可以作为你对算法和数据结构理解的一次很好实践。

从一片简单的三角形雪花开始，通过代码和行空板K10，我们不仅看到了数学的精确之美，也体验了软硬件结合创造的无限可能。这个项目的魅力在于，它像一颗种子，基础代码只是树干，而那些传感器交互、随机艺术、动态场景的扩展想法，则是可以自由生长的枝叶。我个人的体会是，最有趣的时刻往往发生在项目基本功能跑通之后，当你开始问“如果……会怎样？”并动手尝试时，真正的创造和学习才刚刚开始。不妨就从修改一个颜色参数，或者尝试连接光线传感器开始，看看这片代码的雪花，能绽放出怎样意想不到的光彩。