「App:Library:LVGL:docs:Overview:Animations」の版間の差分

提供: robot-jp wiki
ナビゲーションに移動検索に移動
 
(同じ利用者による、間の26版が非表示)
1行目: 1行目:
−
https://docs.lvgl.io/8.2/overview/style.html
+
https://docs.lvgl.io/8.2/overview/animation.html
 
__NOTOC__
 
__NOTOC__
 +
= Animations =
 
{| class="wikitable"
 
{| class="wikitable"
 
!英文
 
!英文
6行目: 7行目:
 
|-
 
|-
 
|
 
|
−
|
 
−
|}
 
−
 
−
= 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.
 
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:
 
The ''animator'' functions have the following prototype:
 +
<syntaxhighlight lang="C++" style="border:1px dashed gray;">
 +
void func(void * var, lv_anim_var_t value);
 +
</syntaxhighlight>
 +
This prototype is compatible with the majority of the property ''set'' functions in LVGL. For example <code style="color: #bb0000;">lv_obj_set_x(obj, value)</code> or <code style="color: #bb0000;">lv_obj_set_width(obj, value)</code>
 +
|アニメーションを使用すると、変数の値を開始値と終了値の間で自動的に変更できます。アニメーションは、対応する値パラメーターを使用して"animator"関数を定期的に呼び出すことによって発生します。
 +
 +
アニメータ関数のプロトタイプは次のとおりです。<syntaxhighlight lang="C++" style="border:1px dashed gray;">
 
  void func(void * var, lv_anim_var_t value);
 
  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 <code>lv_obj_set_x(obj, value)</code> or <code>lv_obj_set_width(obj, value)</code>
+
</syntaxhighlight>
 +
このプロトタイプはLVGLの大部分のプロパティセット関数と互換性がある。例：<code style="color: #bb0000;">lv_obj_set_x(obj, value)</code> or <code style="color: #bb0000;">lv_obj_set_width(obj, value)</code>
 +
|}
 +
