尧图网页设计 
嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载追逐Chase与扫描Scanner效果在 LED 灯带动画中极为经典一个亮点沿着灯带移动身后拖着一道逐渐变暗的残影最典型的代表就是《霹雳游侠》Knight Rider中的 Cylon 扫描灯。本文基于 FastLED 仓库的 chases.md 教程从位置追踪、拖尾实现、边界反弹讲起逐步深入到多扫描点、变色扫描、宽光斑与变速扫描等变体并给出官方 Cylon 示例 与源码级实现剖析。读完本文你将掌握用 FastLED 写出可复用的追逐/扫描动画函数并理解fadeToBlackBy()与blur1d()等底层 API 的工作原理。1. 效果概览追逐与扫描的本质区别动画的“移动感”来自两点位置随时间变化以及旧位置的亮度逐渐衰减。FastLED 教程将这类效果划分为两种基本形态扫描Scanner / Bouncing亮点在灯带两端之间来回反弹到达端点时方向取反如 Cylon 扫描灯。追逐Chase / Unidirectional亮点或一串亮点沿单一方向循环前进到达末端后回到起点重新开始。两种形态共用同一套核心技巧用static变量追踪当前位置、每帧移动位置、用衰减函数制造拖尾。官方示例 Cylon.ino 使用的正是“来回扫描 残影”的 Larson Scanner 效果官方注释将其描述为An animation that moves a single LED back and forth as the entire strip changes单个 LED 来回移动、整条灯带随之变化。2. 基础篇Cylon 扫描效果先实现最经典的版本——一个亮点来回反弹并留下渐变拖尾void cylon() { static uint8_t pos 0; // 当前位置static 保证跨调用保留 static int8_t direction 1; // 方向1 前进 / -1 后退 // 1. 先让整条灯带整体衰减形成拖尾 fadeToBlackBy(leds, NUM_LEDS, 20); // 2. 点亮当前位置 leds[pos] CRGB::Red; // 3. 移动位置并做边界检测 pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; // 触碰到端点就反向 } }2.1 五个关键机制位置追踪Position Trackingpos用static uint8_t声明只在首次调用时初始化为 0此后每次调用都保留上一次的值这是所有动画状态管理的基础与 animations.md 中static uint8_t brightness的用法一致。方向控制Direction Controldirection取int8_t有符号值为 1 表示向灯带末端移动-1 表示向起点移动。拖尾效果Trail Effect每帧先调用fadeToBlackBy()让所有 LED 朝黑色衰减再点亮新位置视觉上就形成“身后渐暗的残影”。边界检测Boundary Detection当pos到达 0 或NUM_LEDS - 1时翻转方向实现反弹。LED 点亮LED Illumination将当前坐标的颜色写入leds[pos]配合FastLED.show()输出到物理灯带。2.2 位置管理与边界检测位置更新与边界检测是扫描类效果的核心模式pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; }这里有两个易踩的坑值得注意pos使用uint8_t无符号因此不要把pos减到负数——边界判断必须在pos变为 0 时就及时反转方向否则无符号回绕会导致亮点跳到 255 的位置。灯带索引是 0 起始的最后一个有效索引是NUM_LEDS - 1。若用pos NUM_LEDS这类判断务必在边界处constrain()钳制防止越界写数组。在后面的“变速扫描”变体中源码使用了constrain(pos, 0, NUM_LEDS - 1)来保证索引不越界这正是对无符号变量越界的防御性处理。3. 关键概念fadeToBlackBy 拖尾衰减fadeToBlackBy()是整篇教程的核心 API。它对整条灯带批量执行“朝黑色按比例衰减”fadeToBlackBy(leds, NUM_LEDS, 20);第三个参数是衰减量0–255控制拖尾的长短衰减值效果拖尾长度20每帧只衰减约 8%残影消退慢长拖尾柔和100每帧衰减约 39%残影快速消失短拖尾255每帧衰减 100%直接熄灭无拖尾瞬时开关源码实现在 src/fl/gfx/colorutils.cpp.hpp 中fadeToBlackBy本质上是nscale8的封装void fadeToBlackBy(CRGB *leds, fl::u16 num_leds, fl::u8 fadeBy) { nscale8(leds, num_leds, 255 - fadeBy); }它把“衰减量 fadeBy”换算成“保留比例 255 - fadeBy”再对每个 LED 的 RGB 三通道执行 8 位定点缩放逐 LED 调用CRGB::nscale8()见 src/fl/gfx/crgb.h。也就是说fadeBy 20 时每帧每个通道都保留约 235/255 ≈ 92% 的亮度剩余 8% 被抹去残影因此以指数方式快速消失。与fadeLightBy()的区别同文件中fadeLightBy走的是nscale8_video()视频缩放路径对低亮度像素的衰减行为略有不同视频缩放能更好地保留暗部细节。日常做拖尾残影时fadeToBlackBy()是更常用的选择两者的批量版本在colorutils.h中都有对应的using声明见 src/colorutils.h。源码中的实际使用FastLED 官方 DemoReel100 效果集在 src/fl/fx/1d/demoreel100.h 中大量使用该 API例如confetti()L94-L99fadeToBlackBy(leds, 10) 随机位置撒点形成彩色纸屑效果sinelon()L101-L106fadeToBlackBy(leds, 20)beatsin16()驱动的来回亮点juggle()L119-L127fadeToBlackBy(leds, 20) 8 个亮点交错织行。这些例子证明“衰减 单点亮”就是 FastLED 生态里最通用的动画骨架。4. 完整可运行示例将上述函数放入标准 FastLED 工程即可直接运行灯带为 60 颗 WS2812B接 D5GRB 颜色顺序#include FastLED.h #define LED_PIN 5 #define NUM_LEDS 60 #define LED_TYPE WS2812B #define COLOR_ORDER GRB CRGB leds[NUM_LEDS]; void setup() { FastLED.addLedsLED_TYPE, LED_PIN, COLOR_ORDER(leds, NUM_LEDS); FastLED.setBrightness(50); // 全局亮度避免满功率刺眼 } void cylon() { static uint8_t pos 0; static int8_t direction 1; // Fade all LEDs fadeToBlackBy(leds, NUM_LEDS, 20); // Set current position leds[pos] CRGB::Red; // Move position pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; } } void loop() { cylon(); FastLED.show(); delay(30); // Control speed }其中delay(30)控制扫描速度每帧 30ms约合 33 FPS帧率换算公式FPS 1000 / delay_ms详见 timing.md。实际使用中若想让代码不被delay()阻塞可换成非阻塞的EVERY_N_MILLISECONDS(30) { cylon(); FastLED.show(); }结构宏定义在 src/lib8tion.h它允许loop()中继续执行按键、传感器读取等其他任务。5. 变体扩展教程提供了四种由浅入深的变体覆盖“多对象、变色、单向、宽光斑”四个方向。5.1 多扫描点Multiple Dots两枚亮点同屏对向扫描各自独立追踪位置与方向可产生交错碰撞的视觉效果void multiCylon() { static uint8_t pos1 0; static uint8_t pos2 NUM_LEDS / 2; // 第二枚从中间出发 static int8_t direction1 1; static int8_t direction2 -1; // 反向出发 fadeToBlackBy(leds, NUM_LEDS, 20); // First scanner leds[pos1] CRGB::Red; pos1 direction1; if (pos1 0 || pos1 NUM_LEDS - 1) { direction1 -direction1; } // Second scanner leds[pos2] CRGB::Blue; pos2 direction2; if (pos2 0 || pos2 NUM_LEDS - 1) { direction2 -direction2; } }要点每个扫描点都拥有独立的pos与direction状态且都声明为static。若把两枚扫描点的状态混用动画就会错乱。扩展到 N 枚扫描点时可将这些状态放入数组或结构体如struct Scanner { uint8_t pos; int8_t dir; }循环更新。5.2 变色扫描Color Changing Scanner扫描的同时按 HSV 色相循环换色在每次反弹时递增色相值void colorCylon() { static uint8_t pos 0; static int8_t direction 1; static uint8_t hue 0; // HSV 色相0-255 覆盖完整色环 fadeToBlackBy(leds, NUM_LEDS, 20); leds[pos] CHSV(hue, 255, 255); // CHSV 会自动转换为 CRGB pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; hue 32; // 每次反弹换一个色相32 ≈ 45° } }HSV 的优势在这里体现得淋漓尽致只需递增hue一个变量就能平滑遍历整个色环无需分别调整 R/G/B 三个通道HSV 色彩空间的使用细节可参考 solid-colors.md。hue 32意味着一次完整往返变换 8 种颜色数值越大换色越频繁。官方 Cylon.ino 也采用了同样的思路——它在每个循环帧里执行CHSV(hue, 255, 255)让亮点颜色随移动连续变化残影则由leds[i].nscale8(250)每帧保留 250/255 ≈ 98% 亮度逐点生成。5.3 单向追逐Simple Chase去掉方向反转亮点到达末端后回绕到起点形成单向循环追逐void chase() { static uint8_t pos 0; fadeToBlackBy(leds, NUM_LEDS, 30); // 衰减略快拖尾更短 leds[pos] CRGB::Green; pos; if (pos NUM_LEDS) { pos 0; // 回绕到起点 } }回绕也可以用取模写成pos (pos 1) % NUM_LEDS;二者等价。时序教程中给出的 Speed-Controlled Chase 正是这种回绕模式的非阻塞版——用millis()判断步进间隔用FastLED.clear()替代衰减。追逐效果可以再叠加“一串亮点”把leds[pos]和leds[(pos 1) % NUM_LEDS]、leds[(pos 2) % NUM_LEDS]同时点亮就得到经典的“彗星尾巴”追逐。5.4 宽光斑扫描Wider Scanner单个亮点升级为一小段光斑宽度 5通过循环点亮中心附近的多颗 LED 实现void wideCylon() { static uint8_t pos 0; static int8_t direction 1; fadeToBlackBy(leds, NUM_LEDS, 20); // Light up multiple LEDs for width int width 5; for (int i 0; i width; i) { int ledPos pos i - (width / 2); // 以 pos 为中心左右展开 if (ledPos 0 ledPos NUM_LEDS) { leds[ledPos] CRGB::Red; } } pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; } }注意循环内的越界检查if (ledPos 0 ledPos NUM_LEDS)因为光斑中心靠近端点时pos i - 2可能为负或超出NUM_LEDS - 1必须先过滤再写数组。width为奇数时中心对称最自然width5 时从 pos-2 覆盖到 pos2。6. 进阶技术变速扫描让扫描速度随位置动态变化产生“中心快、两端慢”的物理质感模拟钟摆或引力场void acceleratingCylon() { static uint8_t pos 0; static int8_t direction 1; static uint8_t speed 1; fadeToBlackBy(leds, NUM_LEDS, 20); leds[pos] CRGB::Red; // Calculate speed based on distance from center uint8_t distFromCenter abs(pos - NUM_LEDS / 2); speed map(distFromCenter, 0, NUM_LEDS / 2, 1, 3); pos direction * speed; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; pos constrain(pos, 0, NUM_LEDS - 1); // 钳制索引防越界 } }工作原理distFromCenter表示当前位置距灯带中点的距离中点处为 0端点处为NUM_LEDS / 2map()将这段距离映射到 1–3 的步长越靠近端点步长越大、移动越快由于步长可能大于 1pos一次可能越过边界好几个索引因此边界翻转后必须用constrain(pos, 0, NUM_LEDS - 1)把位置钳回合法区间——这正是无符号uint8_t场景下防止索引溢出/越界的必要防御。FastLED 还在 src/lib8tion.h 提供了面向 8 位值的map8(in, rangeStart, rangeEnd)语义与 Arduinomap等价可在嵌入式环境下替代map()使用。7. 源码级深入blur1d 平滑拖尾与官方实现7.1 用 blur1d 替代 fadeToBlackBy教程在 Tips 中建议想要更平滑、更“晕开”的拖尾可以用blur1d()替代fadeToBlackBy()。查看 src/fl/gfx/blur.cpp.hpp 的实现可知blur1d是一维模糊滤波把亮度向左右两个相邻 LED 扩散blur2d则向 8 个 XY 邻居扩散其注释给出了关键参数语义0完全不扩散64中等扩散172最大程度平滑均匀扩散173..255扩散更广但闪烁加剧总光量不守恒多次调用后整体逐渐变暗因此可以兼作缓慢清屏手段。用法示例void smoothCylon() { static uint8_t pos 0; static int8_t direction 1; blur1d(leds, NUM_LEDS, 80); // 向两侧扩散并缓慢衰减 leds[pos] CRGB::Red; pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; } }blur1d在 src/colorutils.h 中亦有using fl::blur1d;的公开导出。对比而言fadeToBlackBy只做“亮度按比例下降”拖尾是离散的阶梯残影blur1d在衰减的同时把亮度“抹”向两侧邻居拖尾更连续柔和代价是计算量稍大。7.2 官方 Cylon 示例剖析仓库中的 examples/Cylon/Cylon.ino 是上述教程效果的原版参考实现与教程版本有两个显著差异值得对照学习颜色连续变化官方版在每次点亮时使用CHSV(hue, 255, 255)色相每帧递增扫描头在移动的同时连续换色教程版默认用固定CRGB::Red。显式双循环驱动官方版用两个for循环分别实现“正向扫描”与“反向扫描”而不是用direction变量——正循环从 0 到NUM_LEDS - 1反循环从NUM_LEDS - 1回到 0每帧内fadeall()即leds[i].nscale8(250)制造残影。两种写法殊途同归教程版的static状态机更简洁、更易扩展成多扫描点官方版的循环结构更直观、更贴近“逐帧推进”的直觉。8. 时序控制与性能建议扫描动画的速度取决于“每帧移动一次”的节奏。教程的完整示例使用delay(30)但 timing.md 提供了更灵活的选择方式示例特点delay()delay(30)简单阻塞适合单任务EVERY_N_MILLISECONDS(30)宏内执行cylon(); FastLED.show();非阻塞loop()可兼顾其他任务millis()差值判断if (now - lastMove 30)非阻塞且最精确FastLED.delay(30)库自带 delay保持抖动dithering渲染质量性能方面60 颗灯带 fadeToBlackByFastLED.show()的每帧成本很低30–60 FPS 已经足够流畅。若灯带很长数百颗以上批量 APIfadeToBlackBy、blur1d、nscale8_video比逐像素for循环更优——src/fl/gfx/crgb.h 的注释明确指出数组批量版本针对寄存器复用做了优化应优先使用。9. 实践 Tips 汇总拖尾长短fadeToBlackBy()取值 20–50 效果最佳100 以上拖尾几乎消失255 则完全无拖尾。扫描速度delay()取 20–50ms 是典型区间对应约 20–50 FPS速度越快越灵动越慢越沉稳。色彩表达固定色用CRGB::Red等命名常量更可读需要渐变换色时用CHSV色相循环更自然。多扫描点每个扫描点独立维护static状态位置 方向可制造交汇、错位、追逐等丰富效果。平滑拖尾blur1d()能让残影更柔和连续但注意它的总光量不守恒多次调用会整体变暗。越界防护无论无符号位置变量还是宽光斑循环写leds[]前务必确认索引在[0, NUM_LEDS-1]区间。10. 下一步掌握扫描与追逐后可继续阅读 Rainbow Effects 学习如何用 HSV 色相循环实现平滑的彩虹渐变两者组合可以做出“扫描 连续换色 拖尾”的完整进阶动画。若想系统补足时序基础Timing and Frame Rate 提供了从delay()到beatsin8()节拍同步的完整时序方案。赞分享嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载相关推荐FastLED 基础图案实战指南纯色填充、亮度动画、扫描追逐与彩虹循环FastLED 基础图案实战指南纯色填充、亮度动画、扫描追逐与彩虹循环 本篇指南面向 FastLED 初学者系统讲解 LED 灯带编程的四大基础图案类型纯嵌入式物联网硬件开发驱动开发Android条形码扫描实战从零构建高效扫码应用Android条形码扫描实战从零构建高效扫码应用 还在为Android应用集成复杂的条形码扫描功能而烦恼吗BarcodeScanner库为你提供了开箱即用的移动开发网页端二维码扫描技术实战从零构建专业级扫描应用网页端二维码扫描技术实战从零构建专业级扫描应用 HTML5 QR Code是一款强大的跨平台二维码扫描工具能够帮助开发者轻松实现在网页端直接扫描二维码的功能上一篇如何用Mac Mouse Fix彻底改变你的Mac鼠标体验从普通鼠标到专业工具下一篇队列系统集成终极指南Sidekiq、Resque、DelayedJob与Recommendable的完美配合创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FastLED 追逐与扫描动画实战：Cylon 扫描灯效从零到进阶
嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载追逐Chase与扫描Scanner效果在 LED 灯带动画中极为经典一个亮点沿着灯带移动身后拖着一道逐渐变暗的残影最典型的代表就是《霹雳游侠》Knight Rider中的 Cylon 扫描灯。本文基于 FastLED 仓库的 chases.md 教程从位置追踪、拖尾实现、边界反弹讲起逐步深入到多扫描点、变色扫描、宽光斑与变速扫描等变体并给出官方 Cylon 示例 与源码级实现剖析。读完本文你将掌握用 FastLED 写出可复用的追逐/扫描动画函数并理解fadeToBlackBy()与blur1d()等底层 API 的工作原理。1. 效果概览追逐与扫描的本质区别动画的“移动感”来自两点位置随时间变化以及旧位置的亮度逐渐衰减。FastLED 教程将这类效果划分为两种基本形态扫描Scanner / Bouncing亮点在灯带两端之间来回反弹到达端点时方向取反如 Cylon 扫描灯。追逐Chase / Unidirectional亮点或一串亮点沿单一方向循环前进到达末端后回到起点重新开始。两种形态共用同一套核心技巧用static变量追踪当前位置、每帧移动位置、用衰减函数制造拖尾。官方示例 Cylon.ino 使用的正是“来回扫描 残影”的 Larson Scanner 效果官方注释将其描述为An animation that moves a single LED back and forth as the entire strip changes单个 LED 来回移动、整条灯带随之变化。2. 基础篇Cylon 扫描效果先实现最经典的版本——一个亮点来回反弹并留下渐变拖尾void cylon() { static uint8_t pos 0; // 当前位置static 保证跨调用保留 static int8_t direction 1; // 方向1 前进 / -1 后退 // 1. 先让整条灯带整体衰减形成拖尾 fadeToBlackBy(leds, NUM_LEDS, 20); // 2. 点亮当前位置 leds[pos] CRGB::Red; // 3. 移动位置并做边界检测 pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; // 触碰到端点就反向 } }2.1 五个关键机制位置追踪Position Trackingpos用static uint8_t声明只在首次调用时初始化为 0此后每次调用都保留上一次的值这是所有动画状态管理的基础与 animations.md 中static uint8_t brightness的用法一致。方向控制Direction Controldirection取int8_t有符号值为 1 表示向灯带末端移动-1 表示向起点移动。拖尾效果Trail Effect每帧先调用fadeToBlackBy()让所有 LED 朝黑色衰减再点亮新位置视觉上就形成“身后渐暗的残影”。边界检测Boundary Detection当pos到达 0 或NUM_LEDS - 1时翻转方向实现反弹。LED 点亮LED Illumination将当前坐标的颜色写入leds[pos]配合FastLED.show()输出到物理灯带。2.2 位置管理与边界检测位置更新与边界检测是扫描类效果的核心模式pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; }这里有两个易踩的坑值得注意pos使用uint8_t无符号因此不要把pos减到负数——边界判断必须在pos变为 0 时就及时反转方向否则无符号回绕会导致亮点跳到 255 的位置。灯带索引是 0 起始的最后一个有效索引是NUM_LEDS - 1。若用pos NUM_LEDS这类判断务必在边界处constrain()钳制防止越界写数组。在后面的“变速扫描”变体中源码使用了constrain(pos, 0, NUM_LEDS - 1)来保证索引不越界这正是对无符号变量越界的防御性处理。3. 关键概念fadeToBlackBy 拖尾衰减fadeToBlackBy()是整篇教程的核心 API。它对整条灯带批量执行“朝黑色按比例衰减”fadeToBlackBy(leds, NUM_LEDS, 20);第三个参数是衰减量0–255控制拖尾的长短衰减值效果拖尾长度20每帧只衰减约 8%残影消退慢长拖尾柔和100每帧衰减约 39%残影快速消失短拖尾255每帧衰减 100%直接熄灭无拖尾瞬时开关源码实现在 src/fl/gfx/colorutils.cpp.hpp 中fadeToBlackBy本质上是nscale8的封装void fadeToBlackBy(CRGB *leds, fl::u16 num_leds, fl::u8 fadeBy) { nscale8(leds, num_leds, 255 - fadeBy); }它把“衰减量 fadeBy”换算成“保留比例 255 - fadeBy”再对每个 LED 的 RGB 三通道执行 8 位定点缩放逐 LED 调用CRGB::nscale8()见 src/fl/gfx/crgb.h。也就是说fadeBy 20 时每帧每个通道都保留约 235/255 ≈ 92% 的亮度剩余 8% 被抹去残影因此以指数方式快速消失。与fadeLightBy()的区别同文件中fadeLightBy走的是nscale8_video()视频缩放路径对低亮度像素的衰减行为略有不同视频缩放能更好地保留暗部细节。日常做拖尾残影时fadeToBlackBy()是更常用的选择两者的批量版本在colorutils.h中都有对应的using声明见 src/colorutils.h。源码中的实际使用FastLED 官方 DemoReel100 效果集在 src/fl/fx/1d/demoreel100.h 中大量使用该 API例如confetti()L94-L99fadeToBlackBy(leds, 10) 随机位置撒点形成彩色纸屑效果sinelon()L101-L106fadeToBlackBy(leds, 20)beatsin16()驱动的来回亮点juggle()L119-L127fadeToBlackBy(leds, 20) 8 个亮点交错织行。这些例子证明“衰减 单点亮”就是 FastLED 生态里最通用的动画骨架。4. 完整可运行示例将上述函数放入标准 FastLED 工程即可直接运行灯带为 60 颗 WS2812B接 D5GRB 颜色顺序#include FastLED.h #define LED_PIN 5 #define NUM_LEDS 60 #define LED_TYPE WS2812B #define COLOR_ORDER GRB CRGB leds[NUM_LEDS]; void setup() { FastLED.addLedsLED_TYPE, LED_PIN, COLOR_ORDER(leds, NUM_LEDS); FastLED.setBrightness(50); // 全局亮度避免满功率刺眼 } void cylon() { static uint8_t pos 0; static int8_t direction 1; // Fade all LEDs fadeToBlackBy(leds, NUM_LEDS, 20); // Set current position leds[pos] CRGB::Red; // Move position pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; } } void loop() { cylon(); FastLED.show(); delay(30); // Control speed }其中delay(30)控制扫描速度每帧 30ms约合 33 FPS帧率换算公式FPS 1000 / delay_ms详见 timing.md。实际使用中若想让代码不被delay()阻塞可换成非阻塞的EVERY_N_MILLISECONDS(30) { cylon(); FastLED.show(); }结构宏定义在 src/lib8tion.h它允许loop()中继续执行按键、传感器读取等其他任务。5. 变体扩展教程提供了四种由浅入深的变体覆盖“多对象、变色、单向、宽光斑”四个方向。5.1 多扫描点Multiple Dots两枚亮点同屏对向扫描各自独立追踪位置与方向可产生交错碰撞的视觉效果void multiCylon() { static uint8_t pos1 0; static uint8_t pos2 NUM_LEDS / 2; // 第二枚从中间出发 static int8_t direction1 1; static int8_t direction2 -1; // 反向出发 fadeToBlackBy(leds, NUM_LEDS, 20); // First scanner leds[pos1] CRGB::Red; pos1 direction1; if (pos1 0 || pos1 NUM_LEDS - 1) { direction1 -direction1; } // Second scanner leds[pos2] CRGB::Blue; pos2 direction2; if (pos2 0 || pos2 NUM_LEDS - 1) { direction2 -direction2; } }要点每个扫描点都拥有独立的pos与direction状态且都声明为static。若把两枚扫描点的状态混用动画就会错乱。扩展到 N 枚扫描点时可将这些状态放入数组或结构体如struct Scanner { uint8_t pos; int8_t dir; }循环更新。5.2 变色扫描Color Changing Scanner扫描的同时按 HSV 色相循环换色在每次反弹时递增色相值void colorCylon() { static uint8_t pos 0; static int8_t direction 1; static uint8_t hue 0; // HSV 色相0-255 覆盖完整色环 fadeToBlackBy(leds, NUM_LEDS, 20); leds[pos] CHSV(hue, 255, 255); // CHSV 会自动转换为 CRGB pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; hue 32; // 每次反弹换一个色相32 ≈ 45° } }HSV 的优势在这里体现得淋漓尽致只需递增hue一个变量就能平滑遍历整个色环无需分别调整 R/G/B 三个通道HSV 色彩空间的使用细节可参考 solid-colors.md。hue 32意味着一次完整往返变换 8 种颜色数值越大换色越频繁。官方 Cylon.ino 也采用了同样的思路——它在每个循环帧里执行CHSV(hue, 255, 255)让亮点颜色随移动连续变化残影则由leds[i].nscale8(250)每帧保留 250/255 ≈ 98% 亮度逐点生成。5.3 单向追逐Simple Chase去掉方向反转亮点到达末端后回绕到起点形成单向循环追逐void chase() { static uint8_t pos 0; fadeToBlackBy(leds, NUM_LEDS, 30); // 衰减略快拖尾更短 leds[pos] CRGB::Green; pos; if (pos NUM_LEDS) { pos 0; // 回绕到起点 } }回绕也可以用取模写成pos (pos 1) % NUM_LEDS;二者等价。时序教程中给出的 Speed-Controlled Chase 正是这种回绕模式的非阻塞版——用millis()判断步进间隔用FastLED.clear()替代衰减。追逐效果可以再叠加“一串亮点”把leds[pos]和leds[(pos 1) % NUM_LEDS]、leds[(pos 2) % NUM_LEDS]同时点亮就得到经典的“彗星尾巴”追逐。5.4 宽光斑扫描Wider Scanner单个亮点升级为一小段光斑宽度 5通过循环点亮中心附近的多颗 LED 实现void wideCylon() { static uint8_t pos 0; static int8_t direction 1; fadeToBlackBy(leds, NUM_LEDS, 20); // Light up multiple LEDs for width int width 5; for (int i 0; i width; i) { int ledPos pos i - (width / 2); // 以 pos 为中心左右展开 if (ledPos 0 ledPos NUM_LEDS) { leds[ledPos] CRGB::Red; } } pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; } }注意循环内的越界检查if (ledPos 0 ledPos NUM_LEDS)因为光斑中心靠近端点时pos i - 2可能为负或超出NUM_LEDS - 1必须先过滤再写数组。width为奇数时中心对称最自然width5 时从 pos-2 覆盖到 pos2。6. 进阶技术变速扫描让扫描速度随位置动态变化产生“中心快、两端慢”的物理质感模拟钟摆或引力场void acceleratingCylon() { static uint8_t pos 0; static int8_t direction 1; static uint8_t speed 1; fadeToBlackBy(leds, NUM_LEDS, 20); leds[pos] CRGB::Red; // Calculate speed based on distance from center uint8_t distFromCenter abs(pos - NUM_LEDS / 2); speed map(distFromCenter, 0, NUM_LEDS / 2, 1, 3); pos direction * speed; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; pos constrain(pos, 0, NUM_LEDS - 1); // 钳制索引防越界 } }工作原理distFromCenter表示当前位置距灯带中点的距离中点处为 0端点处为NUM_LEDS / 2map()将这段距离映射到 1–3 的步长越靠近端点步长越大、移动越快由于步长可能大于 1pos一次可能越过边界好几个索引因此边界翻转后必须用constrain(pos, 0, NUM_LEDS - 1)把位置钳回合法区间——这正是无符号uint8_t场景下防止索引溢出/越界的必要防御。FastLED 还在 src/lib8tion.h 提供了面向 8 位值的map8(in, rangeStart, rangeEnd)语义与 Arduinomap等价可在嵌入式环境下替代map()使用。7. 源码级深入blur1d 平滑拖尾与官方实现7.1 用 blur1d 替代 fadeToBlackBy教程在 Tips 中建议想要更平滑、更“晕开”的拖尾可以用blur1d()替代fadeToBlackBy()。查看 src/fl/gfx/blur.cpp.hpp 的实现可知blur1d是一维模糊滤波把亮度向左右两个相邻 LED 扩散blur2d则向 8 个 XY 邻居扩散其注释给出了关键参数语义0完全不扩散64中等扩散172最大程度平滑均匀扩散173..255扩散更广但闪烁加剧总光量不守恒多次调用后整体逐渐变暗因此可以兼作缓慢清屏手段。用法示例void smoothCylon() { static uint8_t pos 0; static int8_t direction 1; blur1d(leds, NUM_LEDS, 80); // 向两侧扩散并缓慢衰减 leds[pos] CRGB::Red; pos direction; if (pos 0 || pos NUM_LEDS - 1) { direction -direction; } }blur1d在 src/colorutils.h 中亦有using fl::blur1d;的公开导出。对比而言fadeToBlackBy只做“亮度按比例下降”拖尾是离散的阶梯残影blur1d在衰减的同时把亮度“抹”向两侧邻居拖尾更连续柔和代价是计算量稍大。7.2 官方 Cylon 示例剖析仓库中的 examples/Cylon/Cylon.ino 是上述教程效果的原版参考实现与教程版本有两个显著差异值得对照学习颜色连续变化官方版在每次点亮时使用CHSV(hue, 255, 255)色相每帧递增扫描头在移动的同时连续换色教程版默认用固定CRGB::Red。显式双循环驱动官方版用两个for循环分别实现“正向扫描”与“反向扫描”而不是用direction变量——正循环从 0 到NUM_LEDS - 1反循环从NUM_LEDS - 1回到 0每帧内fadeall()即leds[i].nscale8(250)制造残影。两种写法殊途同归教程版的static状态机更简洁、更易扩展成多扫描点官方版的循环结构更直观、更贴近“逐帧推进”的直觉。8. 时序控制与性能建议扫描动画的速度取决于“每帧移动一次”的节奏。教程的完整示例使用delay(30)但 timing.md 提供了更灵活的选择方式示例特点delay()delay(30)简单阻塞适合单任务EVERY_N_MILLISECONDS(30)宏内执行cylon(); FastLED.show();非阻塞loop()可兼顾其他任务millis()差值判断if (now - lastMove 30)非阻塞且最精确FastLED.delay(30)库自带 delay保持抖动dithering渲染质量性能方面60 颗灯带 fadeToBlackByFastLED.show()的每帧成本很低30–60 FPS 已经足够流畅。若灯带很长数百颗以上批量 APIfadeToBlackBy、blur1d、nscale8_video比逐像素for循环更优——src/fl/gfx/crgb.h 的注释明确指出数组批量版本针对寄存器复用做了优化应优先使用。9. 实践 Tips 汇总拖尾长短fadeToBlackBy()取值 20–50 效果最佳100 以上拖尾几乎消失255 则完全无拖尾。扫描速度delay()取 20–50ms 是典型区间对应约 20–50 FPS速度越快越灵动越慢越沉稳。色彩表达固定色用CRGB::Red等命名常量更可读需要渐变换色时用CHSV色相循环更自然。多扫描点每个扫描点独立维护static状态位置 方向可制造交汇、错位、追逐等丰富效果。平滑拖尾blur1d()能让残影更柔和连续但注意它的总光量不守恒多次调用会整体变暗。越界防护无论无符号位置变量还是宽光斑循环写leds[]前务必确认索引在[0, NUM_LEDS-1]区间。10. 下一步掌握扫描与追逐后可继续阅读 Rainbow Effects 学习如何用 HSV 色相循环实现平滑的彩虹渐变两者组合可以做出“扫描 连续换色 拖尾”的完整进阶动画。若想系统补足时序基础Timing and Frame Rate 提供了从delay()到beatsin8()节拍同步的完整时序方案。赞分享嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载相关推荐FastLED 基础图案实战指南纯色填充、亮度动画、扫描追逐与彩虹循环FastLED 基础图案实战指南纯色填充、亮度动画、扫描追逐与彩虹循环 本篇指南面向 FastLED 初学者系统讲解 LED 灯带编程的四大基础图案类型纯嵌入式物联网硬件开发驱动开发Android条形码扫描实战从零构建高效扫码应用Android条形码扫描实战从零构建高效扫码应用 还在为Android应用集成复杂的条形码扫描功能而烦恼吗BarcodeScanner库为你提供了开箱即用的移动开发网页端二维码扫描技术实战从零构建专业级扫描应用网页端二维码扫描技术实战从零构建专业级扫描应用 HTML5 QR Code是一款强大的跨平台二维码扫描工具能够帮助开发者轻松实现在网页端直接扫描二维码的功能上一篇如何用Mac Mouse Fix彻底改变你的Mac鼠标体验从普通鼠标到专业工具下一篇队列系统集成终极指南Sidekiq、Resque、DelayedJob与Recommendable的完美配合创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考