WLED WLED Max 效果 2D 矩阵

WLED 效果列表与实时预览

WLED 有 180 多种效果:WLED 0.15 上约 187 种,WLED 16 上超过 200 种。Speed、Intensity 和额外滑块各是什么意思,以及如何预览每一种效果。

作者: 发布于 更新于

本文作者 Jamie Conde 在 MeowScript 开发 WLED Max。 WLED Max 是一款独立 App,与官方 WLED 项目无关,也未获其认可。

同一个 Wi-Fi 下的两盏 WLED 灯可能显示不同的效果列表,而且两盏都没坏。列表并不存在于您的 App 里。每盏灯报告自己的列表,并附带元数据,说明某个效果用到哪些滑块、它是 2D 效果还是音频律动效果。在 WLED 0.15 上大约有 187 种效果。WLED 16 增加了粒子效果,总数超过 200。

本页前半部分讲 WLED 本身,适用于任何 App。后半部分讲 WLED Max 中的实时预览。

为什么列表不一样

有几个因素决定了一盏灯报告什么:

  • 固件版本。 WLED 0.14 和 0.15 大约有 187 种效果。WLED 16(0.15 之后的版本,2026 年以新编号发布)增加了粒子效果(ID 187 到 217),外加 Color Clouds 和 Slow Transition,共 220 个效果 ID。
  • 编译选项。 自定义编译可以去掉一些效果以节省空间,这在 ESP8266 上很重要。
  • 音频律动效果在新版本中属于列表的一部分,但只有在编译时包含并设置了 AudioReactive 用户模块时它们才会对声音做出反应。大多数 ESP32 版本都带有它。在 ESP8266 上取决于编译版本,而且 ESP8266 只能从另一台设备接收音频同步。
  • 2D 效果只有在您于 Config > 2D Configuration 中设置了矩阵之后才有意义。在普通灯带上它们也能运行,但通常看起来像被压扁的矩阵效果。
一盏灯报告的效果数
WLED 0.14 和 0.15约 187
WLED 16(新增粒子效果 187 到 217)220 个 ID
自定义 ESP8266 编译版本可能更少

任何从灯读取列表的 App(名称来自 /json/eff,0.14 及更新版本的元数据来自 /json/fxdata)都会与您的固件一致。而带硬编码列表的 App 会随着 WLED 的变化逐渐脱节。举个例子:在 WLED 16 中,效果 77 变成了 Copy Segment(以前是 Meteor Smooth),所以一个指向效果 77 的旧预设在更新后会显示另一个效果。

滑块的含义

每种效果都有同一套控件,但每种效果自己决定它们的作用。元数据字符串告诉界面显示哪些控件以及叫什么名字。例如,Solid Pattern 的元数据是 Solid Pattern@Fg size,Bg size;Fg,!;!;;pal=0,意思是 Speed 滑块标为“Fg size”,Intensity 滑块标为“Bg size”,默认调色板是 0。

Solid Pattern@Fg size,Bg size;Fg,!;!;;pal=0
Speed 滑块Fg size
Intensity 滑块Bg size
颜色Fg,然后是默认值
默认调色板0
  • Speed(速度)和 Intensity(强度)是两个经典滑块,范围 0 到 255。
  • Custom 1 到 3 是某些效果额外添加的滑块(例如模糊或第二个尺寸)。
  • Option 1 到 3 是复选框,比如“Overlay”或“Smear”。
  • 颜色和调色板:有些效果用您的颜色槽,有些用调色板,有些两者都用。如果您选的颜色没有任何作用,说明该效果基于调色板(见 WLED 颜色与白光通道)。

在 WLED 网页界面中查找效果

  1. 在浏览器中打开灯的 IP,进入 Effects 面板。
  2. 用列表顶部的搜索框按名称筛选。
  3. 在新版本上,小的筛选按钮可以只显示使用调色板的效果、2D 效果,或者音量和频率响应效果。
  4. 点一个效果即可应用,然后用下方的滑块调整。
  5. 不用看灯也想知道它在做什么的话,Peek 按钮会显示一条当前输出的实时色条。