:[[App:Library:LVGL:docs:Overview#Animations|戻る : Previous]]
 +
 
  
 
== Create an animation ==
 
== Create an animation ==
−
To create an animation an <code>lv_anim_t</code> variable has to be initialized and configured with <code>lv_anim_set_...()</code> functions.
+
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
To create an animation an <code style="color: #bb0000;">lv_anim_t</code> variable has to be initialized and configured with <code style="color: #bb0000;">lv_anim_set_...()</code> functions.
 +
<syntaxhighlight lang="C++" style="border:1px dashed gray;">
 +
/* 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*/
 +
</syntaxhighlight>
 +
You can apply multiple different animations on the same variable at the same time.
 +
 +
For example, animate the x and y coordinates with <code style="color: #bb0000;">lv_obj_set_x</code> and <code style="color: #bb0000;">lv_obj_set_y</code>.
 +
 +
However, only one animation can exist with a given variable and function pair and <code style="color: #bb0000;">lv_anim_start()</code> will remove any existing animations for such a pair.
 +
|アニメーションを作成するには、<code style="color: #bb0000;">lv_anim_t</code> 変数を初期化し、<code style="color: #bb0000;">lv_anim_set_...()</code> 関数で設定する必要があります。
 +
<syntaxhighlight lang="C++" style="border:1px dashed gray;">
 
  /* INITIALIZE AN ANIMATION
 
  /* INITIALIZE AN ANIMATION
 
   *-----------------------*/
 
   *-----------------------*/
73行目: 148行目:
 
   *------------------*/
 
   *------------------*/
 
  lv_anim_start(&a);                            /*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 <code>lv_obj_set_x</code> and <code>lv_obj_set_y</code>. However, only one animation can exist with a given variable and function pair and <code>lv_anim_start()</code> will remove any existing animations for such a pair.
+
</syntaxhighlight>
 +
同じ変数に複数の異なるアニメーションを同時に適用できます。
 +
 
 +
たとえば、<code style="color: #bb0000;">lv_obj_set_x</code>と<code style="color: #bb0000;">lv_obj_set_y</code>を使用してx座標とy座標をアニメーション化します。
 +
 
 +
しかし、指定した変数と関数のペアを持つアニメーションは1つしか存在できず、<code style="color: #bb0000;">lv_anim_start()</code> はそのようなペアを持つ既存のアニメーションを削除します。
 +
|}
 +
:[[App:Library:LVGL:docs:Overview#Animations|戻る : Previous]]
 +
 
  
 
== Animation path ==
 
== 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:
+
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
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:
 +
 
 +
* <code style="color: #bb0000;">lv_anim_path_linear</code> linear animation
 +
* <code style="color: #bb0000;">lv_anim_path_step</code> change in one step at the end
 +
* <code style="color: #bb0000;">lv_anim_path_ease_in</code> slow at the beginning
 +
* <code style="color: #bb0000;">lv_anim_path_ease_out</code> slow at the end
 +
* <code style="color: #bb0000;">lv_anim_path_ease_in_out</code> slow at the beginning and end
 +
* <code style="color: #bb0000;">lv_anim_path_overshoot</code> overshoot the end value
 +
* <code style="color: #bb0000;">lv_anim_path_bounce</code> bounce back a little from the end value (like hitting a wall)
 +
|アニメーションのパスを制御できます。最も単純なケースはリニアで、開始から終了までのカレント値が固定ステップで変更されることを意味します。
 +
 
 +
パスは、アニメーションの現在の状態に基づいて設定する次の値を計算する関数です。
 +
 
 +
現在、以下の組み込みパス関数があります。
 +
*<code style="color: #bb0000;">lv_anim_path_linear</code> リニアアニメーション
 +
*<code style="color: #bb0000;">lv_anim_path_step</code> 最後の1ステップでの変更
 +
*<code style="color: #bb0000;">lv_anim_path_ease_in</code> 最初は遅い
 +
*<code style="color: #bb0000;">lv_anim_path_ease_out</code> 終了時に遅い
 +
*<code style="color: #bb0000;">lv_anim_path_ease_in_out</code> 開始と終了が遅い
 +
*<code style="color: #bb0000;">lv_anim_path_overshoot</code> オーバーシュート終了値
 +
*<code style="color: #bb0000;">lv_anim_path_bounce</code>終了値から少し跳ね返る (壁にぶつかるなど)
 +
|}
 +
:[[App:Library:LVGL:docs:Overview#Animations|戻る : Previous]]
  
−
* <code>lv_anim_path_linear</code> linear animation
 
−
* <code>lv_anim_path_step</code> change in one step at the end
 
−
* <code>lv_anim_path_ease_in</code> slow at the beginning
 
−
* <code>lv_anim_path_ease_out</code> slow at the end
 
−
* <code>lv_anim_path_ease_in_out</code> slow at the beginning and end
 
−
* <code>lv_anim_path_overshoot</code> overshoot the end value
 
−
* <code>lv_anim_path_bounce</code> bounce back a little from the end value (like hitting a wall)
 
  
 
== Speed vs time ==
 
== Speed vs time ==
−
By default, you set the animation time directly. But in some cases, setting the animation speed is more practical.
+
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
By default, you set the animation time directly.  
 +
 
 +
But in some cases, setting the animation speed is more practical.
 +
 
 +
The <code style="color: #bb0000;">lv_anim_speed_to_time(speed, start, end)</code> function calculates the required time in milliseconds to reach the end value from a start value with the given speed.
 +
 
 +
The speed is interpreted in ''unit/sec'' dimension.
 +
 
 +
For example, <code style="color: #bb0000;">lv_anim_speed_to_time(20,0,100)</code> will yield 5000 milliseconds. For example, in the case of <code style="color: #bb0000;">lv_obj_set_x</code> ''unit'' is pixels so ''20'' means ''20 px/sec'' speed.
 +
|デフォルトでは、アニメーションの時間を直接設定します。
 +
 
 +
しかし、場合によっては、アニメーションの速度を設定する方が実用的です。
 +
 
 +
<code style="color: #bb0000;">lv_anim_speed_to_time(speed, start, end)</code>関数は、与えられた速度で開始値から終了値に到達するまでの所要時間をミリ秒単位で計算します。
 +
 
 +
速度は、単位/秒の次元で解釈されます。
 +
 
 +
例えば、<code style="color: #bb0000;">lv_anim_speed_to_time(20,0,100)</code>の場合、5000ミリ秒になります。例えば、<code style="color: #bb0000;">lv_obj_set_x</code>の場合、単位はピクセルなので、20は20px/secの速度を意味します。
 +
|}
 +
:[[App:Library:LVGL:docs:Overview#Animations|戻る : Previous]]
  
−
The <code>lv_anim_speed_to_time(speed, start, end)</code> function calculates the required time in milliseconds to reach the end value from a start value with the given speed. The speed is interpreted in ''unit/sec'' dimension. For example, <code>lv_anim_speed_to_time(20,0,100)</code> will yield 5000 milliseconds. For example, in the case of <code>lv_obj_set_x</code> ''unit'' is pixels so ''20'' means ''20 px/sec'' speed.
 
  
 
== Delete animations ==
 
== Delete animations ==
−
You can delete an animation with <code>lv_anim_del(var, func)</code> if you provide the animated variable and its animator function.
+
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
You can delete an animation with <code style="color: #bb0000;">lv_anim_del(var, func)</code> if you provide the animated variable and its animator function.
 +
|アニメーション変数とそのアニメーター関数を指定すれば、<code style="color: #bb0000;">lv_anim_del(var, func)</code>でアニメーションを削除することができます。
 +
|}
 +
:[[App:Library:LVGL:docs:Overview#Animations|戻る : Previous]]
 +
 
  
 
== Timeline ==
 
== Timeline ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 
A timeline is a collection of multiple animations which makes it easy to create complex composite animations.
 
A timeline is a collection of multiple animations which makes it easy to create complex composite animations.
  
−
Firstly, create an animation element but don’t call <code>lv_anim_start()</code>.
+
Firstly, create an animation element but don’t call <code style="color: #bb0000;">lv_anim_start()</code>.
 +
 
 +
Secondly, create an animation timeline object by calling <code style="color: #bb0000;">lv_anim_timeline_create()</code>.
 +
 
 +
 
 +
Thirdly, add animation elements to the animation timeline by calling <code style="color: #bb0000;">lv_anim_timeline_add(at, start_time, &a)</code>.
 +
 
 +
<code style="color: #bb0000;">start_time</code> is the start time of the animation on the timeline. Note that <code style="color: #bb0000;">start_time</code> will override the value of <code style="color: #bb0000;">delay</code>.
 +
 
 +
Finally, call <code style="color: #bb0000;">lv_anim_timeline_start(at)</code> to start the animation timeline.
 +
 
 +
It supports forward and backward playback of the entire animation group, using <code style="color: #bb0000;">lv_anim_timeline_set_reverse(at, reverse)</code>.
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_stop(at)</code> to stop the animation timeline.
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_set_progress(at, progress)</code> function to set the state of the object corresponding to the progress of the timeline.
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_get_playtime(at)</code> function to get the total duration of the entire animation timeline.
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_get_reverse(at)</code> function to get whether to reverse the animation timeline.
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_del(at)</code> function to delete the animation timeline.
 +
[[file:LVGL docs overview animation 01.png|400px|link=https://docs.lvgl.io/8.2/overview/animation.html#timeline]]
 +
|タイムラインは複数のアニメーションの集合体なので、複雑な複合アニメーションを簡単に作成することができます。
 +
 
 +
まず、アニメーション要素を作成しますが、<code style="color: #bb0000;">lv_anim_start()</code>は呼び出さないでください。
 +
 
 +
次に、<code style="color: #bb0000;">lv_anim_timeline_create()</code>を呼び出して、アニメーションのタイムラインオブジェクトを作成します。
 +
 
 +
 
 +
3番目に、<code style="color: #bb0000;">lv_anim_timeline_add(at, start_time, &a)</code>を呼び出して、アニメーション要素をアニメーションタイムラインに追加してください。
 +
 
 +
<code style="color: #bb0000;">start_time</code> はタイムライン上のアニメーションの開始時間です。
 +
 
 +
<code style="color: #bb0000;">start_time</code> はdelayの値を上書きすることに注意してください。
 +
 
 +
 
 +
最後に、<code style="color: #bb0000;">lv_anim_timeline_start(at)</code>を呼び出し、アニメーションのタイムラインを開始します。
 +
 
 +
 
 +
<code style="color: #bb0000;">lv_anim_timeline_set_reverse(at, reverse)</code>を使って、アニメーショングループ全体の順方向と逆方向の再生に対応しています。
 +
 
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_stop(at)</code> to タイムラインを停止させる。
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_set_progress(at, progress)</code> function to タイムラインの進行状況に対応するオブジェクトの状態を設定します。
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_get_playtime(at)</code> function to アニメーションのタイムライン全体の継続時間を取得します。
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_get_reverse(at)</code> function to アニメーションのタイムラインを反転させるかどうかを取得します。
 +
 
 +
Call <code style="color: #bb0000;">lv_anim_timeline_del(at)</code> function to アニメーションタイムラインを削除してください。[[file:LVGL docs overview animation 01.png|400px|link=https://docs.lvgl.io/8.2/overview/animation.html#timeline]]
 +
|}
 +
:[[App:Library:LVGL:docs:Overview#Animations|戻る : Previous]]
 +
 
 +
== Examples ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|
 +
=== Start animation on an event ===
 +
[[file:LVGL docs example 018.png|link=https://docs.lvgl.io/8.2/overview/animation.html#start-animation-on-an-event]]
 +
|
 +
|-
 +
|
 +
=== Playback animation ===
 +
[[file:LVGL docs example 019.png|link=https://docs.lvgl.io/8.2/overview/animation.html#playback-animation]]
 +
|
 +
|-
 +
|
 +
=== Animation timeline ===
 +
[[file:LVGL docs example 020.png|link=https://docs.lvgl.io/8.2/overview/animation.html#animation-timeline]]
 +
|
 +
|}
 +
:[[App:Library:LVGL:docs:Overview#Animations|戻る : Previous]]
 +
 
 +
 
 +
== API ==
 +
{| class="wikitable"
 +
!英文
 +
!自動翻訳
 +
|-
 +
|'''Typedefs'''
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*) </span>
 +
: Get the current value during an animation
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_exec_xcb_t)(void*, int32_t) </span>
 +
: Generic prototype of "animator" functions. First parameter is the variable to animate. Second parameter is the value to set. Compatible with <code style="color: #bb0000;">lv_xxx_set_yyy(obj, value)</code> functions The <code style="color: #bb0000;">x</code> in <code style="color: #bb0000;">_xcb_t</code> means it's not a fully generic prototype because it doesn't receive <code style="color: #bb0000;">lv_anim_t *</code> as its first argument
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_custom_exec_cb_t)(struct _lv_anim_t*, int32_t) </span>
 +
: Same as <code style="color: #bb0000;">lv_anim_exec_xcb_t</code> but receives <code style="color: #bb0000;">lv_anim_t *</code> as the first parameter. It's more consistent but less convenient. Might be used by binding generator functions.
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_ready_cb_t)(struct _lv_anim_t*) </span>
 +
: Callback to call when the animation is ready
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_start_cb_t)(struct _lv_anim_t*) </span>
 +
: Callback to call when the animation really stars (considering <code style="color: #bb0000;">delay</code>)
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">typedef int32_t (*lv_anim_get_value_cb_t)(struct _lv_anim_t*) </span>
 +
: Callback used when the animation values are relative to get the current value
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">typedef struct _lv_anim_t lv_anim_t </span>
 +
: Describes an animation
 +
 
 +
'''Enums'''
 +
 
 +
<span style="background-color:#e7f2fa;color:#2980b9;">enum lv_anim_enable_t </span>
 +
: Can be used to indicate if animations are enabled or disabled in a case  ''Values:''
 +
: <span style="background-color: #eeeeee;">enumerator LV_ANIM_OFF </span>
 +
::
 +
: <span style="background-color: #eeeeee;">enumerator LV_ANIM_ON </span>
 +
::
 +
 
 +
|'''Typedefs'''
  
−
Secondly, create an animation timeline object by calling <code>lv_anim_timeline_create()</code>.
+
<span style="background-color:#e7f2fa;color:#2980b9;">typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*) </span>
 +
: アニメーション中の現在値を取得する
  
−
Thirdly, add animation elements to the animation timeline by calling <code>lv_anim_timeline_add(at, start_time, &a)</code>. <code>start_time</code> is the start time of the animation on the timeline. Note that <code>start_time</code> will override the value of <code>delay</code>.
+
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_exec_xcb_t)(void*, int32_t) </span>
 +
: animator "関数の一般的なプロトタイプ。第1パラメータはアニメートする変数。 第2パラメータは設定する値。<code style="color: #bb0000;">lv_xxx_set_yyy(obj, value)</code>関数と互換性がある。  <code style="color: #bb0000;">_xcb_t</code> の <code style="color: #bb0000;">x</code> は、第一引数に <code style="color: #bb0000;">lv_anim_t *</code> を受け取らないので、完全な汎用プロトタイプでないことを意味します。
  
−
Finally, call <code>lv_anim_timeline_start(at)</code> to start the animation timeline.
+
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_custom_exec_cb_t)(struct _lv_anim_t*, int32_t) </span>
 +
:<code style="color: #bb0000;">lv_anim_exec_xcb_t</code> と同じですが、最初のパラメータとして<code style="color: #bb0000;">lv_anim_t *</code>を受け取ります。
 +
: より一貫性がありますが、便利ではありません。
 +
: バインドジェネレータ関数で使用されるかもしれません。
  
−
It supports forward and backward playback of the entire animation group, using <code>lv_anim_timeline_set_reverse(at, reverse)</code>.
+
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_ready_cb_t)(struct _lv_anim_t*) </span>
 +
: アニメーションの準備ができたときに呼び出されるコールバック
  
−
Call <code>lv_anim_timeline_stop(at)</code> to stop the animation timeline.
+
<span style="background-color:#e7f2fa;color:#2980b9;">typedef void (*lv_anim_start_cb_t)(struct _lv_anim_t*) </span>
 +
: アニメーションが本当に始まるときに呼び出されるコールバック（<code style="color: #bb0000;">delay</code>を考慮したもの）
  
−
Call <code>lv_anim_timeline_set_progress(at, progress)</code> function to set the state of the object corresponding to the progress of the timeline.
+
<span style="background-color:#e7f2fa;color:#2980b9;">typedef int32_t (*lv_anim_get_value_cb_t)(struct _lv_anim_t*) </span>
 +
: アニメーションの値が相対的であるときに使用されるコールバックは、現在の値を取得します。
  
−
Call <code>lv_anim_timeline_get_playtime(at)</code> function to get the total duration of the entire animation timeline.
+
<span style="background-color:#e7f2fa;color:#2980b9;">typedef struct _lv_anim_t lv_anim_t </span>
 +
: アニメーションを描写する
 +
:
  
−
Call <code>lv_anim_timeline_get_reverse(at)</code> function to get whether to reverse the animation timeline.
+
'''Enums'''
  
−
Call <code>lv_anim_timeline_del(at)</code> function to delete the animation timeline.
+
<span style="background-color:#e7f2fa;color:#2980b9;">enum lv_anim_enable_t </span>
−
[[file:LVGL docs overview animation 01.png|link=https://docs.lvgl.io/8.2/overview/animation.html#timeline]]
+
: ケース値において、アニメーションの有効・無効を示すことができる。
 +
:<span style="background-color: #eeeeee;">enumerator LV_ANIM_OFF </span>
 +
::
 +
:<span style="background-color: #eeeeee;">enumerator LV_ANIM_ON </span>
 +
::
 +
|-
 +
|
 +
'''Functions'''
  
  
  
 +
<span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_ANIM_REPEAT_INFINITE) </span>
 +
:
  
 +
<span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_ANIM_PLAYTIME_INFINITE) </span>
 +
:
  
 +
<span style="background-color:#e7f2fa;color:#2980b9;">void _lv_anim_core_init(void) </span>
 +
: Init. the animation module
  
 +
<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);
 +
: '''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>
 +
: 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>
 +
: 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>
 +
: Set the duration of an animation
 +
: '''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
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_playback_delay(lv_anim_t *a, uint32_t delay)</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
 +
::* '''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
 +
|'''Functions'''
 +
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_ANIM_REPEAT_INFINITE) </span>
 +
:
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">LV_EXPORT_CONST_INT(LV_ANIM_PLAYTIME_INFINITE) </span>
 +
:
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">void _lv_anim_core_init(void) </span>
 +
: アニメーションモジュールの初期化
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">void lv_anim_init(lv_anim_t *a) </span>
 +
: アニメーション変数を初期化する。例: lv_anim_t a; lv_anim_init(&a); lv_anim_set_...(&a); lv_anim_start(&a);
 +
: '''Parameters'''
 +
::'''a''' -- 初期化する <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタを指定します。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_var(lv_anim_t *a, void *var) </span>
 +
: アニメーションを行う変数を設定する
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code>  変数へのポインタ。
 +
::* '''var''' -- アニメーションを行う変数へのポインタ
 +
 +
<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>
 +
: アニメーション<code style="color: #bb0000;">var</code>を行う関数を設定する
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
::*'''exec_cb''' -- アニメーション中に実行する関数 LVGL の組み込み関数を使用することができます．例：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>
 +
: アニメーションのデュレーションを設定する
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code>  変数へのポインタ。
 +
::* '''duration''' -- アニメーションの継続時間（単位：ミリ秒
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_delay(lv_anim_t *a, uint32_t delay) </span>
 +
: アニメーションを開始するまでの遅延時間を設定する
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
::* '''delay''' -- アニメーションの前の遅延時間（ミリ秒単位)
 +
 +
<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>
 +
: アニメーションの開始値と終了値を設定する
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code>変数へのポインタ。
 +
::* '''start''' -- 開始値
 +
::* '''end''' --終わり値
 +
 +
<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>
 +
:<code style="color: #bb0000;">lv_anim_set_exec_cb</code>と似ていますが、 <code style="color: #bb0000;">lv_anim_custom_exec_cb_t</code> は <code style="color: #bb0000;">void *</code> の代わりに<code style="color: #bb0000;">lv_anim_t *</code>を最初の引数として受け取ります。
 +
: この関数は、LVGLが他の言語にバインドされている場合に使用できます。これは、最初のパラメーターとして<code style="color: #bb0000;">lv_anim_t *</code>を使用する方が一貫性があるためです。
 +
: アニメーションさせる変数は，アニメーションの<code style="color: #bb0000;">user_data</code>に格納することができます．
 +
:
 +
:'''Parameters'''
 +
::*'''a''' -- 初期化された<code style="color: #bb0000;">lv_anim_t</code>変数へのポインタ
 +
::*'''exec_cb''' -- 実行する関数。
 +
 +
<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>
 +
: アニメーションのパス (カーブ) を設定します。
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された<code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ
 +
::* '''path_cb''' -- アニメーションの現在の値を設定する関数。
 +
 +
<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>
 +
: アニメーションが実際に開始するときに関数呼び出しを設定する (<code style="color: #bb0000;">delay</code>を考慮)
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された<code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ
 +
::* '''start_cb''' -- アニメーション開始時の関数呼び出し
 +
 +
<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>
 +
: 変数の現在の値を使用し、戻り値に相対的な開始値と終了値を作成する関数を設定します。
 +
:
 +
:'''Parameters'''
 +
::*'''a''' -- 初期化された<code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ
 +
::*'''get_value_cb''' -- アニメーション開始時の関数呼び出し
 +
 +
<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>
 +
: アニメーションの準備ができたときに関数呼び出しを設定する
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された<code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ
 +
::* '''ready_cb''' -- アニメーションの準備ができたときの関数呼び出し
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_playback_time(lv_anim_t *a, uint32_t time) </span>
 +
: 順方向の準備ができたらアニメーションを再生する
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された<code style="color: #bb0000;">lv_anim_t</code>変数へのポインタ
 +
::* '''time''' -- 再生アニメーションの継続時間 (ミリ秒単位) 。0:再生を無効にします。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_playback_delay(lv_anim_t *a, uint32_t delay) </span>
 +
: 順方向の準備ができたときに再生するアニメーションを作る
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
::* '''delay''' -- 再生アニメーションを開始するまでの遅延時間をミリ秒単位で指定します。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_repeat_count(lv_anim_t *a, uint16_t cnt) </span>
 +
: アニメーションを繰り返すようにする。
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
::* '''cnt''' -- 繰り返し回数，または<code style="color: #bb0000;">LV_ANIM_REPEAT_INFINITE</code> で無限回数を指定する。0：繰り返しを無効とする。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_repeat_delay(lv_anim_t *a, uint32_t delay) </span>
 +
: アニメーションを繰り返すまでの遅延時間を設定します。
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
::* '''delay''' -- アニメーションを繰り返す前に、ミリ秒単位で遅延させます。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_early_apply(lv_anim_t *a, bool en) </span>
 +
: アニメーションを即座に適用するか、遅延時間が終了してから適用するかを設定します。
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
::* '''en''' -- true: <code style="color: #bb0000;">lv_anim_start</code>ですぐに開始値を適用、false: <code style="color: #bb0000;">delay</code> ms が経過し、本当にアニメーションが開始されたときにのみ開始値を適用。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void lv_anim_set_user_data(lv_anim_t *a, void *user_data) </span>
 +
: アニメーションのカスタムユーザーデータフィールドを設定します。
 +
: '''Parameters'''
 +
::*'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
::* '''user_data''' -- 新しい user_data へのポインタを指定します。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">lv_anim_t *lv_anim_start(const lv_anim_t *a) </span>
 +
: アニメーションを作成する
 +
: '''Parameters'''
 +
::'''a''' -- 初期化された 'anim_t' 変数。呼び出し後は必要ない。
 +
: '''Returns'''
 +
:: 作成されたアニメーションへのポインタ（a パラメータとは異なります）。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline uint32_t lv_anim_get_delay(lv_anim_t *a) </span>
 +
: アニメーションを開始する前にディレイを取得する
 +
: '''Parameters'''
 +
::'''a''' -- 初期化された <code style="color: #bb0000;">lv_anim_t</code> 変数へのポインタ。
 +
: '''Returns'''
 +
:: アニメーションの前の遅延時間（ミリ秒単位)
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">uint32_t lv_anim_get_playtime(lv_anim_t *a) </span>
 +
: アニメーションの再生に使用した時間を取得します。
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションへのポインタを指定します。
 +
: '''Returns'''
 +
:: 再生時間をミリ秒単位で指定します。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">static inline void *lv_anim_get_user_data(lv_anim_t *a) </span>
 +
: アニメーションのuser_dataフィールドを取得します。
 +
: '''Parameters'''
 +
::'''a''' -- 初期化された lv_anim_t 変数へのポインタを指定します。
 +
: '''Returns'''
 +
:: アニメーションのカスタム user_data へのポインタ。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">bool lv_anim_del(void *var, lv_anim_exec_xcb_t exec_cb) </span>
 +
: アニメーター関数で指定された変数のアニメーションを削除する
 +
: '''Parameters'''
 +
::*'''var''' -- 変数へのポインタ
 +
::* '''exec_cb''' -- var' をアニメーション化する関数ポインタを指定するか、 それを無視して 'var' のアニメーションをすべて削除するには NULL を指定します。
 +
: '''Returns'''
 +
:: true: 少なくとも1つのアニメーションが削除される,
 +
:: false: アニメーションが削除されない
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">void lv_anim_del_all(void) </span>
 +
: アニメーションをすべて削除する
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">lv_anim_t *lv_anim_get(void *var, lv_anim_exec_xcb_t exec_cb) </span>
 +
: 変数とその<code style="color: #bb0000;">exec_cb</code>のアニメーションを取得します。
 +
: '''Parameters'''
 +
::*'''var''' --変数へのポインタ
 +
::* '''exec_cb''' -- var' をアニメーション化する関数へのポインタ、 または最初にマッチした 'var' を返す場合は NULL を指定します。
 +
: '''Returns'''
 +
:: アニメーションへのポインタを指定します。
 +
 +
<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>
 +
:<code style="color: #bb0000;">a</code>から animated 変数を取得し、アニメーションを削除します。 <code style="color: #bb0000;">exec_cb</code> を持つアニメーションだけが削除されます。  この関数が存在するのは、すべての anim. 関数はその最初のパラメータとして <code style="color: #bb0000;">lv_anim_t</code> を受け取ります。  C では実用的ではありませんが、API をより合理的にし、バインディングの生成を容易にするためです。
 +
: '''Parameters'''
 +
::*'''a''' -- アニメーションへのポインタを指定します。
 +
::* '''exec_cb''' -- var' をアニメーション化する関数ポインタを指定するか、 それを無視して 'var' のアニメーションをすべて削除するには NULL を指定します。
 +
: '''Returns'''
 +
:: true: 少なくとも1つのアニメーションが削除される,
 +
:: false: アニメーションが削除されない
 +
 +
<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>
 +
: 変数とその <code style="color: #bb0000;">exec_cb</code>のアニメーションを取得します。この関数が存在するのは、すべての anim 関数がその最初のパラメータとして <code style="color: #bb0000;">lv_anim_t</code>を受け取ることが論理的であるからです。C では実用的ではありませんが、API をより効果的にし、バインディングの生成を容易にするためです。
 +
: '''Parameters'''
 +
::*'''a''' -- アニメーションへのポインタを指定します。
 +
::* '''exec_cb''' -- var' をアニメーション化する関数へのポインタ、 または最初にマッチした 'var' を返す場合は NULL を指定します。
 +
: '''Returns'''
 +
:: アニメーションへのポインタを指定します。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">uint16_t lv_anim_count_running(void) </span>
 +
: 現在実行中のアニメーションの数を取得する
 +
: '''Returns'''
 +
:: 実行中のアニメーションの数
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">uint32_t lv_anim_speed_to_time(uint32_t speed, int32_t start, int32_t end) </span>
 +
: 与えられた速度と開始値、終了値でアニメーションの時間を計算する
 +
: '''Parameters'''
 +
::*'''speed''' -- アニメーションの速度（単位：秒
 +
::* '''start''' -- アニメーションの開始値
 +
::* '''end''' -- アニメーションの終了値
 +
: '''Returns'''
 +
:: 与えられたパラメータでアニメーションの所要時間[ms]を指定します。
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">void lv_anim_refr_now(void) </span>
 +
: アニメーションの状態を手動でリフレッシュします。<code style="color: #bb0000;">lv_timer_handler</code> がしばらく実行できないようなブロッキング処理でアニメーションを動作させる場合に便利。<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>
 +
: 線形特性を適用するアニメーションの現在の値を計算する
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションへのポインタ
 +
: '''Returns'''
 +
:: 設定する現在の値
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_ease_in(const lv_anim_t *a) </span>
 +
: 開始フェーズの速度を低下させるアニメーションの現在の値を計算する
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションへのポインタ
 +
: '''Returns'''
 +
:: 設定する現在の値
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_ease_out(const lv_anim_t *a) </span>
 +
: 終了フェーズを遅くするアニメーションの現在の値を計算する
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションへのポインタ
 +
: '''Returns'''
 +
:: 設定する現在の値
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_ease_in_out(const lv_anim_t *a) </span>
 +
: S特性（コサイン）を応用したアニメーションの現在値を算出する。
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションのポインタ
 +
: '''Returns'''
 +
:: 設定する現在の値
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_overshoot(const lv_anim_t *a) </span>
 +
: 最後にオーバーシュートがあるアニメーションの電流値を計算する
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションのポインタ
 +
: '''Returns'''
 +
:: 設定する現在の値
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_bounce(const lv_anim_t *a) </span>
 +
: 3回バウンドするアニメーションの現在値を計算する
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションのポインタ
 +
: '''Returns'''
 +
:: 設定する現在の値
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">int32_t lv_anim_path_step(const lv_anim_t *a) </span>
 +
: ステップ特性を適用したアニメーションの現在値を算出する。(アニメーションの終了時に終了値を設定する）。
 +
: '''Parameters'''
 +
::'''a''' -- アニメーションのポインタ
 +
: '''Returns'''
 +
:: 設定する現在の値
 +
 +
<span style="background-color:#e7f2fa;color:#2980b9;">struct _lv_anim_t </span>
 +
:''#include <lv_anim.h>''
 +
: アニメーションを描写する
 +
: '''Public Members'''
 +
: void *var
 +
:: アニメーションする変数
 +
:<span style="background-color: #eeeeee;">lv_anim_exec_xcb_t exec_cb </span>
 +
:: アニメーションさせるために実行する関数
 +
:<span style="background-color: #eeeeee;">lv_anim_start_cb_t start_cb </span>
 +
:: アニメーション開始時に呼び出す（<code style="color: #bb0000;">delay</code>を考慮）
 +
:<span style="background-color: #eeeeee;">lv_anim_ready_cb_t ready_cb </span>
 +
:: アニメーションの準備ができたら呼び出す
 +
:<span style="background-color: #eeeeee;">lv_anim_get_value_cb_t get_value_cb </span>
 +
:: 相対モードで現在値を取得する
 +
:<span style="background-color: #eeeeee;">void *user_data </span>
 +
:: カスタムユーザーデータ
 +
:<span style="background-color: #eeeeee;">lv_anim_path_cb_t path_cb </span>
 +
:: アニメーションのパス（曲線）を表現する
 +
:<span style="background-color: #eeeeee;">int32_t start_value </span>
 +
:: スタート値
 +
:
 +
:<span style="background-color: #eeeeee;">int32_t current_value </span>
 +
:: 現在値
 +
:
 +
:<span style="background-color: #eeeeee;">int32_t end_value </span>
 +
:: 終了値
 +
:
 +
:<span style="background-color: #eeeeee;">int32_t time </span>
 +
:: アニメーションの時間（単位：ms
 +
:<span style="background-color: #eeeeee;">int32_t act_time </span>
 +
:: アニメーションの現在時刻。 負の値を設定すると、遅延が発生する。
 +
:<span style="background-color: #eeeeee;">uint32_t playback_delay </span>
 +
:: 再生前に待機
 +
:<span style="background-color: #eeeeee;">uint32_t playback_time </span>
 +
:: 再生アニメーションの再生時間
 +
:<span style="background-color: #eeeeee;">uint32_t repeat_delay </span>
 +
:: 繰り返し前に待機
 +
:<span style="background-color: #eeeeee;">uint16_t repeat_cnt </span>
 +
:: アニメーションの繰り返し再生回数
 +
:<span style="background-color: #eeeeee;">uint8_t early_apply </span>
 +
:: 1: <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>
 +
:: このラウンドでアニメーションが実行されたことを示す
 +
:<span style="background-color: #eeeeee;">uint8_t start_cb_called </span>
 +
::<code style="color: #bb0000;">start_cb</code> が既に呼び出されていたことを示す。
 +
|}
  
  
  
−
:[[App:Library:LVGL#Overview|戻る : Previous]]
+
[[App:Library:LVGL#Overview|戻る : Previous]]

2022年7月2日 (土) 12:21時点における最新版

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 lv_obj_set_x(obj, value) or lv_obj_set_width(obj, value)

アニメーションを使用すると、変数の値を開始値と終了値の間で自動的に変更できます。アニメーションは、対応する値パラメーターを使用して"animator"関数を定期的に呼び出すことによって発生します。 アニメータ関数のプロトタイプは次のとおりです。
 void func(void * var, lv_anim_var_t value);

このプロトタイプはLVGLの大部分のプロパティセット関数と互換性がある。例：lv_obj_set_x(obj, value) or lv_obj_set_width(obj, value)

戻る : Previous


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*/

You can apply multiple different animations on the same variable at the same time.

For example, animate the x and y coordinates with 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.

アニメーションを作成するには、lv_anim_t 変数を初期化し、lv_anim_set_...() 関数で設定する必要があります。 
 /* 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とlv_obj_set_yを使用してx座標とy座標をアニメーション化します。

しかし、指定した変数と関数のペアを持つアニメーションは1つしか存在できず、lv_anim_start() はそのようなペアを持つ既存のアニメーションを削除します。

戻る : Previous


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:

  • lv_anim_path_linear linear animation
  • lv_anim_path_step change in one step at the end
  • lv_anim_path_ease_in slow at the beginning
  • lv_anim_path_ease_out slow at the end
  • lv_anim_path_ease_in_out slow at the beginning and end
  • lv_anim_path_overshoot overshoot the end value
  • lv_anim_path_bounce bounce back a little from the end value (like hitting a wall)
 アニメーションのパスを制御できます。最も単純なケースはリニアで、開始から終了までのカレント値が固定ステップで変更されることを意味します。

パスは、アニメーションの現在の状態に基づいて設定する次の値を計算する関数です。

現在、以下の組み込みパス関数があります。

  • lv_anim_path_linear リニアアニメーション
  • lv_anim_path_step 最後の1ステップでの変更
  • lv_anim_path_ease_in 最初は遅い
  • lv_anim_path_ease_out 終了時に遅い
  • lv_anim_path_ease_in_out 開始と終了が遅い
  • lv_anim_path_overshoot オーバーシュート終了値
  • lv_anim_path_bounce終了値から少し跳ね返る (壁にぶつかるなど)
戻る : Previous


Speed vs time

英文 自動翻訳

By default, you set the animation time directly.

But in some cases, setting the animation speed is more practical.

The lv_anim_speed_to_time(speed, start, end) function calculates the required time in milliseconds to reach the end value from a start value with the given speed.

The speed is interpreted in unit/sec dimension.

For example, lv_anim_speed_to_time(20,0,100) will yield 5000 milliseconds. For example, in the case of lv_obj_set_x unit is pixels so 20 means 20 px/sec speed.

デフォルトでは、アニメーションの時間を直接設定します。

しかし、場合によっては、アニメーションの速度を設定する方が実用的です。

lv_anim_speed_to_time(speed, start, end)関数は、与えられた速度で開始値から終了値に到達するまでの所要時間をミリ秒単位で計算します。

速度は、単位/秒の次元で解釈されます。

例えば、lv_anim_speed_to_time(20,0,100)の場合、5000ミリ秒になります。例えば、lv_obj_set_xの場合、単位はピクセルなので、20は20px/secの速度を意味します。

戻る : Previous


Delete animations

英文 自動翻訳

You can delete an animation with lv_anim_del(var, func) if you provide the animated variable and its animator function.

アニメーション変数とそのアニメーター関数を指定すれば、lv_anim_del(var, func)でアニメーションを削除することができます。
戻る : Previous


Timeline

英文 自動翻訳

A timeline is a collection of multiple animations which makes it easy to create complex composite animations.

Firstly, create an animation element but don’t call lv_anim_start().

Secondly, create an animation timeline object by calling lv_anim_timeline_create().


Thirdly, add animation elements to the animation timeline by calling lv_anim_timeline_add(at, start_time, &a).

start_time is the start time of the animation on the timeline. Note that start_time will override the value of delay.

Finally, call lv_anim_timeline_start(at) to start the animation timeline.

It supports forward and backward playback of the entire animation group, using lv_anim_timeline_set_reverse(at, reverse).

Call lv_anim_timeline_stop(at) to stop the animation timeline.

Call lv_anim_timeline_set_progress(at, progress) function to set the state of the object corresponding to the progress of the timeline.

Call lv_anim_timeline_get_playtime(at) function to get the total duration of the entire animation timeline.

Call lv_anim_timeline_get_reverse(at) function to get whether to reverse the animation timeline.

Call lv_anim_timeline_del(at) function to delete the animation timeline. LVGL docs overview animation 01.png

タイムラインは複数のアニメーションの集合体なので、複雑な複合アニメーションを簡単に作成することができます。

まず、アニメーション要素を作成しますが、lv_anim_start()は呼び出さないでください。

次に、lv_anim_timeline_create()を呼び出して、アニメーションのタイムラインオブジェクトを作成します。


3番目に、lv_anim_timeline_add(at, start_time, &a)を呼び出して、アニメーション要素をアニメーションタイムラインに追加してください。

start_time はタイムライン上のアニメーションの開始時間です。

start_time はdelayの値を上書きすることに注意してください。


最後に、lv_anim_timeline_start(at)を呼び出し、アニメーションのタイムラインを開始します。


lv_anim_timeline_set_reverse(at, reverse)を使って、アニメーショングループ全体の順方向と逆方向の再生に対応しています。


Call lv_anim_timeline_stop(at) to タイムラインを停止させる。

Call lv_anim_timeline_set_progress(at, progress) function to タイムラインの進行状況に対応するオブジェクトの状態を設定します。

Call lv_anim_timeline_get_playtime(at) function to アニメーションのタイムライン全体の継続時間を取得します。

Call lv_anim_timeline_get_reverse(at) function to アニメーションのタイムラインを反転させるかどうかを取得します。

Call lv_anim_timeline_del(at) function to アニメーションタイムラインを削除してください。LVGL docs overview animation 01.png

戻る : Previous

Examples

英文 自動翻訳

Start animation on an event

LVGL docs example 018.png

Playback animation

LVGL docs example 019.png

Animation timeline

LVGL docs example 020.png

戻る : Previous


API

英文 自動翻訳
Typedefs

typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*)

Get the current value during an animation

typedef void (*lv_anim_exec_xcb_t)(void*, int32_t)

Generic prototype of "animator" functions. First parameter is the variable to animate. Second parameter is the value to set. Compatible with lv_xxx_set_yyy(obj, value) functions The x in _xcb_t means it's not a fully generic prototype because it doesn't receive lv_anim_t * as its first argument

typedef void (*lv_anim_custom_exec_cb_t)(struct _lv_anim_t*, int32_t)

Same as lv_anim_exec_xcb_t but receives lv_anim_t * as the first parameter. It's more consistent but less convenient. Might be used by binding generator functions.

typedef void (*lv_anim_ready_cb_t)(struct _lv_anim_t*)

Callback to call when the animation is ready

typedef void (*lv_anim_start_cb_t)(struct _lv_anim_t*)

Callback to call when the animation really stars (considering delay)

typedef int32_t (*lv_anim_get_value_cb_t)(struct _lv_anim_t*)

Callback used when the animation values are relative to get the current value

typedef struct _lv_anim_t lv_anim_t

Describes an animation

Enums

enum lv_anim_enable_t

Can be used to indicate if animations are enabled or disabled in a case Values:
enumerator LV_ANIM_OFF
enumerator LV_ANIM_ON
Typedefs

typedef int32_t (*lv_anim_path_cb_t)(const struct _lv_anim_t*)

アニメーション中の現在値を取得する

typedef void (*lv_anim_exec_xcb_t)(void*, int32_t)

animator "関数の一般的なプロトタイプ。第1パラメータはアニメートする変数。 第2パラメータは設定する値。lv_xxx_set_yyy(obj, value)関数と互換性がある。 _xcb_t の x は、第一引数に lv_anim_t * を受け取らないので、完全な汎用プロトタイプでないことを意味します。

typedef void (*lv_anim_custom_exec_cb_t)(struct _lv_anim_t*, int32_t)

lv_anim_exec_xcb_t と同じですが、最初のパラメータとしてlv_anim_t *を受け取ります。
より一貫性がありますが、便利ではありません。
バインドジェネレータ関数で使用されるかもしれません。

typedef void (*lv_anim_ready_cb_t)(struct _lv_anim_t*)

アニメーションの準備ができたときに呼び出されるコールバック

typedef void (*lv_anim_start_cb_t)(struct _lv_anim_t*)

アニメーションが本当に始まるときに呼び出されるコールバック（delayを考慮したもの）

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

ケース値において、アニメーションの有効・無効を示すことができる。
enumerator LV_ANIM_OFF
enumerator LV_ANIM_ON

Functions


LV_EXPORT_CONST_INT(LV_ANIM_REPEAT_INFINITE)

LV_EXPORT_CONST_INT(LV_ANIM_PLAYTIME_INFINITE)

void _lv_anim_core_init(void)

Init. the animation module

void lv_anim_init(lv_anim_t *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 lv_anim_t variable to initialize

static inline void lv_anim_set_var(lv_anim_t *a, void *var)

Set a variable to animate
Parameters
  • a -- pointer to an initialized lv_anim_t variable
  • var -- pointer to a variable to animate

static inline void lv_anim_set_exec_cb(lv_anim_t *a, lv_anim_exec_xcb_t exec_cb)

Set a function to animate var
Parameters
  • a -- pointer to an initialized lv_anim_t variable
  • exec_cb -- a function to execute during animation LVGL's built-in functions can be used. E.g. lv_obj_set_x

static inline void lv_anim_set_time(lv_anim_t *a, uint32_t duration)

Set the duration of an animation
Parameters
  • a -- pointer to an initialized lv_anim_t variable
  • duration -- duration of the animation in milliseconds

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

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

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 but lv_anim_custom_exec_cb_t receives lv_anim_t * as its first parameter instead of void *. This function might be used when LVGL is bound to other languages because it's more consistent to have lv_anim_t * as first parameter. The variable to animate can be stored in the animation's user_data
Parameters
  • a -- pointer to an initialized lv_anim_t variable
  • exec_cb -- a function to execute.

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.

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

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

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

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

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.

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.

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.

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 when delay ms is elapsed and the animations really starts

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.

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)

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
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
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 with exec_cb will be deleted. This function exists because it's logical that all anim. functions receives an lv_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 an lv_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 in lv_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)
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
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
 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)

アニメーション変数を初期化する。例: lv_anim_t a; lv_anim_init(&a); lv_anim_set_...(&a); lv_anim_start(&a);
Parameters
a -- 初期化する lv_anim_t 変数へのポインタを指定します。

static inline void lv_anim_set_var(lv_anim_t *a, void *var)

アニメーションを行う変数を設定する
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • var -- アニメーションを行う変数へのポインタ

static inline void lv_anim_set_exec_cb(lv_anim_t *a, lv_anim_exec_xcb_t exec_cb)

アニメーションvarを行う関数を設定する
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • exec_cb -- アニメーション中に実行する関数 LVGL の組み込み関数を使用することができます．例：lv_obj_set_x

static inline void lv_anim_set_time(lv_anim_t *a, uint32_t duration)

アニメーションのデュレーションを設定する
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • duration -- アニメーションの継続時間（単位：ミリ秒

static inline void lv_anim_set_delay(lv_anim_t *a, uint32_t delay)

アニメーションを開始するまでの遅延時間を設定する
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • delay -- アニメーションの前の遅延時間（ミリ秒単位)

static inline void lv_anim_set_values(lv_anim_t *a, int32_t start, int32_t end)

アニメーションの開始値と終了値を設定する
Parameters
  • a -- 初期化された lv_anim_t変数へのポインタ。
  • start -- 開始値
  • end --終わり値

static inline void lv_anim_set_custom_exec_cb(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)

lv_anim_set_exec_cbと似ていますが、 lv_anim_custom_exec_cb_t は void * の代わりにlv_anim_t *を最初の引数として受け取ります。
この関数は、LVGLが他の言語にバインドされている場合に使用できます。これは、最初のパラメーターとしてlv_anim_t *を使用する方が一貫性があるためです。
アニメーションさせる変数は，アニメーションのuser_dataに格納することができます．
Parameters
  • a -- 初期化されたlv_anim_t変数へのポインタ
  • exec_cb -- 実行する関数。

static inline void lv_anim_set_path_cb(lv_anim_t *a, lv_anim_path_cb_t path_cb)

アニメーションのパス (カーブ) を設定します。
Parameters
  • a -- 初期化されたlv_anim_t 変数へのポインタ
  • path_cb -- アニメーションの現在の値を設定する関数。

static inline void lv_anim_set_start_cb(lv_anim_t *a, lv_anim_start_cb_t start_cb)

アニメーションが実際に開始するときに関数呼び出しを設定する (delayを考慮)
Parameters
  • a -- 初期化されたlv_anim_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)

変数の現在の値を使用し、戻り値に相対的な開始値と終了値を作成する関数を設定します。
Parameters
  • a -- 初期化されたlv_anim_t 変数へのポインタ
  • get_value_cb -- アニメーション開始時の関数呼び出し

static inline void lv_anim_set_ready_cb(lv_anim_t *a, lv_anim_ready_cb_t ready_cb)

アニメーションの準備ができたときに関数呼び出しを設定する
Parameters
  • a -- 初期化されたlv_anim_t 変数へのポインタ
  • ready_cb -- アニメーションの準備ができたときの関数呼び出し

static inline void lv_anim_set_playback_time(lv_anim_t *a, uint32_t time)

順方向の準備ができたらアニメーションを再生する
Parameters
  • a -- 初期化されたlv_anim_t変数へのポインタ
  • time -- 再生アニメーションの継続時間 (ミリ秒単位) 。0:再生を無効にします。

static inline void lv_anim_set_playback_delay(lv_anim_t *a, uint32_t delay)

順方向の準備ができたときに再生するアニメーションを作る
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • delay -- 再生アニメーションを開始するまでの遅延時間をミリ秒単位で指定します。

static inline void lv_anim_set_repeat_count(lv_anim_t *a, uint16_t cnt)

アニメーションを繰り返すようにする。
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • cnt -- 繰り返し回数，またはLV_ANIM_REPEAT_INFINITE で無限回数を指定する。0：繰り返しを無効とする。

static inline void lv_anim_set_repeat_delay(lv_anim_t *a, uint32_t delay)

アニメーションを繰り返すまでの遅延時間を設定します。
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • delay -- アニメーションを繰り返す前に、ミリ秒単位で遅延させます。

static inline void lv_anim_set_early_apply(lv_anim_t *a, bool en)

アニメーションを即座に適用するか、遅延時間が終了してから適用するかを設定します。
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • en -- true: lv_anim_startですぐに開始値を適用、false: delay ms が経過し、本当にアニメーションが開始されたときにのみ開始値を適用。

static inline void lv_anim_set_user_data(lv_anim_t *a, void *user_data)

アニメーションのカスタムユーザーデータフィールドを設定します。
Parameters
  • a -- 初期化された lv_anim_t 変数へのポインタ。
  • user_data -- 新しい user_data へのポインタを指定します。

lv_anim_t *lv_anim_start(const lv_anim_t *a)

アニメーションを作成する
Parameters
a -- 初期化された 'anim_t' 変数。呼び出し後は必要ない。
Returns
作成されたアニメーションへのポインタ（a パラメータとは異なります）。

static inline uint32_t lv_anim_get_delay(lv_anim_t *a)

アニメーションを開始する前にディレイを取得する
Parameters
a -- 初期化された lv_anim_t 変数へのポインタ。
Returns
アニメーションの前の遅延時間（ミリ秒単位)

uint32_t lv_anim_get_playtime(lv_anim_t *a)

アニメーションの再生に使用した時間を取得します。
Parameters
a -- アニメーションへのポインタを指定します。
Returns
再生時間をミリ秒単位で指定します。

static inline void *lv_anim_get_user_data(lv_anim_t *a)

アニメーションのuser_dataフィールドを取得します。
Parameters
a -- 初期化された lv_anim_t 変数へのポインタを指定します。
Returns
アニメーションのカスタム user_data へのポインタ。

bool lv_anim_del(void *var, lv_anim_exec_xcb_t exec_cb)

アニメーター関数で指定された変数のアニメーションを削除する
Parameters
  • var -- 変数へのポインタ
  • exec_cb -- var' をアニメーション化する関数ポインタを指定するか、 それを無視して 'var' のアニメーションをすべて削除するには NULL を指定します。
Returns
true: 少なくとも1つのアニメーションが削除される,
false: アニメーションが削除されない

void lv_anim_del_all(void)

アニメーションをすべて削除する

lv_anim_t *lv_anim_get(void *var, lv_anim_exec_xcb_t exec_cb)

変数とそのexec_cbのアニメーションを取得します。
Parameters
  • var --変数へのポインタ
  • exec_cb -- var' をアニメーション化する関数へのポインタ、 または最初にマッチした 'var' を返す場合は NULL を指定します。
Returns
アニメーションへのポインタを指定します。

static inline bool lv_anim_custom_del(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)

aから animated 変数を取得し、アニメーションを削除します。 exec_cb を持つアニメーションだけが削除されます。 この関数が存在するのは、すべての anim. 関数はその最初のパラメータとして lv_anim_t を受け取ります。 C では実用的ではありませんが、API をより合理的にし、バインディングの生成を容易にするためです。
Parameters
  • a -- アニメーションへのポインタを指定します。
  • exec_cb -- var' をアニメーション化する関数ポインタを指定するか、 それを無視して 'var' のアニメーションをすべて削除するには NULL を指定します。
Returns
true: 少なくとも1つのアニメーションが削除される,
false: アニメーションが削除されない

static inline lv_anim_t *lv_anim_custom_get(lv_anim_t *a, lv_anim_custom_exec_cb_t exec_cb)

変数とその exec_cbのアニメーションを取得します。この関数が存在するのは、すべての anim 関数がその最初のパラメータとして lv_anim_tを受け取ることが論理的であるからです。C では実用的ではありませんが、API をより効果的にし、バインディングの生成を容易にするためです。
Parameters
  • a -- アニメーションへのポインタを指定します。
  • exec_cb -- var' をアニメーション化する関数へのポインタ、 または最初にマッチした 'var' を返す場合は NULL を指定します。
Returns
アニメーションへのポインタを指定します。

uint16_t lv_anim_count_running(void)

現在実行中のアニメーションの数を取得する
Returns
実行中のアニメーションの数

uint32_t lv_anim_speed_to_time(uint32_t speed, int32_t start, int32_t end)

与えられた速度と開始値、終了値でアニメーションの時間を計算する
Parameters
  • speed -- アニメーションの速度（単位：秒
  • start -- アニメーションの開始値
  • end -- アニメーションの終了値
Returns
与えられたパラメータでアニメーションの所要時間[ms]を指定します。

void lv_anim_refr_now(void)

アニメーションの状態を手動でリフレッシュします。lv_timer_handler がしばらく実行できないようなブロッキング処理でアニメーションを動作させる場合に便利。lv_refr_now()の中で呼び出されるので、直接使用するべきではありません。

int32_t lv_anim_path_linear(const lv_anim_t *a)

線形特性を適用するアニメーションの現在の値を計算する
Parameters
a -- アニメーションへのポインタ
Returns
設定する現在の値

int32_t lv_anim_path_ease_in(const lv_anim_t *a)

開始フェーズの速度を低下させるアニメーションの現在の値を計算する
Parameters
a -- アニメーションへのポインタ
Returns
設定する現在の値

int32_t lv_anim_path_ease_out(const lv_anim_t *a)

終了フェーズを遅くするアニメーションの現在の値を計算する
Parameters
a -- アニメーションへのポインタ
Returns
設定する現在の値

int32_t lv_anim_path_ease_in_out(const lv_anim_t *a)

S特性（コサイン）を応用したアニメーションの現在値を算出する。
Parameters
a -- アニメーションのポインタ
Returns
設定する現在の値

int32_t lv_anim_path_overshoot(const lv_anim_t *a)

最後にオーバーシュートがあるアニメーションの電流値を計算する
Parameters
a -- アニメーションのポインタ
Returns
設定する現在の値

int32_t lv_anim_path_bounce(const lv_anim_t *a)

3回バウンドするアニメーションの現在値を計算する
Parameters
a -- アニメーションのポインタ
Returns
設定する現在の値

int32_t lv_anim_path_step(const lv_anim_t *a)

ステップ特性を適用したアニメーションの現在値を算出する。(アニメーションの終了時に終了値を設定する）。
Parameters
a -- アニメーションのポインタ
Returns
設定する現在の値

struct _lv_anim_t

#include <lv_anim.h>
アニメーションを描写する
Public Members
void *var
アニメーションする変数
lv_anim_exec_xcb_t exec_cb
アニメーションさせるために実行する関数
lv_anim_start_cb_t start_cb
アニメーション開始時に呼び出す（delayを考慮）
lv_anim_ready_cb_t ready_cb
アニメーションの準備ができたら呼び出す
lv_anim_get_value_cb_t get_value_cb
相対モードで現在値を取得する
void *user_data
カスタムユーザーデータ
lv_anim_path_cb_t path_cb
アニメーションのパス（曲線）を表現する
int32_t start_value
スタート値
int32_t current_value
現在値
int32_t end_value
終了値
int32_t time
アニメーションの時間（単位：ms
int32_t act_time
アニメーションの現在時刻。 負の値を設定すると、遅延が発生する。
uint32_t playback_delay
再生前に待機
uint32_t playback_time
再生アニメーションの再生時間
uint32_t repeat_delay
繰り返し前に待機
uint16_t repeat_cnt
アニメーションの繰り返し再生回数
uint8_t early_apply
1: delayがあってもすぐにスタート値を適用する。
uint8_t playback_now
Play back is in progress
uint8_t run_round
このラウンドでアニメーションが実行されたことを示す
uint8_t start_cb_called
start_cb が既に呼び出されていたことを示す。


戻る : Previous

「https://robot-jp.com/wiki/index.php?title=App:Library:LVGL:docs:Overview:Animations&oldid=4081」から取得