「App:Library:LVGL:docs:Overview:Animations」の版間の差分
(→API) |
(→API) |
||
195行目: | 195行目: | ||
|- | |- | ||
| | | | ||
− | + | Typedefs | |
<span style="background-color:#e7f2fa;color:#2980b9;">typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*) </span> | <span style="background-color:#e7f2fa;color:#2980b9;">typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*) </span> | ||
218行目: | 218行目: | ||
: Describes an animation | : Describes an animation | ||
− | + | Enums | |
<span style="background-color:#e7f2fa;color:#2980b9;">enum lv_anim_enable_t </span> | <span style="background-color:#e7f2fa;color:#2980b9;">enum lv_anim_enable_t </span> | ||
229行目: | 229行目: | ||
|- | |- | ||
| | | | ||
− | + | Functions | |
− | |||
244行目: | 243行目: | ||
<span style="background-color:#e7f2fa;color:#2980b9;">void lv_anim_init(lv_anim_t *a) </span> | <span style="background-color:#e7f2fa;color:#2980b9;">void lv_anim_init(lv_anim_t *a) </span> | ||
: Initialize an animation variable. E.g.: lv_anim_t a; lv_anim_init(&a); lv_anim_set_...(&a); lv_anim_start(&a); | : Initialize an animation variable. E.g.: lv_anim_t a; lv_anim_init(&a); lv_anim_set_...(&a); lv_anim_start(&a); | ||
− | : | + | : Parameters |
− | :: | + | :: a -- pointer to an <code style="color: #bb0000;">lv_anim_t</code> variable to initialize |
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_var(lv_anim_t *a, void *var) </span> | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_var(lv_anim_t *a, void *var) </span> | ||
: Set a variable to animate | : Set a variable to animate | ||
− | : | + | : Parameters |
− | ::* | + | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable |
− | ::* | + | ::* var -- pointer to a variable to animate |
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_exec_cb(lv_anim_t *a, lv_anim_exec_xcb_t exec_cb) </span> | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_exec_cb(lv_anim_t *a, lv_anim_exec_xcb_t exec_cb) </span> | ||
: Set a function to animate <code style="color: #bb0000;">var</code> | : Set a function to animate <code style="color: #bb0000;">var</code> | ||
− | : | + | : Parameters |
− | ::* | + | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable |
− | ::* | + | ::* exec_cb -- a function to execute during animation LVGL's built-in functions can be used. E.g. lv_obj_set_x |
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_time(lv_anim_t *a, uint32_t duration) </span> | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_time(lv_anim_t *a, uint32_t duration) </span> | ||
: Set the duration of an animation | : Set the duration of an animation | ||
: Parameters | : Parameters | ||
− | ::* | + | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable |
+ | ::* duration -- duration of the animation in milliseconds | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_delay(lv_anim_t *a, uint32_t delay) </span> | ||
+ | : Set a delay before starting the animation | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* delay -- delay before the animation in milliseconds | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_values(lv_anim_t *a, int32_t start, int32_t end) </span> | ||
+ | : Set the start and end values of an animation | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* start -- the start value | ||
+ | ::* end -- the end value | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_custom_exec_cb(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb) </span> | ||
+ | : Similar to <code style="color: #bb0000;">lv_anim_set_exec_cb</code> but <code style="color: #bb0000;">lv_anim_custom_exec_cb_t</code> receives <code style="color: #bb0000;">lv_anim_t *</code> as its first parameter instead of <code style="color: #bb0000;">void *</code>. This function might be used when LVGL is bound to other languages because it's more consistent to have <code style="color: #bb0000;">lv_anim_t *</code> as first parameter. The variable to animate can be stored in the animation's <code style="color: #bb0000;">user_data</code> | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* exec_cb -- a function to execute. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_path_cb(lv_anim_t *a, lv_anim_path_cb_t path_cb) </span> | ||
+ | : Set the path (curve) of the animation. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* path_cb -- a function to set the current value of the animation. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_start_cb(lv_anim_t *a, lv_anim_start_cb_t start_cb) </span> | ||
+ | : Set a function call when the animation really starts (considering <code style="color: #bb0000;">delay</code>) | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* start_cb -- a function call when the animation starts | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_get_value_cb(lv_anim_t *a, lv_anim_get_value_cb_t get_value_cb) </span> | ||
+ | : Set a function to use the current value of the variable and make start and end value relative to the returned current value. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* get_value_cb -- a function call when the animation starts | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_ready_cb(lv_anim_t *a, lv_anim_ready_cb_t ready_cb) </span> | ||
+ | : Set a function call when the animation is ready | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* ready_cb -- a function call when the animation is ready | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_playback_time(lv_anim_t *a, uint32_t time) </span> | ||
+ | : Make the animation to play back to when the forward direction is ready | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* time -- the duration of the playback animation in milliseconds. 0: disable playback | ||
+ | |||
+ | static inline void lv_anim_set_playback_delay(lv_anim_t *a, uint32_t delay) | ||
+ | : Make the animation to play back to when the forward direction is ready | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* delay -- delay in milliseconds before starting the playback animation. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_repeat_count(lv_anim_t *a, uint16_t cnt) </span> | ||
+ | : Make the animation repeat itself. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* cnt -- repeat count or <code style="color: #bb0000;">LV_ANIM_REPEAT_INFINITE</code> for infinite repetition. 0: to disable repetition. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_repeat_delay(lv_anim_t *a, uint32_t delay) </span> | ||
+ | : Set a delay before repeating the animation. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* delay -- delay in milliseconds before repeating the animation. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_early_apply(lv_anim_t *a, bool en) </span> | ||
+ | : Set a whether the animation's should be applied immediately or only when the delay expired. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* en -- true: apply the start value immediately in <code style="color: #bb0000;">lv_anim_start</code>; false: apply the start value only when <code style="color: #bb0000;">delay</code> ms is elapsed and the animations really starts | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_user_data(lv_anim_t *a, void *user_data) </span> | ||
+ | : Set the custom user data field of the animation. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | ::* user_data -- pointer to the new user_data. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_anim_t *lv_anim_start(const lv_anim_t *a) </span> | ||
+ | : Create an animation | ||
+ | : Parameters | ||
+ | :: a -- an initialized 'anim_t' variable. Not required after call. | ||
+ | : Returns | ||
+ | :: pointer to the created animation (different from the <code style="color: #bb0000;">a</code> parameter) | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline uint32_t lv_anim_get_delay(lv_anim_t *a) </span> | ||
+ | : Get a delay before starting the animation | ||
+ | : Parameters | ||
+ | :: a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | : Returns | ||
+ | :: delay before the animation in milliseconds | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">uint32_t lv_anim_get_playtime(lv_anim_t *a) </span> | ||
+ | : Get the time used to play the animation. | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation. | ||
+ | : Returns | ||
+ | :: the play time in milliseconds. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline void *lv_anim_get_user_data(lv_anim_t *a) </span> | ||
+ | : Get the user_data field of the animation | ||
+ | : Parameters | ||
+ | :: a -- pointer to an initialized <code style="color: #bb0000;">lv_anim_t</code> variable | ||
+ | : Returns | ||
+ | :: the pointer to the custom user_data of the animation | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">bool lv_anim_del(void *var, lv_anim_exec_xcb_t exec_cb) </span> | ||
+ | : Delete an animation of a variable with a given animator function | ||
+ | : Parameters | ||
+ | ::* var -- pointer to variable | ||
+ | ::* exec_cb -- a function pointer which is animating 'var', or NULL to ignore it and delete all the animations of 'var | ||
+ | : Returns | ||
+ | :: true: at least 1 animation is deleted, false: no animation is deleted | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">void lv_anim_del_all(void) </span> | ||
+ | : Delete all the animations | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">lv_anim_t *lv_anim_get(void *var, lv_anim_exec_xcb_t exec_cb) </span> | ||
+ | : Get the animation of a variable and its <code style="color: #bb0000;">exec_cb</code>. | ||
+ | : Parameters | ||
+ | ::* var -- pointer to variable | ||
+ | ::* exec_cb -- a function pointer which is animating 'var', or NULL to return first matching 'var' | ||
+ | : Returns | ||
+ | :: pointer to the animation. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline bool lv_anim_custom_del(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb) </span> | ||
+ | : Delete an animation by getting the animated variable from <code style="color: #bb0000;">a</code>. Only animations with <code style="color: #bb0000;">exec_cb</code> will be deleted. This function exists because it's logical that all anim. functions receives an <code style="color: #bb0000;">lv_anim_t</code> as their first parameter. It's not practical in C but might make the API more consequent and makes easier to generate bindings. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an animation. | ||
+ | ::* exec_cb -- a function pointer which is animating 'var', or NULL to ignore it and delete all the animations of 'var | ||
+ | : Returns | ||
+ | :: true: at least 1 animation is deleted, false: no animation is deleted | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">static inline lv_anim_t *lv_anim_custom_get(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb) </span> | ||
+ | : Get the animation of a variable and its <code style="color: #bb0000;">exec_cb</code>. This function exists because it's logical that all anim. functions receives an <code style="color: #bb0000;">lv_anim_t</code> as their first parameter. It's not practical in C but might make the API more consequent and makes easier to generate bindings. | ||
+ | : Parameters | ||
+ | ::* a -- pointer to an animation. | ||
+ | ::* exec_cb -- a function pointer which is animating 'var', or NULL to return first matching 'var' | ||
+ | : Returns | ||
+ | :: pointer to the animation. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">uint16_t lv_anim_count_running(void) </span> | ||
+ | : Get the number of currently running animations | ||
+ | : Returns | ||
+ | :: the number of running animations | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">uint32_t lv_anim_speed_to_time(uint32_t speed, int32_t start, int32_t end) </span> | ||
+ | : Calculate the time of an animation with a given speed and the start and end values | ||
+ | : Parameters | ||
+ | ::* speed -- speed of animation in unit/sec | ||
+ | ::* start -- start value of the animation | ||
+ | ::* end -- end value of the animation | ||
+ | : Returns | ||
+ | :: the required time [ms] for the animation with the given parameters | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">void lv_anim_refr_now(void) </span> | ||
+ | : Manually refresh the state of the animations. Useful to make the animations running in a blocking process where <code style="color: #bb0000;">lv_timer_handler</code> can't run for a while. Shouldn't be used directly because it is called in <code style="color: #bb0000;">lv_refr_now()</code>. | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_linear(const lv_anim_t *a) </span> | ||
+ | : Calculate the current value of an animation applying linear characteristic | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation | ||
+ | : Returns | ||
+ | :: the current value to set | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_ease_in(const lv_anim_t *a) </span> | ||
+ | : Calculate the current value of an animation slowing down the start phase | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation | ||
+ | : Returns | ||
+ | :: the current value to set | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_ease_out(const lv_anim_t *a) </span> | ||
+ | : Calculate the current value of an animation slowing down the end phase | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation | ||
+ | : Returns | ||
+ | :: the current value to set | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_ease_in_out(const lv_anim_t *a) </span> | ||
+ | : Calculate the current value of an animation applying an "S" characteristic (cosine) | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation | ||
+ | : Returns | ||
+ | :: the current value to set | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_overshoot(const lv_anim_t *a) </span> | ||
+ | : Calculate the current value of an animation with overshoot at the end | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation | ||
+ | : Returns | ||
+ | :: the current value to set | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_bounce(const lv_anim_t *a) </span> | ||
+ | : Calculate the current value of an animation with 3 bounces | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation | ||
+ | : Returns | ||
+ | :: the current value to set | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_step(const lv_anim_t *a) </span> | ||
+ | : Calculate the current value of an animation applying step characteristic. (Set end value on the end of the animation) | ||
+ | : Parameters | ||
+ | :: a -- pointer to an animation | ||
+ | : Returns | ||
+ | :: the current value to set | ||
+ | |||
+ | <span style="background-color:#e7f2fa;color:#2980b9;">struct _lv_anim_t </span> | ||
+ | : ''#include <lv_''''anim.h>'' Describes an animation Public Members | ||
+ | : void *var | ||
+ | :: Variable to animate | ||
+ | : <span style="background-color: #eeeeee;">lv_anim_exec_xcb_t exec_cb </span> | ||
+ | :: Function to execute to animate | ||
+ | : <span style="background-color: #eeeeee;">lv_anim_start_cb_t start_cb </span> | ||
+ | :: Call it when the animation is starts (considering <code style="color: #bb0000;">delay</code>) | ||
+ | : <span style="background-color: #eeeeee;">lv_anim_ready_cb_t ready_cb </span> | ||
+ | :: Call it when the animation is ready | ||
+ | : <span style="background-color: #eeeeee;">lv_anim_get_value_cb_t get_value_cb </span> | ||
+ | :: Get the current value in relative mode | ||
+ | : <span style="background-color: #eeeeee;">void *user_data </span> | ||
+ | :: Custom user data | ||
+ | : <span style="background-color: #eeeeee;">lv_anim_path_cb_t path_cb </span> | ||
+ | :: Describe the path (curve) of animations | ||
+ | : <span style="background-color: #eeeeee;">int32_t start_value </span> | ||
+ | :: Start value | ||
+ | : | ||
+ | : <span style="background-color: #eeeeee;">int32_t current_value </span> | ||
+ | :: Current value | ||
+ | : | ||
+ | : <span style="background-color: #eeeeee;">int32_t end_value </span> | ||
+ | :: End value | ||
+ | : | ||
+ | : <span style="background-color: #eeeeee;">int32_t time </span> | ||
+ | :: Animation time in ms | ||
+ | : <span style="background-color: #eeeeee;">int32_t act_time </span> | ||
+ | :: Current time in animation. Set to negative to make delay. | ||
+ | : <span style="background-color: #eeeeee;">uint32_t playback_delay </span> | ||
+ | :: Wait before play back | ||
+ | : <span style="background-color: #eeeeee;">uint32_t playback_time </span> | ||
+ | :: Duration of playback animation | ||
+ | : <span style="background-color: #eeeeee;">uint32_t repeat_delay </span> | ||
+ | :: Wait before repeat | ||
+ | : <span style="background-color: #eeeeee;">uint16_t repeat_cnt </span> | ||
+ | :: Repeat count for the animation | ||
+ | : <span style="background-color: #eeeeee;">uint8_t early_apply </span> | ||
+ | :: 1: Apply start value immediately even is there is <code style="color: #bb0000;">delay</code> | ||
+ | : <span style="background-color: #eeeeee;">uint8_t playback_now </span> | ||
+ | :: Play back is in progress | ||
+ | : <span style="background-color: #eeeeee;">uint8_t run_round </span> | ||
+ | :: Indicates the animation has run in this round | ||
+ | : <span style="background-color: #eeeeee;">uint8_t start_cb_called </span> | ||
+ | :: Indicates that the <code style="color: #bb0000;">start_cb</code> was already called | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | [[App:Library:LVGL#Overview|戻る : Previous]] | ||
+ | |||
=Animations= | =Animations= | ||
{| class="wikitable" | {| class="wikitable" |
2022年7月2日 (土) 11:10時点における版
https://docs.lvgl.io/8.2/overview/animation.html
Animations
英文 | 自動翻訳 |
---|---|
You can automatically change the value of a variable between a start and an end value using animations. Animation will happen by periodically calling an "animator" function with the corresponding value parameter. The animator functions have the following prototype: void func(void * var, lv_anim_var_t value);
This prototype is compatible with the majority of the property set functions in LVGL. For example |
Create an animation
英文 | 自動翻訳 |
---|---|
To create an animation an /* INITIALIZE AN ANIMATION
*-----------------------*/
lv_anim_t a;
lv_anim_init(&a);
/* MANDATORY SETTINGS
*------------------*/
/*Set the "animator" function*/
lv_anim_set_exec_cb(&a, (lv_anim_exec_xcb_t) lv_obj_set_x);
/*Set target of the animation*/
lv_anim_set_var(&a, obj);
/*Length of the animation [ms]*/
lv_anim_set_time(&a, duration);
/*Set start and end values. E.g. 0, 150*/
lv_anim_set_values(&a, start, end);
/* OPTIONAL SETTINGS
*------------------*/
/*Time to wait before starting the animation [ms]*/
lv_anim_set_delay(&a, delay);
/*Set path (curve). Default is linear*/
lv_anim_set_path(&a, lv_anim_path_ease_in);
/*Set a callback to indicate when the animation is ready (idle).*/
lv_anim_set_ready_cb(&a, ready_cb);
/*Set a callback to indicate when the animation is started (after delay).*/
lv_anim_set_start_cb(&a, start_cb);
/*When ready, play the animation backward with this duration. Default is 0 (disabled) [ms]*/
lv_anim_set_playback_time(&a, time);
/*Delay before playback. Default is 0 (disabled) [ms]*/
lv_anim_set_playback_delay(&a, delay);
/*Number of repetitions. Default is 1. LV_ANIM_REPEAT_INFINITE for infinite repetition*/
lv_anim_set_repeat_count(&a, cnt);
/*Delay before repeat. Default is 0 (disabled) [ms]*/
lv_anim_set_repeat_delay(&a, delay);
/*true (default): apply the start value immediately, false: apply start value after delay when the anim. really starts. */
lv_anim_set_early_apply(&a, true/false);
/* START THE ANIMATION
*------------------*/
lv_anim_start(&a); /*Start the animation*/
You can apply multiple different animations on the same variable at the same time. For example, animate the x and y coordinates with |
Animation path
英文 | 自動翻訳 |
---|---|
You can control the path of an animation. The most simple case is linear, meaning the current value between start and end is changed with fixed steps. A path is a function which calculates the next value to set based on the current state of the animation. Currently, there are the following built-in path functions:
|
Speed vs time
英文 | 自動翻訳 |
---|---|
By default, you set the animation time directly. But in some cases, setting the animation speed is more practical. The |
Delete animations
英文 | 自動翻訳 |
---|---|
You can delete an animation with |
Timeline
Examples
英文 | 自動翻訳 |
---|---|
Start animation on an event |
|
Playback animation |
|
Animation timeline |
API
英文 | 自動翻訳 |
---|---|
Typedefs typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*)
typedef void (*lv_anim_exec_xcb_t)(void*, int32_t)
typedef void (*lv_anim_custom_exec_cb_t)(struct _lv_anim_t*, int32_t)
typedef void (*lv_anim_ready_cb_t)(struct _lv_anim_t*)
typedef void (*lv_anim_start_cb_t)(struct _lv_anim_t*)
typedef int32_t (*lv_anim_get_value_cb_t)(struct _lv_anim_t*)
typedef struct _lv_anim_t lv_anim_t
Enums enum lv_anim_enable_t
|
|
Functions
LV_EXPORT_CONST_INT(LV_ANIM_PLAYTIME_INFINITE) void _lv_anim_core_init(void)
void lv_anim_init(lv_anim_t *a)
static inline void lv_anim_set_var(lv_anim_t *a, void *var)
static inline void lv_anim_set_exec_cb(lv_anim_t *a, lv_anim_exec_xcb_t exec_cb)
static inline void lv_anim_set_time(lv_anim_t *a, uint32_t duration)
static inline void lv_anim_set_delay(lv_anim_t *a, uint32_t delay)
static inline void lv_anim_set_values(lv_anim_t *a, int32_t start, int32_t end)
static inline void lv_anim_set_custom_exec_cb(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
static inline void lv_anim_set_path_cb(lv_anim_t *a, lv_anim_path_cb_t path_cb)
static inline void lv_anim_set_start_cb(lv_anim_t *a, lv_anim_start_cb_t start_cb)
static inline void lv_anim_set_get_value_cb(lv_anim_t *a, lv_anim_get_value_cb_t get_value_cb)
static inline void lv_anim_set_ready_cb(lv_anim_t *a, lv_anim_ready_cb_t ready_cb)
static inline void lv_anim_set_playback_time(lv_anim_t *a, uint32_t time)
static inline void lv_anim_set_playback_delay(lv_anim_t *a, uint32_t delay)
static inline void lv_anim_set_repeat_count(lv_anim_t *a, uint16_t cnt)
static inline void lv_anim_set_repeat_delay(lv_anim_t *a, uint32_t delay)
static inline void lv_anim_set_early_apply(lv_anim_t *a, bool en)
static inline void lv_anim_set_user_data(lv_anim_t *a, void *user_data)
lv_anim_t *lv_anim_start(const lv_anim_t *a)
static inline uint32_t lv_anim_get_delay(lv_anim_t *a)
uint32_t lv_anim_get_playtime(lv_anim_t *a)
static inline void *lv_anim_get_user_data(lv_anim_t *a)
bool lv_anim_del(void *var, lv_anim_exec_xcb_t exec_cb)
void lv_anim_del_all(void)
lv_anim_t *lv_anim_get(void *var, lv_anim_exec_xcb_t exec_cb)
static inline bool lv_anim_custom_del(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
static inline lv_anim_t *lv_anim_custom_get(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
uint16_t lv_anim_count_running(void)
uint32_t lv_anim_speed_to_time(uint32_t speed, int32_t start, int32_t end)
void lv_anim_refr_now(void)
int32_t lv_anim_path_linear(const lv_anim_t *a)
int32_t lv_anim_path_ease_in(const lv_anim_t *a)
int32_t lv_anim_path_ease_out(const lv_anim_t *a)
int32_t lv_anim_path_ease_in_out(const lv_anim_t *a)
int32_t lv_anim_path_overshoot(const lv_anim_t *a)
int32_t lv_anim_path_bounce(const lv_anim_t *a)
int32_t lv_anim_path_step(const lv_anim_t *a)
struct _lv_anim_t
|
Animations
英文 | 自動翻訳 |
---|---|
You can automatically change the value of a variable between a start and an end value using animations. Animation will happen by periodically calling an "animator" function with the corresponding value parameter.
The animator functions have the following prototype: void func(void * var, lv_anim_var_t value);
lv_obj_set_x(obj, value) or lv_obj_set_width(obj, value)
|
Create an animation
英文 | 自動翻訳 |
---|---|
To create an animation an lv_anim_t variable has to be initialized and configured with lv_anim_set_...() functions. /* INITIALIZE AN ANIMATION
*-----------------------*/
lv_anim_t a;
lv_anim_init(&a);
/* MANDATORY SETTINGS
*------------------*/
/*Set the "animator" function*/
lv_anim_set_exec_cb(&a, (lv_anim_exec_xcb_t) lv_obj_set_x);
/*Set target of the animation*/
lv_anim_set_var(&a, obj);
/*Length of the animation [ms]*/
lv_anim_set_time(&a, duration);
/*Set start and end values. E.g. 0, 150*/
lv_anim_set_values(&a, start, end);
/* OPTIONAL SETTINGS
*------------------*/
/*Time to wait before starting the animation [ms]*/
lv_anim_set_delay(&a, delay);
/*Set path (curve). Default is linear*/
lv_anim_set_path(&a, lv_anim_path_ease_in);
/*Set a callback to indicate when the animation is ready (idle).*/
lv_anim_set_ready_cb(&a, ready_cb);
/*Set a callback to indicate when the animation is started (after delay).*/
lv_anim_set_start_cb(&a, start_cb);
/*When ready, play the animation backward with this duration. Default is 0 (disabled) [ms]*/
lv_anim_set_playback_time(&a, time);
/*Delay before playback. Default is 0 (disabled) [ms]*/
lv_anim_set_playback_delay(&a, delay);
/*Number of repetitions. Default is 1. LV_ANIM_REPEAT_INFINITE for infinite repetition*/
lv_anim_set_repeat_count(&a, cnt);
/*Delay before repeat. Default is 0 (disabled) [ms]*/
lv_anim_set_repeat_delay(&a, delay);
/*true (default): apply the start value immediately, false: apply start value after delay when the anim. really starts. */
lv_anim_set_early_apply(&a, true/false);
/* START THE ANIMATION
*------------------*/
lv_anim_start(&a); /*Start the animation*/
lv_obj_set_x and lv_obj_set_y . However, only one animation can exist with a given variable and function pair and lv_anim_start() will remove any existing animations for such a pair.
|
Animation path
英文 | 自動翻訳 |
---|---|
You can control the path of an animation. The most simple case is linear, meaning the current value between start and end is changed with fixed steps. A path is a function which calculates the next value to set based on the current state of the animation. Currently, there are the following built-in path functions:
|
Speed vs time
英文 | 自動翻訳 |
---|---|
By default, you set the animation time directly. But in some cases, setting the animation speed is more practical.
The |
Delete animations
英文 | 自動翻訳 |
---|---|
You can delete an animation with lv_anim_del(var, func) if you provide the animated variable and its animator function.
|
Timeline
Examples
英文 | 自動翻訳 |
---|---|
Start animation on an event |
|
Playback animation |
|
Animation timeline |
API
英文 | 自動翻訳 |
---|---|
Typedefs
typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*)
typedef void (*lv_anim_exec_xcb_t)(void*, int32_t)
typedef void (*lv_anim_custom_exec_cb_t)(struct _lv_anim_t*, int32_t)
typedef void (*lv_anim_ready_cb_t)(struct _lv_anim_t*)
typedef void (*lv_anim_start_cb_t)(struct _lv_anim_t*)
typedef int32_t (*lv_anim_get_value_cb_t)(struct _lv_anim_t*)
typedef struct _lv_anim_t lv_anim_t
Enums enum lv_anim_enable_t
|
|
Functions
LV_EXPORT_CONST_INT(LV_ANIM_REPEAT_INFINITE) LV_EXPORT_CONST_INT(LV_ANIM_PLAYTIME_INFINITE) void _lv_anim_core_init(void)
void lv_anim_init(lv_anim_t *a)
static inline void lv_anim_set_var(lv_anim_t *a, void *var)
static inline void lv_anim_set_exec_cb(lv_anim_t *a, lv_anim_exec_xcb_t exec_cb)
static inline void lv_anim_set_time(lv_anim_t *a, uint32_t duration)
static inline void lv_anim_set_delay(lv_anim_t *a, uint32_t delay)
static inline void lv_anim_set_values(lv_anim_t *a, int32_t start, int32_t end)
static inline void lv_anim_set_custom_exec_cb(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
static inline void lv_anim_set_path_cb(lv_anim_t *a, lv_anim_path_cb_t path_cb)
static inline void lv_anim_set_start_cb(lv_anim_t *a, lv_anim_start_cb_t start_cb)
static inline void lv_anim_set_get_value_cb(lv_anim_t *a, lv_anim_get_value_cb_t get_value_cb)
static inline void lv_anim_set_ready_cb(lv_anim_t *a, lv_anim_ready_cb_t ready_cb)
static inline void lv_anim_set_playback_time(lv_anim_t *a, uint32_t time)
static inline void lv_anim_set_playback_delay(lv_anim_t *a, uint32_t delay)
static inline void lv_anim_set_repeat_count(lv_anim_t *a, uint16_t cnt)
static inline void lv_anim_set_repeat_delay(lv_anim_t *a, uint32_t delay)
static inline void lv_anim_set_early_apply(lv_anim_t *a, bool en)
static inline void lv_anim_set_user_data(lv_anim_t *a, void *user_data)
lv_anim_t *lv_anim_start(const lv_anim_t *a)
static inline uint32_t lv_anim_get_delay(lv_anim_t *a)
uint32_t lv_anim_get_playtime(lv_anim_t *a)
static inline void *lv_anim_get_user_data(lv_anim_t *a)
bool lv_anim_del(void *var, lv_anim_exec_xcb_t exec_cb)
void lv_anim_del_all(void)
lv_anim_t *lv_anim_get(void *var, lv_anim_exec_xcb_t exec_cb)
static inline bool lv_anim_custom_del(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
static inline lv_anim_t *lv_anim_custom_get(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
uint16_t lv_anim_count_running(void)
uint32_t lv_anim_speed_to_time(uint32_t speed, int32_t start, int32_t end)
void lv_anim_refr_now(void)
int32_t lv_anim_path_linear(const lv_anim_t *a)
int32_t lv_anim_path_ease_in(const lv_anim_t *a)
int32_t lv_anim_path_ease_out(const lv_anim_t *a)
int32_t lv_anim_path_ease_in_out(const lv_anim_t *a)
int32_t lv_anim_path_overshoot(const lv_anim_t *a)
int32_t lv_anim_path_bounce(const lv_anim_t *a)
int32_t lv_anim_path_step(const lv_anim_t *a)
struct _lv_anim_t
|
- -- pointer to an initialized
lv_anim_t
variable - duration -- duration of the animation in milliseconds
- -- pointer to an initialized
static inline void lv_anim_set_delay(lv_anim_t *a, uint32_t delay)
- Set a delay before starting the animation
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - delay -- delay before the animation in milliseconds
- a -- pointer to an initialized
static inline void lv_anim_set_values(lv_anim_t *a, int32_t start, int32_t end)
- Set the start and end values of an animation
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - start -- the start value
- end -- the end value
- a -- pointer to an initialized
static inline void lv_anim_set_custom_exec_cb(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
- Similar to
lv_anim_set_exec_cb
butlv_anim_custom_exec_cb_t
receiveslv_anim_t *
as its first parameter instead ofvoid *
. This function might be used when LVGL is bound to other languages because it's more consistent to havelv_anim_t *
as first parameter. The variable to animate can be stored in the animation'suser_data
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - exec_cb -- a function to execute.
- a -- pointer to an initialized
static inline void lv_anim_set_path_cb(lv_anim_t *a, lv_anim_path_cb_t path_cb)
- Set the path (curve) of the animation.
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - path_cb -- a function to set the current value of the animation.
- a -- pointer to an initialized
static inline void lv_anim_set_start_cb(lv_anim_t *a, lv_anim_start_cb_t start_cb)
- Set a function call when the animation really starts (considering
delay
) - Parameters
- a -- pointer to an initialized
lv_anim_t
variable - start_cb -- a function call when the animation starts
- a -- pointer to an initialized
static inline void lv_anim_set_get_value_cb(lv_anim_t *a, lv_anim_get_value_cb_t get_value_cb)
- Set a function to use the current value of the variable and make start and end value relative to the returned current value.
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - get_value_cb -- a function call when the animation starts
- a -- pointer to an initialized
static inline void lv_anim_set_ready_cb(lv_anim_t *a, lv_anim_ready_cb_t ready_cb)
- Set a function call when the animation is ready
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - ready_cb -- a function call when the animation is ready
- a -- pointer to an initialized
static inline void lv_anim_set_playback_time(lv_anim_t *a, uint32_t time)
- Make the animation to play back to when the forward direction is ready
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - time -- the duration of the playback animation in milliseconds. 0: disable playback
- a -- pointer to an initialized
static inline void lv_anim_set_playback_delay(lv_anim_t *a, uint32_t delay)
- Make the animation to play back to when the forward direction is ready
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - delay -- delay in milliseconds before starting the playback animation.
- a -- pointer to an initialized
static inline void lv_anim_set_repeat_count(lv_anim_t *a, uint16_t cnt)
- Make the animation repeat itself.
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - cnt -- repeat count or
LV_ANIM_REPEAT_INFINITE
for infinite repetition. 0: to disable repetition.
- a -- pointer to an initialized
static inline void lv_anim_set_repeat_delay(lv_anim_t *a, uint32_t delay)
- Set a delay before repeating the animation.
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - delay -- delay in milliseconds before repeating the animation.
- a -- pointer to an initialized
static inline void lv_anim_set_early_apply(lv_anim_t *a, bool en)
- Set a whether the animation's should be applied immediately or only when the delay expired.
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - en -- true: apply the start value immediately in
lv_anim_start
; false: apply the start value only whendelay
ms is elapsed and the animations really starts
- a -- pointer to an initialized
static inline void lv_anim_set_user_data(lv_anim_t *a, void *user_data)
- Set the custom user data field of the animation.
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable - user_data -- pointer to the new user_data.
- a -- pointer to an initialized
lv_anim_t *lv_anim_start(const lv_anim_t *a)
- Create an animation
- Parameters
- a -- an initialized 'anim_t' variable. Not required after call.
- Returns
- pointer to the created animation (different from the
a
parameter)
- pointer to the created animation (different from the
static inline uint32_t lv_anim_get_delay(lv_anim_t *a)
- Get a delay before starting the animation
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable
- a -- pointer to an initialized
- Returns
- delay before the animation in milliseconds
uint32_t lv_anim_get_playtime(lv_anim_t *a)
- Get the time used to play the animation.
- Parameters
- a -- pointer to an animation.
- Returns
- the play time in milliseconds.
static inline void *lv_anim_get_user_data(lv_anim_t *a)
- Get the user_data field of the animation
- Parameters
- a -- pointer to an initialized
lv_anim_t
variable
- a -- pointer to an initialized
- Returns
- the pointer to the custom user_data of the animation
bool lv_anim_del(void *var, lv_anim_exec_xcb_t exec_cb)
- Delete an animation of a variable with a given animator function
- Parameters
- var -- pointer to variable
- exec_cb -- a function pointer which is animating 'var', or NULL to ignore it and delete all the animations of 'var
- Returns
- true: at least 1 animation is deleted, false: no animation is deleted
void lv_anim_del_all(void)
- Delete all the animations
lv_anim_t *lv_anim_get(void *var, lv_anim_exec_xcb_t exec_cb)
- Get the animation of a variable and its
exec_cb
. - Parameters
- var -- pointer to variable
- exec_cb -- a function pointer which is animating 'var', or NULL to return first matching 'var'
- Returns
- pointer to the animation.
static inline bool lv_anim_custom_del(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
- Delete an animation by getting the animated variable from
a
. Only animations withexec_cb
will be deleted. This function exists because it's logical that all anim. functions receives anlv_anim_t
as their first parameter. It's not practical in C but might make the API more consequent and makes easier to generate bindings. - Parameters
- a -- pointer to an animation.
- exec_cb -- a function pointer which is animating 'var', or NULL to ignore it and delete all the animations of 'var
- Returns
- true: at least 1 animation is deleted, false: no animation is deleted
static inline lv_anim_t *lv_anim_custom_get(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)
- Get the animation of a variable and its
exec_cb
. This function exists because it's logical that all anim. functions receives anlv_anim_t
as their first parameter. It's not practical in C but might make the API more consequent and makes easier to generate bindings. - Parameters
- a -- pointer to an animation.
- exec_cb -- a function pointer which is animating 'var', or NULL to return first matching 'var'
- Returns
- pointer to the animation.
uint16_t lv_anim_count_running(void)
- Get the number of currently running animations
- Returns
- the number of running animations
uint32_t lv_anim_speed_to_time(uint32_t speed, int32_t start, int32_t end)
- Calculate the time of an animation with a given speed and the start and end values
- Parameters
- speed -- speed of animation in unit/sec
- start -- start value of the animation
- end -- end value of the animation
- Returns
- the required time [ms] for the animation with the given parameters
void lv_anim_refr_now(void)
- Manually refresh the state of the animations. Useful to make the animations running in a blocking process where
lv_timer_handler
can't run for a while. Shouldn't be used directly because it is called inlv_refr_now()
.
int32_t lv_anim_path_linear(const lv_anim_t *a)
- Calculate the current value of an animation applying linear characteristic
- Parameters
- a -- pointer to an animation
- Returns
- the current value to set
int32_t lv_anim_path_ease_in(const lv_anim_t *a)
- Calculate the current value of an animation slowing down the start phase
- Parameters
- a -- pointer to an animation
- Returns
- the current value to set
int32_t lv_anim_path_ease_out(const lv_anim_t *a)
- Calculate the current value of an animation slowing down the end phase
- Parameters
- a -- pointer to an animation
- Returns
- the current value to set
int32_t lv_anim_path_ease_in_out(const lv_anim_t *a)
- Calculate the current value of an animation applying an "S" characteristic (cosine)
- Parameters
- a -- pointer to an animation
- Returns
- the current value to set
int32_t lv_anim_path_overshoot(const lv_anim_t *a)
- Calculate the current value of an animation with overshoot at the end
- Parameters
- a -- pointer to an animation
- Returns
- the current value to set
int32_t lv_anim_path_bounce(const lv_anim_t *a)
- Calculate the current value of an animation with 3 bounces
- Parameters
- a -- pointer to an animation
- Returns
- the current value to set
int32_t lv_anim_path_step(const lv_anim_t *a)
- Calculate the current value of an animation applying step characteristic. (Set end value on the end of the animation)
- Parameters
- a -- pointer to an animation
- Returns
- the current value to set
struct _lv_anim_t
- #include <lv_'anim.h> Describes an animation Public Members
- void *var
- Variable to animate
- lv_anim_exec_xcb_t exec_cb
- Function to execute to animate
- lv_anim_start_cb_t start_cb
- Call it when the animation is starts (considering
delay
)
- Call it when the animation is starts (considering
- lv_anim_ready_cb_t ready_cb
- Call it when the animation is ready
- lv_anim_get_value_cb_t get_value_cb
- Get the current value in relative mode
- void *user_data
- Custom user data
- lv_anim_path_cb_t path_cb
- Describe the path (curve) of animations
- int32_t start_value
- Start value
- int32_t current_value
- Current value
- int32_t end_value
- End value
- int32_t time
- Animation time in ms
- int32_t act_time
- Current time in animation. Set to negative to make delay.
- uint32_t playback_delay
- Wait before play back
- uint32_t playback_time
- Duration of playback animation
- uint32_t repeat_delay
- Wait before repeat
- uint16_t repeat_cnt
- Repeat count for the animation
- uint8_t early_apply
- 1: Apply start value immediately even is there is
delay
- 1: Apply start value immediately even is there is
- uint8_t playback_now
- Play back is in progress
- uint8_t run_round
- Indicates the animation has run in this round
- uint8_t start_cb_called
- Indicates that the
start_cb
was already called
- Indicates that the
| |}