3 new LED effect animations (#9827)

Co-authored-by: Joel Challis <git@zvecr.com>
Co-authored-by: Ryan <fauxpark@gmail.com>
Co-authored-by: Erovia <Erovia@users.noreply.github.com>

5 files changed, 65 insertions, 0 deletions

diff --git a/docs/feature_rgb_matrix.md b/docs/feature_rgb_matrix.md
index 6917de5ab4..e996cadddd 100644
--- a/docs/feature_rgb_matrix.md
+++ b/docs/feature_rgb_matrix.md
@@ -254,6 +254,9 @@ enum rgb_matrix_effects {
     RGB_MATRIX_RAINBOW_PINWHEELS,   // Full dual gradients spinning two halfs of keyboard
     RGB_MATRIX_RAINDROPS,           // Randomly changes a single key's hue
     RGB_MATRIX_JELLYBEAN_RAINDROPS, // Randomly changes a single key's hue and saturation
+    RGB_MATRIX_HUE_BREATHING,       // Hue shifts up a slight ammount at the same time, then shifts back
+    RGB_MATRIX_HUE_PENDULUM,        // Hue shifts up a slight ammount in a wave to the right, then back to the left
+    RGB_MATRIX_HUE_WAVE,            // Hue shifts up a slight ammount and then back down in a wave to the right 
 #if define(RGB_MATRIX_FRAMEBUFFER_EFFECTS)
     RGB_MATRIX_TYPING_HEATMAP,      // How hot is your WPM!
     RGB_MATRIX_DIGITAL_RAIN,        // That famous computer simulation
@@ -305,6 +308,9 @@ You can disable a single effect by defining `DISABLE_[EFFECT_NAME]` in your `con
 |`#define DISABLE_RGB_MATRIX_RAINBOW_PINWHEELS`         |Disables `RGB_MATRIX_RAINBOW_PINWHEELS`        |
 |`#define DISABLE_RGB_MATRIX_RAINDROPS`                 |Disables `RGB_MATRIX_RAINDROPS`                |
 |`#define DISABLE_RGB_MATRIX_JELLYBEAN_RAINDROPS`       |Disables `RGB_MATRIX_JELLYBEAN_RAINDROPS`      |
+|`#define DISABLE_RGB_MATRIX_HUE_BREATHING`             |Disables `RGB_MATRIX_HUE_BREATHING`            |
+|`#define DISABLE_RGB_MATRIX_HUE_PENDULUM`              |Disables `RGB_MATRIX_HUE_PENDULUM`             |
+|`#define DISABLE_RGB_MATRIX_HUE_WAVE `                 |Disables `RGB_MATRIX_HUE_WAVE `                |
 |`#define DISABLE_RGB_MATRIX_TYPING_HEATMAP`            |Disables `RGB_MATRIX_TYPING_HEATMAP`           |
 |`#define DISABLE_RGB_MATRIX_DIGITAL_RAIN`              |Disables `RGB_MATRIX_DIGITAL_RAIN`             |
 |`#define DISABLE_RGB_MATRIX_SOLID_REACTIVE_SIMPLE`     |Disables `RGB_MATRIX_SOLID_REACTIVE_SIMPLE`    |
diff --git a/quantum/rgb_matrix_animations/hue_breathing_anim.h b/quantum/rgb_matrix_animations/hue_breathing_anim.h
new file mode 100644
index 0000000000..37a6293c70
--- /dev/null
+++ b/quantum/rgb_matrix_animations/hue_breathing_anim.h
@@ -0,0 +1,22 @@
+#ifndef DISABLE_RGB_MATRIX_HUE_BREATHING

+RGB_MATRIX_EFFECT(HUE_BREATHING)

+#    ifdef RGB_MATRIX_CUSTOM_EFFECT_IMPLS

+

+// Change huedelta to adjust range of hue change. 0-255.

+// Hue Breathing - All LED's light up

+bool HUE_BREATHING(effect_params_t* params) {

+    RGB_MATRIX_USE_LIMITS(led_min, led_max);

+    uint8_t  huedelta = 12;

+    HSV      hsv      = rgb_matrix_config.hsv;

+    uint16_t time     = scale16by8(g_rgb_timer, rgb_matrix_config.speed / 8);

+    hsv.h             = hsv.h + scale8(abs8(sin8(time) - 128) * 2, huedelta);

+    RGB rgb           = hsv_to_rgb(hsv);

+    for (uint8_t i = led_min; i < led_max; i++) {

+        RGB_MATRIX_TEST_LED_FLAGS();

+        rgb_matrix_set_color(i, rgb.r, rgb.g, rgb.b);

+    }

+    return led_max < DRIVER_LED_TOTAL;

+}

+

+#    endif  // RGB_MATRIX_CUSTOM_EFFECT_IMPLS

+#endif      // DISABLE_RGB_HUE_BREATHING

diff --git a/quantum/rgb_matrix_animations/hue_pendulum_anim.h b/quantum/rgb_matrix_animations/hue_pendulum_anim.h
new file mode 100644
index 0000000000..37db649c18
--- /dev/null
+++ b/quantum/rgb_matrix_animations/hue_pendulum_anim.h
@@ -0,0 +1,17 @@
+#ifndef DISABLE_RGB_MATRIX_HUE_PENDULUM

+RGB_MATRIX_EFFECT(HUE_PENDULUM)

+#    ifdef RGB_MATRIX_CUSTOM_EFFECT_IMPLS

+

+// Change huedelta to adjust range of hue change. 0-255.

+// Looks better with a low value and slow speed for subtle change.

+// Hue Pendulum - color changes in a wave to the right before reversing direction

+static HSV HUE_PENDULUM_math(HSV hsv, uint8_t i, uint8_t time) {

+    uint8_t huedelta = 12;

+    hsv.h            = hsv.h + scale8(abs8(sin8(time) + (g_led_config.point[i].x) - 128) * 2, huedelta);

+    return hsv;

+}

+

+bool HUE_PENDULUM(effect_params_t* params) { return effect_runner_i(params, &HUE_PENDULUM_math); }

+

+#    endif  // RGB_MATRIX_CUSTOM_EFFECT_IMPLS

+#endif      // DISABLE_RGB_HUE_PENDULUM

diff --git a/quantum/rgb_matrix_animations/hue_wave_anim.h b/quantum/rgb_matrix_animations/hue_wave_anim.h
new file mode 100644
index 0000000000..1d4af5af43
--- /dev/null
+++ b/quantum/rgb_matrix_animations/hue_wave_anim.h
@@ -0,0 +1,17 @@
+#ifndef DISABLE_RGB_MATRIX_HUE_WAVE

+RGB_MATRIX_EFFECT(HUE_WAVE)

+#    ifdef RGB_MATRIX_CUSTOM_EFFECT_IMPLS

+

+// Change huedelta to adjust range of hue change. 0-255.

+// Looks better with a low value and slow speed for subtle change.

+// Hue Wave - color changes in a wave to the right

+static HSV HUE_WAVE_math(HSV hsv, uint8_t i, uint8_t time) {

+    uint8_t huedelta = 24;

+    hsv.h            = hsv.h + scale8(abs8(g_led_config.point[i].x - time), huedelta);

+    return hsv;

+}

+

+bool HUE_WAVE(effect_params_t* params) { return effect_runner_i(params, &HUE_WAVE_math); }

+

+#    endif  // RGB_MATRIX_CUSTOM_EFFECT_IMPLS

+#endif      // DISABLE_RGB_HUE_WAVE

diff --git a/quantum/rgb_matrix_animations/rgb_matrix_effects.inc b/quantum/rgb_matrix_animations/rgb_matrix_effects.inc
index 4c1723d933..053d441506 100644
--- a/quantum/rgb_matrix_animations/rgb_matrix_effects.inc
+++ b/quantum/rgb_matrix_animations/rgb_matrix_effects.inc
@@ -23,6 +23,9 @@
 #include "rgb_matrix_animations/rainbow_pinwheels_anim.h"
 #include "rgb_matrix_animations/raindrops_anim.h"
 #include "rgb_matrix_animations/jellybean_raindrops_anim.h"
+#include "rgb_matrix_animations/hue_breathing_anim.h"
+#include "rgb_matrix_animations/hue_pendulum_anim.h"
+#include "rgb_matrix_animations/hue_wave_anim.h"
 #include "rgb_matrix_animations/typing_heatmap_anim.h"
 #include "rgb_matrix_animations/digital_rain_anim.h"
 #include "rgb_matrix_animations/solid_reactive_simple_anim.h"