qmk开源键盘 rgb_matrix_indicators_advanced_user函数

rgb_matrix_indicators_advanced_user 是 QMK 固件中用于自定义 RGB 矩阵指示器的一个钩子函数。它允许用户根据键盘状态(例如按键状态、层状态等)来动态地控制 RGB 矩阵的灯光效果。通过这个函数,您可以实现复杂的灯光效果和状态指示。

函数原型

复制代码
void rgb_matrix_indicators_advanced_user(uint8_t led_min, uint8_t led_max);
  • led_minled_max 参数定义了需要更新的 LED 范围,通常用于优化性能,以避免不必要的更新。

示例

以下是一个示例代码,展示如何使用 rgb_matrix_indicators_advanced_user 函数来根据当前激活的层来改变 RGB 矩阵的灯光效果。

cpp 复制代码
#include "quantum.h"

// 定义不同层的颜色
#define LAYER_0_COLOR RGB_RED
#define LAYER_1_COLOR RGB_GREEN
#define LAYER_2_COLOR RGB_BLUE

void rgb_matrix_indicators_advanced_user(uint8_t led_min, uint8_t led_max) {
    // 获取当前激活的层
    uint8_t layer = biton32(layer_state);

    // 遍历所有 LED
    for (uint8_t i = led_min; i < led_max; i++) {
        // 获取 LED 的位置
        LED_TYPE *led = &g_led_config[i];

        // 根据当前层设置 LED 颜色
        switch (layer) {
            case 0:
                rgb_matrix_set_color(i, LAYER_0_COLOR);
                break;
            case 1:
                rgb_matrix_set_color(i, LAYER_1_COLOR);
                break;
            case 2:
                rgb_matrix_set_color(i, LAYER_2_COLOR);
                break;
            default:
                // 其他层默认关闭 LED
                rgb_matrix_set_color(i, 0, 0, 0);
                break;
        }
    }
}

解释

  1. 获取当前层 :使用 biton32(layer_state) 获取当前激活的层。
  2. 遍历所有 LED :使用 for 循环遍历所有 LED,从 led_minled_max
  3. 设置 LED 颜色 :根据当前层,使用 rgb_matrix_set_color 函数设置 LED 的颜色。

进一步的自定义

您可以根据需要进一步自定义 rgb_matrix_indicators_advanced_user 函数,例如:

  • 根据按键状态改变颜色 :使用 keyboard_report->keys 检查哪些键被按下,并相应地改变 LED 颜色。
  • 实现动态效果:例如根据时间或其他事件改变 LED 颜色,创建动态的灯光效果。

示例:根据按键状态改变颜色

以下是一个示例代码,展示如何根据按键状态来改变 LED 颜色:

cpp 复制代码
#include "quantum.h"

void rgb_matrix_indicators_advanced_user(uint8_t led_min, uint8_t led_max) {
    // 获取当前激活的层
    uint8_t layer = biton32(layer_state);

    // 遍历所有 LED
    for (uint8_t i = led_min; i < led_max; i++) {
        // 获取 LED 的位置
        LED_TYPE *led = &g_led_config[i];

        // 根据当前层设置 LED 颜色
        switch (layer) {
            case 0:
                rgb_matrix_set_color(i, RGB_RED);
                break;
            case 1:
                rgb_matrix_set_color(i, RGB_GREEN);
                break;
            case 2:
                rgb_matrix_set_color(i, RGB_BLUE);
                break;
            default:
                // 其他层默认关闭 LED
                rgb_matrix_set_color(i, 0, 0, 0);
                break;
        }
    }

    // 根据按键状态改变 LED 颜色
    for (uint8_t i = 0; i < MATRIX_ROWS; i++) {
        for (uint8_t j = 0; j < MATRIX_COLS; j++) {
            if (matrix_is_on(i, j)) {
                uint8_t led_index = g_led_config.matrix_co[i][j];
                if (led_index != NO_LED) {
                    rgb_matrix_set_color(led_index, RGB_WHITE);  // 按键被按下时设置为白色
                }
            }
        }
    }
}

解释

  1. 遍历所有 LED 并设置颜色:根据当前层设置所有 LED 的颜色。
  2. 根据按键状态改变颜色:遍历键盘矩阵,检查哪些键被按下,并将对应的 LED 设置为白色。

通过这些示例,您可以根据自己的需求自定义 rgb_matrix_indicators_advanced_user 函数,实现丰富多彩的 RGB 矩阵灯光效果

相关推荐
西瓜本瓜@3 小时前
在 Android 中实现通话录音
android·java·开发语言·学习·github·android-studio
码流怪侠3 小时前
🚀 2025年 GitHub 暴涨 star 热门项目 🔥【持续更新】
程序员·github
Gladiator5756 小时前
博客记录-day148-力扣+面试
github
创实信息7 小时前
GitHub Copilot在产品/安全团队中的应用实践:处理Markdown、自动化报告与电子表格、使用CLI命令等
github·copilot·ai编程
七月丶8 小时前
📦 把 CLI 工具发布到 npm:gix 发布流程全解析(附 CI 自动化)
前端·后端·github
流沙krysent11 小时前
git常用指令
前端·github
运营猫小海豚11 小时前
Dootask任务管理实战——从需求到交付的闭环
前端·github
我是哪吒11 小时前
分布式微服务系统架构第118集:Future池管理容器-CompletableFuture
后端·面试·github
OpenTiny社区11 小时前
Node.js技术原理分析系列8——将Node.js内置模块外置
前端·node.js·github
Andy32212 小时前
029 期 告别复杂!三款神器让你的Docker管理轻松又高效
docker·github