WLED 网页界面
WLED 网页界面的 Effects 标签页,搜索框中输入了 Solid Pattern:Solid、Solid Pattern(已选中)和 Solid Pattern Tri,下方是该效果的两个滑块
网页界面 Effects 标签页中的搜索框(WLED 16.0.1)。

问题在于,只有应用之后您才知道一个效果长什么样。187 种以上的效果,那要点很多次。

WLED Max 中的实时预览

WLED Max 的 效果 标签页会把您的灯报告的每一种效果以动态灯带或矩阵的形式实时演示出来。每个预览的运动方式就是该效果在您灯上的样子,所以您看到的是真实效果,而不是通用图标或 GIF。

  • 1D 灯带 和 2D 矩阵 标签。在矩阵上,效果分为“矩阵专属”效果和“矩阵上的灯带效果”两组。
  • 筛选: 音量(音量响应)、频率(频率响应)和 矩阵专属,都读取自灯自己的效果元数据。筛选需要 WLED 0.14 或更新版本,因为旧版本不报告元数据。
  • 搜索效果… 按名称筛选。
  • 隐藏效果: 长按一个您从不使用的效果即可隐藏它。显示已隐藏的效果(N) 把它们找回来,再用 取消隐藏 取消隐藏。
  • 一点即用。 点一个效果,它会立刻应用并一直保持。
iOS
iPhone 上 WLED Max 的“效果”标签页,“1D 灯带”视图:163 种效果,“搜索效果”搜索框,“音量”和“频率”筛选,类别标签“全部”、“收藏”、Solid 和“经典”,然后是 Solid、Dynamic、Saw 和 Traffic Light 等效果,每个都带动态灯带预览和一个“自定义”按钮
1D 灯带:列表中的每个效果都在动。
iOS
“效果”标签页,“2D 矩阵”视图:216 种效果以矩阵预览显示,“音量”、“频率”和“矩阵专属”筛选,标签“全部”、“收藏”、Solid 和“经典”,一条关于 32 乘 16 虚拟矩阵的说明,以及 Rotozoomer、Spaceships、Crazy Bees 和 Ghost Rider 等矩阵专属效果的网格
2D 矩阵,“矩阵专属”效果排在前面。
效果搜索中输入了 fire:163 种效果中的 8 种,上方是筛选和类别标签,显示 Fireworks 和 Fireworks Starburst
搜索效果:输入“fire”后 163 种只剩 8 种。

预览显示的是您的固件拥有的效果,所以数量与您的灯一致。

自定义效果

在某个效果上点 自定义 即可打开它的控件:速度、强度、该效果定义的额外滑块和选项(名称与元数据中的一致)、调色板、颜色和亮度。对 Scrolling Text 还有一个 显示文字 字段。预览会跟随您的更改,当某个效果忽略调色板或颜色时,提示会说明。

iOS
Fireworks 效果的“自定义”面板:矩阵预览、一个“频率”滑块、带“主色”、“背景”和“自定义”三个槽的“颜色”、一条背景色为黑色的提示、“调色板”选择器,以及顶部的“应用”按钮
Fireworks 的“自定义”面板。“颜色”下方的提示解释了黑色背景色的作用。

打开“自定义”,或者点一下正在运行的效果,都会保留您现在的调色板、颜色和滑块。只有选一个不同的效果时,才会加载该效果自己的默认值,和 WLED 网页的做法一样。

如果您选的颜色会被当前调色板盖住,App 会把调色板切换为 * Color 1、* Colors 1&2 或 * Colors Only(一种、两种或三种颜色),并用一条简短提示告诉您,例如“已将调色板切换为 Colors 1&2,以便显示您选的颜色。”如果您自己选了调色板,App 会保留您的选择。像 Aurora 和 Dissolve 这类会保留颜色的效果,在您改颜色或调色板时会重新开始,新颜色大约 2 秒内就会出现。详见 WLED 颜色与白光通道。

