AWTRIX 3动画效果制作：从基础到高级的视觉特效完全指南

AWTRIX 3动画效果制作：从基础到高级的视觉特效完全指南

【免费下载链接】awtrix-lightCustom firmware for the Ulanzi Smart Pixel clock or self made awtrix. Getting started is easy as 1-2-3项目地址: https://gitcode.com/gh_mirrors/aw/awtrix-light

AWTRIX 3是一款基于Ulanzi智能像素时钟的自定义固件，它允许用户创建和展示各种动态视觉效果。本指南将带您从基础开始，逐步掌握AWTRIX 3动画效果的制作技巧，让您的智能时钟展现出令人惊艳的视觉体验。

准备工作：AWTRIX 3开发环境搭建

在开始制作动画效果之前，您需要先搭建好AWTRIX 3的开发环境。首先，克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/aw/awtrix-light

项目的核心动画效果代码位于src/effects.cpp文件中。这个文件包含了所有内置动画效果的实现，是我们学习和自定义动画的主要参考。

AWTRIX 3项目封面图，展示了绚丽的像素动画效果

理解AWTRIX 3动画系统

AWTRIX 3的动画系统基于FastLED库构建，通过调用不同的效果函数来实现各种动态视觉效果。每个效果函数都接收一个FastLED_NeoMatrix对象、位置参数和效果设置参数。

动画效果的基本结构

在src/effects.cpp中，每个动画效果都遵循类似的结构：

