Fix WS2812 effects documentation

This commit is contained in:
Marcel Stör 2018-02-13 12:33:55 +01:00
parent 6027d86ec7
commit 8d2c523aab
2 changed files with 25 additions and 22 deletions

View File

@ -1,10 +1,9 @@
# COLOR_UTILS Module # color utils Module
| Since | Origin / Contributor | Maintainer | Source | | Since | Origin / Contributor | Maintainer | Source |
| :----- | :-------------------- | :---------- | :------ | | :----- | :-------------------- | :---------- | :------ |
| 2017-12-30 | [Konrad Huebner](https://github.com/skycoders) | [Konrad Huebner](https://github.com/skycoders) | [color_utils.c](../../../app/modules/color_utils.c)| | 2017-12-30 | [Konrad Huebner](https://github.com/skycoders) | [Konrad Huebner](https://github.com/skycoders) | [color_utils.c](../../../app/modules/color_utils.c)|
The color_utils module provides some basic color transformations useful for color LEDs. It is used by the WS2812_EFFECTS module. This module provides basic color transformations useful for color LEDs.
## color_utils.hsv2grb() ## color_utils.hsv2grb()
Convert HSV color to GRB color. Convert HSV color to GRB color.
@ -13,9 +12,9 @@ Convert HSV color to GRB color.
`color_utils.hsv2grb(hue, saturation, value)` `color_utils.hsv2grb(hue, saturation, value)`
#### Parameters #### Parameters
- `hue` is the hue value, between 0 and 360. - `hue` is the hue value, between 0 and 360
- `saturation` is the saturation value, between 0 and 255. - `saturation` is the saturation value, between 0 and 255
- `value` is the value value, between 0 and 255. - `value` is the value value, between 0 and 255
#### Returns #### Returns
`green`, `red`, `blue` as values between 0 and 255 `green`, `red`, `blue` as values between 0 and 255
@ -27,9 +26,9 @@ Convert HSV color to GRB color and explicitly return a white value. This can be
`color_utils.hsv2grbw(hue, saturation, value)` `color_utils.hsv2grbw(hue, saturation, value)`
#### Parameters #### Parameters
- `hue` is the hue value, between 0 and 360. - `hue` is the hue value, between 0 and 360
- `saturation` is the saturation value, between 0 and 255. - `saturation` is the saturation value, between 0 and 255
- `value` is the value value, between 0 and 255. - `value` is the value value, between 0 and 255
#### Returns #### Returns
`green`, `red`, `blue`, `white` as values between 0 and 255 `green`, `red`, `blue`, `white` as values between 0 and 255
@ -41,9 +40,9 @@ Convert GRB color to HSV color.
`color_utils.grb2hsv(green, red, blue)` `color_utils.grb2hsv(green, red, blue)`
#### Parameters #### Parameters
- `green` is the green value, between 0 and 255. - `green` is the green value, between 0 and 255
- `red` is the red value, between 0 and 255. - `red` is the red value, between 0 and 255
- `blue` is the blue value, between 0 and 255. - `blue` is the blue value, between 0 and 255
#### Returns #### Returns
`hue`, `saturation`, `value` as values between 0 and 360, respective 0 and 255 `hue`, `saturation`, `value` as values between 0 and 360, respective 0 and 255
@ -58,4 +57,4 @@ The color wheel function makes use of the HSV color space and calculates colors
- `angle` is the angle on the color circle, between 0 and 359 - `angle` is the angle on the color circle, between 0 and 359
#### Returns #### Returns
`green`, `red`, `blue` as values between 0 and 255. `green`, `red`, `blue` as values between 0 and 255

View File

@ -1,11 +1,15 @@
# WS2812_EFFECTS Module # WS2812 effects Module
| Since | Origin / Contributor | Maintainer | Source | | Since | Origin / Contributor | Maintainer | Source |
| :----- | :-------------------- | :---------- | :------ | | :----- | :-------------------- | :---------- | :------ |
| 2017-11-01 | [Konrad Huebner](https://github.com/skycoders) | [ws2812_effects.c](../../../app/modules/ws2812_effects.c)| | 2017-11-01 | [Konrad Huebner](https://github.com/skycoders) | [Konrad Huebner](https://github.com/skycoders) | [ws2812_effects.c](../../../app/modules/ws2812_effects.c)|
The ws2812_effects module provides effects based on the ws2812 library. Some effects are inspired by / based on the [WS2812FX Library](https://github.com/kitesurfer1404/WS2812FX) but have been adopted to the specifics of the ws2812 library. The effects library works based on a buffer created through the ws2812 library and performs the operations on this buffer. This module provides effects based on the [WS2812 library](ws2812.md). Some effects are inspired by / based on the [WS2812FX Library](https://github.com/kitesurfer1404/WS2812FX) but have been adopted to the specifics of the ws2812 library. The effects library works based on a buffer created through the ws2812 library and performs the operations on this buffer.
ATTENTION: Dual mode is currently not supported for effects. Note that dual mode is currently not supported for effects.
!!! caution
This module depends on the [color utils module](color-utils.md). Things **will** fail if that module is missing in the firmware!
#### Example usage #### Example usage
```lua ```lua
@ -60,7 +64,7 @@ Stop the animation effect.
## ws2812_effects.set_brightness() ## ws2812_effects.set_brightness()
Set the brightness Set the brightness.
#### Syntax #### Syntax
`ws2812_effects.set_brightness(brightness)` `ws2812_effects.set_brightness(brightness)`
@ -72,7 +76,7 @@ Set the brightness
`nil` `nil`
## ws2812_effects.set_color() ## ws2812_effects.set_color()
Set the color Set the color.
#### Syntax #### Syntax
`ws2812_effects.set_color(g, r, b, [w])` `ws2812_effects.set_color(g, r, b, [w])`
@ -87,7 +91,7 @@ Set the color
`nil` `nil`
## ws2812_effects.set_speed() ## ws2812_effects.set_speed()
Set the speed Set the speed.
#### Syntax #### Syntax
`ws2812_effects.set_speed(speed)` `ws2812_effects.set_speed(speed)`
@ -100,7 +104,7 @@ Set the speed
## ws2812_effects.get_speed() ## ws2812_effects.get_speed()
Get current speed Get current speed.
#### Syntax #### Syntax
`ws2812_effects.get_speed()` `ws2812_effects.get_speed()`
@ -125,7 +129,7 @@ Set the delay between two effect steps in milliseconds.
`nil` `nil`
## ws2812_effects.get_delay() ## ws2812_effects.get_delay()
Get current delay Get current delay.
#### Syntax #### Syntax
`ws2812_effects.get_delay()` `ws2812_effects.get_delay()`