diff options
| author | Ryan Caltabiano <rcalt2vt@gmail.com> | 2019-05-15 22:23:42 -0500 |
|---|---|---|
| committer | Drashna Jaelre <drashna@live.com> | 2019-05-19 09:38:38 -0700 |
| commit | 5c7b37bbbde969eb056d531c897c1d5f80beeb58 (patch) | |
| tree | 1f8f0103c4e54004d6ba147add879402de70cda0 /docs/feature_rgb_matrix.md | |
| parent | 270b39b2eb44247cff75ddd216a8e67f8f264991 (diff) | |
| download | qmk_firmware-5c7b37bbbde969eb056d531c897c1d5f80beeb58.tar.gz qmk_firmware-5c7b37bbbde969eb056d531c897c1d5f80beeb58.zip | |
Added custom center point to rgb matrix
Diffstat (limited to 'docs/feature_rgb_matrix.md')
| -rw-r--r-- | docs/feature_rgb_matrix.md | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/docs/feature_rgb_matrix.md b/docs/feature_rgb_matrix.md index 18636776c..8f0cd12b3 100644 --- a/docs/feature_rgb_matrix.md +++ b/docs/feature_rgb_matrix.md | |||
| @@ -144,14 +144,16 @@ const led_config_t g_led_config = { { | |||
| 144 | } }; | 144 | } }; |
| 145 | ``` | 145 | ``` |
| 146 | 146 | ||
| 147 | The first part, `// Key Matrix to LED Index`, tells the system what key this LED represents by using the key's electrical matrix row & col. The second part, `// LED Index to Physical Position` represents the LED's physical position on the keyboard. The first value, `x`, is between 0-224 (inclusive), and the second value, `y`, is between 0-64 (inclusive). This range is due to effect that calculate the center or halves for their animations. The easiest way to calculate these positions is imagine your keyboard is a grid, and the top left of the keyboard represents x, y coordinate 0, 0 and the bottom right of your keyboard represents 224, 64. Using this as a basis, you can use the following formula to calculate the physical position: | 147 | The first part, `// Key Matrix to LED Index`, tells the system what key this LED represents by using the key's electrical matrix row & col. The second part, `// LED Index to Physical Position` represents the LED's physical `{ x, y }` position on the keyboard. The default expected range of values for `{ x, y }` is the inclusive range `{ 0..224, 0..64 }`. This default expected range is due to effects that calculate the center of the keyboard for their animations. The easiest way to calculate these positions is imagine your keyboard is a grid, and the top left of the keyboard represents `{ x, y }` coordinate `{ 0, 0 }` and the bottom right of your keyboard represents `{ 224, 64 }`. Using this as a basis, you can use the following formula to calculate the physical position: |
| 148 | 148 | ||
| 149 | ```C | 149 | ```C |
| 150 | x = 224 / (NUMBER_OF_COLS - 1) * COL_POSITION | 150 | x = 224 / (NUMBER_OF_COLS - 1) * COL_POSITION |
| 151 | y = 64 / (NUMBER_OF_ROWS - 1) * ROW_POSITION | 151 | y = 64 / (NUMBER_OF_ROWS - 1) * ROW_POSITION |
| 152 | ``` | 152 | ``` |
| 153 | 153 | ||
| 154 | Where NUMBER_OF_COLS, NUMBER_OF_ROWS, COL_POSITION, & ROW_POSITION are all based on the physical layout of your keyboard, not the electrical layout. | 154 | Where NUMBER_OF_COLS, NUMBER_OF_ROWS, COL_POSITION, & ROW_POSITION are all based on the physical layout of your keyboard, not the electrical layout. |
| 155 | |||
| 156 | As mentioned earlier, the center of the keyboard by default is expected to be `{ 112, 32 }`, but this can be changed if you want to more accurately calculate the LED's physical `{ x, y }` positions. Keyboard designers can implement `#define RGB_MATRIX_CENTER { 112, 32 }` in their config.h file with the new center point of the keyboard, or where they want it to be allowing more possibilities for the `{ x, y }` values. Do note that the maximum value for x or y is 255, and the recommended maximum is 224 as this gives animations runoff room before they reset. | ||
| 155 | 157 | ||
| 156 | `// LED Index to Flag` is a bitmask, whether or not a certain LEDs is of a certain type. It is recommended that LEDs are set to only 1 type. | 158 | `// LED Index to Flag` is a bitmask, whether or not a certain LEDs is of a certain type. It is recommended that LEDs are set to only 1 type. |
| 157 | 159 | ||
