Makuna/NeoPixelBus
1
0
Fork 1
mirror of https://github.com/Makuna/NeoPixelBus.git synced 2025-08-07 04:44:26 +02:00
Code Issues Packages Projects Releases Wiki Activity

Documented ChangeAnimationDuration() and added styling to make easier to read

Nick Benik
2018-12-21 16:53:05 -05:00
parent 842dd3227e
commit 5f3a08d20b
1 changed files with 16 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
NeoPixelAnimator-object-API.md

@@ -15,31 +15,36 @@ Return true if there is at least one active running animation.
## bool NextAvailableAnimation(uint16_t* indexAvailable, uint16_t indexStart = 0)
Return true if there is an available animation channel, and set the given indexAvailable variable to the channel index.
indexAvailable - a pointer to the variable to return the available channel index
indexStart - the index to start searching at
> * indexAvailable - a pointer to the variable to return the available channel index
> * indexStart - the index to start searching at
## void StartAnimation(uint16_t indexAnimation, uint16_t duration, AnimUpdateCallback animUpdate)
Start an animation at the given index, set the length in time to duration, and provide a update callback that apply the effect.
indexAnimation - the animation channel to use. If there is an active animation on that channel, it will be stopped first and then the channel will be reused.
duration - the length of time the animation will run. The scale is based on the flags passed to the constructor of this manager class.
animUpdate - the callback function that will be called for every passage of time.
> * indexAnimation - the animation channel to use. If there is an active animation on that channel, it will be stopped first and then the channel will be reused.
> * duration - the length of time the animation will run. The scale is based on the flags passed to the constructor of this manager class.
> * animUpdate - the callback function that will be called for every passage of time.
## void StopAnimation(uint16_t indexAnimation)
Stop the animation on the given channel.
indexAnimation - the animation channel to stop.
> * indexAnimation - the animation channel to stop.
## void RestartAnimation(uint16_t indexAnimation)
Without changing any of the parameters of the animation, restart the animation. If the animation was running it will jump to the beginning and then progress from the start.
This provides an easy way to loop an animation if needed.
indexAnimation - the animation channel to restart.
> * indexAnimation - the animation channel to restart.
## bool IsAnimationActive(uint16_t indexAnimation)
Return true if the specified animation channel is running.
indexAnimation - the animation channel to check
> * indexAnimation - the animation channel to check
## uint16_t AnimationDuration(uint16_t indexAnimation)
Return the duration of the specified animation channel. The time is based on the flags passed to the constructor of this manager class.
indexAnimation - the animation channel to retrieve from.
> * indexAnimation - the animation channel to retrieve from.
## void ChangeAnimationDuration(uint16_t indexAnimation, uint16_t newDuration);
Called to change the duration that a single animation takes to execute. If the animation was running it will NOT jump to the beginning.
> * indexAnimation - the animation channel to retrieve from.
> * newDuration - the length of time the animation will run. The scale is based on the flags passed to the constructor of this manager class.
## void UpdateAnimations()
Called to allow the animations to progress in time. This must be called periodically in the Loop(). Best if called at least once every 10ms but can be called as fast as the loop() runs.
@@ -57,7 +62,8 @@ Return if the animations are paused. The Pause() method is called to pause and
Return the current time scale.
## void setTimeScale(uint16_t timeScale)
Set the current time scale. All currently running animations will be effected by this change, either slowing them down or speeding them up.
Set the current time scale. All currently running animations will be effected by this change, either slowing them down or speeding them up.
> * timeScale - See values explained in the constructor
# Structs
## AnimationParam