void EffectName(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { // 效果实现代码 }

• matrix：指向LED矩阵的指针，用于绘制像素
• x和y：效果在矩阵上的起始位置
• settings：包含效果的速度、颜色 palette 等设置

效果注册与管理

所有效果都在effects数组中注册：

Effect effects[] = { // 效果列表 };

这个数组定义了所有可用的动画效果，包括效果名称和对应的函数指针。

基础动画效果制作

让我们从几个简单的动画效果开始，了解AWTRIX 3动画制作的基本原理。

1. 色彩波浪效果 (ColorWaves)

色彩波浪效果通过在矩阵上移动不同颜色的条纹来创造动态视觉效果。其核心原理是使用正弦函数计算每个像素的颜色值。

void ColorWaves(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { float colorIndex = 255 / (32 - 1); for (uint16_t i = 0; i < 32; i++) { for (uint16_t j = 0; j < 8; j++) { uint8_t paletteIndex = ((uint8_t)(i * colorIndex + millis() * settings->speed / 100)) % 256; CRGB color = ColorFromPalette(settings->palette, paletteIndex, 255, settings->blend ? LINEARBLEND : NOBLEND); matrix->drawPixel(x + i, y + j, color); } } }

这个效果通过改变paletteIndex的值来实现颜色的变化，而settings->speed控制了波浪移动的速度。

2. 剧院追逐效果 (TheaterChase)

剧院追逐效果模拟了剧院 marquee 灯光的追逐效果，通过周期性地点亮不同的像素来创造动态感。

void TheaterChase(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { static uint16_t j = 0; static uint32_t lastUpdate = 0; if (millis() - lastUpdate > 100 - settings->speed * 10) { lastUpdate = millis(); j += 1; } for (uint16_t i = 0; i < 32; i++) { for (uint16_t k = 0; k < 8; k++) { if ((i + j) % 3 == 0) { uint8_t colorIndex = (i * 256 / 32) & 255; CRGB color = ColorFromPalette(settings->palette, colorIndex, 255, settings->blend ? LINEARBLEND : NOBLEND); matrix->drawPixel(x + i, y + k, color); } else { matrix->drawPixel(x + i, y + k, matrix->Color(0, 0, 0)); } } } }

这个效果使用了一个静态变量j来跟踪追逐位置，通过(i + j) % 3 == 0的条件来决定哪些像素点亮。

中级动画效果制作

中级动画效果通常涉及更复杂的数学计算和状态管理，能够创造出更丰富的视觉体验。

1. 等离子效果 (Plasma)

等离子效果通过组合多个正弦波来创造流动的、类似等离子体的视觉效果。

void Plasma(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { static double time = 0; for (uint16_t i = 0; i < 32; i++) { for (uint16_t j = 0; j < 8; j++) { uint8_t value = sin8(i * 10 + time) + sin8(j * 10 + time / 2) + sin8((i + j) * 10 + time / 3) / 3; CRGB color = ColorFromPalette(settings->palette, value, 255, settings->blend ? LINEARBLEND : NOBLEND); matrix->drawPixel(x + i, y + j, color); } } time += settings->speed; }

这个效果使用了三个不同频率的正弦波，通过它们的叠加来计算每个像素的颜色值，创造出复杂的流动效果。

2. 矩阵效果 (Matrix)

矩阵效果模拟了电影《黑客帝国》中的数字雨效果，字符从屏幕顶部落下。

void Matrix(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { static uint32_t lastMove = 0; static CRGB spawnColor = CRGB(175, 255, 175); static CRGB trailColor = CRGB(27, 130, 39); static uint8_t intensity = 8; static CRGB ledState[32][8]; uint8_t baseSpeed = 180; uint8_t speed = baseSpeed - (settings->speed * 15); uint8_t fadeSpeed = 100; uint8_t fade = map(fadeSpeed, 0, 255, 50, 250); if (millis() - lastMove >= speed) { lastMove = millis(); // 下移像素 for (uint16_t i = 0; i < 32; i++) { for (uint16_t j = 8 - 1; j > 0; j--) { ledState[i][j] = ledState[i][j - 1]; } } // 生成新像素 for (uint16_t i = 0; i < 32; i++) { if (ledState[i][0] == spawnColor) { ledState[i][0] = trailColor; } else { ledState[i][0].fadeToBlackBy(fade); } if (random8() < intensity) { ledState[i][0] = spawnColor; } } } // 绘制 for (uint16_t i = 0; i < 32; i++) { for (uint16_t j = 0; j < 8; j++) { matrix->drawPixel(x + i, y + j, ledState[i][j]); } } }

这个效果使用了一个二维数组ledState来保存每个像素的状态，通过下移像素和随机生成新像素来模拟数字雨效果。

AWTRIX 3显示"HELLO"文字的效果示例，展示了像素矩阵的显示能力

高级动画效果制作

高级动画效果通常涉及复杂的物理模拟或游戏逻辑，能够创造出交互式的视觉体验。

1. 贪吃蛇游戏 (SnakeGame)

贪吃蛇游戏是一个经典的游戏效果，玩家控制一条蛇吃食物并不断长大。

void SnakeGame(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { // 游戏状态初始化 if (isGameOver) { // 初始化蛇、苹果等 } // 游戏逻辑更新 if (millis() - lastUpdate > 150 - settings->speed * 10) { // 更新方向、移动蛇、检测碰撞等 } // 绘制蛇和苹果 for (uint8_t i = 0; i < snakeLength; i++) { CRGB color = ColorFromPalette(settings->palette, snake[i].colorIndex, 255, settings->blend ? LINEARBLEND : NOBLEND); matrix->drawPixel(x + snake[i].x, y + snake[i].y, color); } matrix->drawPixel(x + apple.x, y + apple.y, matrix->Color(255, 0, 0)); }

这个效果实现了完整的贪吃蛇游戏逻辑，包括蛇的移动、食物生成、碰撞检测等。通过settings->speed可以控制游戏的速度。

2. 烟花效果 (Fireworks)

烟花效果模拟了夜空中绽放的烟花，通过粒子系统实现爆炸效果。

void Fireworks(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { // 生成新烟花 if (millis() - lastFireworkTime >= 1000 / fireworkInterval && random(100) < 50) { // 找到空闲烟花槽并初始化 } // 更新和绘制烟花 for (uint8_t i = 0; i < MAX_FIREWORKS; i++) { if (fireworks[i].life > 0) { // 更新烟花位置、生命周期 // 绘制烟花和爆炸效果 } } }

这个效果使用了一个烟花结构体数组来管理多个同时绽放的烟花，每个烟花有自己的位置、生命周期和颜色。

自定义动画效果

了解了AWTRIX 3动画系统的基本原理后，您可以开始创建自己的自定义动画效果了。以下是创建自定义效果的基本步骤：

1. 创建效果函数：按照前面介绍的基本结构，实现您的效果逻辑。
2. 注册效果：在effects数组中添加您的效果名称和函数指针。
3. 测试效果：编译并上传固件，在AWTRIX设备上测试您的效果。

自定义效果示例：呼吸灯效果

下面是一个简单的呼吸灯效果示例，它使整个矩阵的亮度周期性地变化：

void BreathingLight(FastLED_NeoMatrix *matrix, int16_t x, int16_t y, EffectSettings *settings) { static uint8_t brightness = 0; static int8_t direction = 1; static uint32_t lastUpdate = 0; if (millis() - lastUpdate > 20) { lastUpdate = millis(); brightness += direction * settings->speed; if (brightness >= 255) { brightness = 255; direction = -1; } else if (brightness <= 0) { brightness = 0; direction = 1; } } CRGB color = ColorFromPalette(settings->palette, millis() / 10, brightness, settings->blend ? LINEARBLEND : NOBLEND); matrix->fillScreen(color); }

这个效果使用一个静态变量brightness来跟踪当前亮度，通过改变direction的值来实现亮度的增减，从而创造出呼吸效果。

动画效果的配置与控制

AWTRIX 3提供了多种方式来配置和控制动画效果，包括：

1. 速度控制：通过settings->speed调整效果的播放速度。
2. 颜色 palette：通过settings->palette选择不同的颜色组合。
3. 混合模式：通过settings->blend控制颜色混合方式。

您可以通过MQTT消息或Web界面来实时调整这些参数，实现动态效果控制。相关的控制代码位于src/MQTTManager.cpp和src/ServerManager.cpp文件中。

总结与进阶

通过本指南，您已经了解了AWTRIX 3动画效果制作的基本原理和方法。从简单的色彩波浪到复杂的游戏效果，AWTRIX 3提供了丰富的可能性来创造独特的视觉体验。

要进一步提升您的动画制作技能，可以：

1. 研究src/effects.cpp中的其他效果实现，学习不同的动画技术。
2. 尝试结合多个基本效果，创造更复杂的复合效果。
3. 利用传感器数据（如光照、温度）来控制动画效果，实现交互式体验。

AWTRIX 3的动画系统是一个开放的平台，等待您的创意来丰富它的视觉效果库。祝您创作愉快！

【免费下载链接】awtrix-lightCustom firmware for the Ulanzi Smart Pixel clock or self made awtrix. Getting started is easy as 1-2-3项目地址: https://gitcode.com/gh_mirrors/aw/awtrix-light