您的更改会随着操作实时发送到灯上。满意之后,点 应用 保留结果并关闭面板。取消 把灯恢复到您打开面板之前的状态(只选中一盏灯时有“取消”;选中分组时没有“取消”,只有“应用”)。想用滑动关闭它,从面板上部(把手、标题行或预览)向下滑,或者直接点“取消”或“应用”。滚动控件永远不会关闭面板,所以您可以在一长串滑块中向上滚动而不会丢掉它。

想把这个灯效留着以后用,点面板底部的 保存为预设,取个名字,再选择保存位置。在 iOS 上您可以选 保存到设备(灯上的一个预设槽位)或 保存到云端(可应用到任何灯的全局预设)。在 Android 上是 保存到设备 或 保存为全局预设。更多内容见 WLED 预设与开机预设。

想把同一个效果一次发给几盏灯,用 应用到多台设备…,详见 同时控制多台 WLED 设备。

每天都用的效果可以放进“控制”标签页的快捷效果,最多六个,一点即用。在效果浏览器中您还可以长按某个效果并点 添加到收藏。类别行中的 收藏 标签随后只显示您加星的效果。同一菜单中的 从收藏中移除 可以再把它移除。两个平台的 App 从 1.1.4 版起都有“收藏”标签。

iOS
“效果”标签页,Rainbow 效果的菜单已打开:应用到 Porch Lights、应用到多台设备、调整参数、添加到收藏和隐藏效果
长按一个效果,然后点“添加到收藏”。
iOS
“效果”标签页,已选中“收藏”标签:163 种效果中的 1 种,显示名字旁带星号的 Rainbow
“收藏”标签只显示加星的效果。

适合圣诞和万圣节的 WLED 效果

在这份长长的效果列表里,节日时真正常用的只有少数几个。它们在 WLED 0.14、0.15 和 16 上都存在(括号里的数字是效果 ID)。

  • 圣诞: Colortwinkles(74)和 Twinklefox(80)配 Jul 或 C9 调色板做经典灯泡,Fairy(49)和 Fairytwinkle(51)做闪烁灯串,Chase 2(37)和 Running(15)用红白两色做拐杖糖条纹,Candle Multi(102)用暖白装点窗户。每一种的滑块数值见 WLED 圣诞图案。
  • 万圣节: Halloween Eyes(82)、Lightning(57)、Fire 2012(66)、Candle(88)和 Drip(96),再加上用 Solid Pattern(83)做橙紫色块。WLED 万圣节指南提供可直接粘贴的设置和预设。

其他节日的颜色和效果按日期列在 节日颜色指南 中。

缺少效果和奇怪的滑块

效果在灯上和预览里看起来不一样。 检查灯的 LED 数量和矩阵尺寸是否设置正确(App 的“设备设置”中的“LED 设置”和“2D 配置”,或 WLED 16 网页界面中的 LED & Hardware 和 2D Configuration),因为效果会随长度缩放。也检查一下亮度限制。受电源限制的灯带看起来比预览暗。

音频律动效果不动。 灯需要带麦克风或音频同步输入的 AudioReactive 用户模块。没有声音输入时它们会静止不动或显示一个平坦的图案。

2D 效果看起来像随机条纹。 没有配置矩阵,或者 2D Configuration 中的面板布局(蛇形走线、起始角)不对。

筛选按钮不见了或者是空的。 灯运行的固件比 0.14 旧,不报告效果元数据。更新 WLED。

更新到 WLED 16 后旧预设显示了错误的效果。 这就是效果 77 的变化。WLED Max 会在“预设”标签页显示一条警告,列出使用效果 77 的预设,让您知道该修哪些。用您想要的效果重新保存该预设。

如果您只想在不用任何 App 的情况下了解效果,WLED 文档列出了它们并附有简短说明。想在同一条灯带的不同部分运行不同效果,见 WLED 分段详解。

我们的 iOS 和 Android App WLED Max:一盏灯即可免费使用全部功能。