X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=docs%2Ffeature_rgblight.md;h=0f1e649ef851ef238b1d590cac510c4b84594566;hb=0592d23b74142a554c9e36d2da7bf525fbe3a4c0;hp=8f4f080248252c7b0738a8ddc33a16b561101699;hpb=7b0356d1d49da6574570e110f61f95692afdb3d0;p=qmk_firmware.git diff --git a/docs/feature_rgblight.md b/docs/feature_rgblight.md index 8f4f08024..0f1e649ef 100644 --- a/docs/feature_rgblight.md +++ b/docs/feature_rgblight.md @@ -41,6 +41,9 @@ You can change the behavior of the RGB Lighting by setting these configuration v | `RGBLIGHT_HUE_STEP` | 10 | How many hues you want to have available. | | `RGBLIGHT_SAT_STEP` | 17 | How many steps of saturation you'd like. | | `RGBLIGHT_VAL_STEP` | 17 | The number of levels of brightness you want. | +| `RGBLIGHT_LIMIT_VAL` | 255 | Limit the val of HSV to limit the maximum brightness simply. | +| `RGBLIGHT_SLEEP` | | `#define` this will shut off the lights when the host goes to sleep | + ### Animations @@ -89,34 +92,35 @@ rgblight_disable(); // turn all lights off rgblight_enable(); // turn lights on, based on their previous state (stored in EEPROM) rgblight_setrgb(r, g, b); // where r/g/b is a number from 0..255. Turns all the LEDs to this color -rgblight_sethsv(h, s, v); // HSV color control +rgblight_sethsv(h, s, v); // HSV color control - h is a value from 0..360 and s/v is a value from 0..255 rgblight_setrgb_at(r,g,b, LED); // control a single LED. 0 <= LED < RGBLED_NUM rgblight_sethsv_at(h,s,v, LED); // control a single LED. 0 <= LED < RGBLED_NUM ``` +You can find a list of predefined colors at [`quantum/rgblight_list.h`](https://github.com/qmk/qmk_firmware/blob/master/quantum/rgblight_list.h). Free to add to this list! ## RGB Lighting Keycodes These control the RGB Lighting functionality. -| Long Name | Short Name | Description | -|-----------|------------|-------------| -||`RGB_TOG`|toggle on/off| -|`RGB_MODE_FORWARD`|`RGB_MOD`|cycle through modes, use reverse direction when shift is held| -|`RGB_MODE_REVERSE`|`RGB_RMOD`|cycle through modes in reverse (also suppost shift to go forward)| -||`RGB_HUI`|hue increase| -||`RGB_HUD`|hue decrease| -||`RGB_SAI`|saturation increase| -||`RGB_SAD`|saturation decrease| -||`RGB_VAI`|value (brightness) increase| -||`RGB_VAD`|value (brightness) decrease| -|`RGB_MODE_PLAIN`|`RGB_M_P `| Switch to the static no animation mode | -|`RGB_MODE_BREATHE`|`RGB_M_B`| Switch to the breathing mode | -|`RGB_MODE_RAINBOW`|`RGB_M_R`| Switch to the rainbow mode || -|`RGB_MODE_SWIRL`|`RGB_M_SW`| Switch to the swirl mode | -|`RGB_MODE_SNAKE`|`RGB_M_SN`| Switch to the snake mode | -|`RGB_MODE_KNIGHT`|`RGB_M_K`| Switch to the knight animation | -|`RGB_MODE_XMAS`|`RGB_M_X`| Switch to the Christmas animation | -|`RGB_MODE_GRADIENT`|`RGB_M_G`| Switch to the static gradient mode | +|Key |Aliases |Description | +|-------------------|----------|--------------------------------------------------------------------| +|`RGB_TOG` | |Toggle RGB lighting on or off | +|`RGB_MODE_FORWARD` |`RGB_MOD` |Cycle through modes, reverse direction when Shift is held | +|`RGB_MODE_REVERSE` |`RGB_RMOD`|Cycle through modes in reverse, forward direction when Shift is held| +|`RGB_HUI` | |Increase hue | +|`RGB_HUD` | |Decrease hue | +|`RGB_SAI` | |Increase saturation | +|`RGB_SAD` | |Decrease saturation | +|`RGB_VAI` | |Increase value (brightness) | +|`RGB_VAD` | |Decrease value (brightness) | +|`RGB_MODE_PLAIN` |`RGB_M_P `|Static (no animation) mode | +|`RGB_MODE_BREATHE` |`RGB_M_B` |Breathing animation mode | +|`RGB_MODE_RAINBOW` |`RGB_M_R` |Rainbow animation mode | +|`RGB_MODE_SWIRL` |`RGB_M_SW`|Swirl animation mode | +|`RGB_MODE_SNAKE` |`RGB_M_SN`|Snake animation mode | +|`RGB_MODE_KNIGHT` |`RGB_M_K` |"Knight Rider" animation mode | +|`RGB_MODE_XMAS` |`RGB_M_X` |Christmas animation mode | +|`RGB_MODE_GRADIENT`|`RGB_M_G` |Static gradient animation mode | note: for backwards compatibility, `RGB_SMOD` is an alias for `RGB_MOD`.