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 小时前
又给腾讯贡献了一段代码:从 `%` 格式化到 f-string 的改进
python·开源·github
斯普信专业组3 小时前
Ceph与Bacula运维实战:数据迁移与备份配置优化指南
运维·ceph·github
HelloGitHub4 小时前
想让你多爱自己一些的开源计时器
开源·github
宅小海6 小时前
11 配置Hadoop集群-免密登录
大数据·hadoop·github
雨声不在14 小时前
用mkdocs写文档#自动更新github-page
github
曹天骄16 小时前
DaemonSet 与 Deployment 的主要区别
github
遇到困难睡大觉哈哈19 小时前
hexo+GitHub Pages搭建个人博客完整教程
github
uhakadotcom19 小时前
快速构建交互式数据应用:Streamlit入门指南
后端·面试·github
xinxiyinhe1 天前
GitHub上免费学习工具的精选汇总
学习·github
AI云极1 天前
小白也能上手的大模型训练神器!MiniMind真把AI“平民化”了!
github