image_animation_t

概述

图片动画控件，指定一个图片前缀，依次显示指定序列的图片，从而形成动画效果。

图片序列可以用sequence指定，也可以用start_index和end_index指定一个范围。

image_animation_t是widget_t的子类控件，widget_t的函数均适用于image_animation_t控件。

在xml中使用”image_animation”标签创建图片动画控件。如：

 <image_animation image="ani" start_index="1" end_index="9" auto_play="true" interval="50"
 delay="100"/>

更多用法请参考：
image_animation.xml

在c代码中使用函数image_animation_create创建图片动画控件。如：

 image_animation = image_animation_create(win, 10, 10, 200, 200);
 image_animation_set_image(image_animation, "ani");
 image_animation_set_interval(image_animation, 50);
 image_animation_set_range_sequence(image_animation, 1, 9);
 image_animation_play(image_animation);

完整示例请参考：
image_animation
demo

可用通过style来设置控件的显示风格，如背景颜色和边框等等，不过一般情况并不需要。

函数

属性

image_animation_cast 函数

• 函数功能：

转换为image_animation对象(供脚本语言使用)。

• 函数原型：

widget_t* image_animation_cast (widget_t* widget);

• 参数说明：

image_animation_create 函数

• 函数功能：

创建image_animation对象

• 函数原型：

widget_t* image_animation_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);

• 参数说明：

image_animation_pause 函数

• 函数功能：

暂停。

• 函数原型：

ret_t image_animation_pause (widget_t* widget);

• 参数说明：

image_animation_play 函数

• 函数功能：

播放。

• 函数原型：

ret_t image_animation_play (widget_t* widget);

• 参数说明：

image_animation_set_auto_play 函数

• 函数功能：

设置是否自动播放。

• 函数原型：

ret_t image_animation_set_auto_play (widget_t* widget, bool_t auto_play);

• 参数说明：

image_animation_set_delay 函数

• 函数功能：

设置延迟播放时间(仅适用于自动播放)。

• 函数原型：

ret_t image_animation_set_delay (widget_t* widget, uint32_t delay);

• 参数说明：

image_animation_set_format 函数

• 函数功能：

设置生成图片名的格式。

XXX:生成图片名时，第一个参数是图片名前缀，第二个是序数，只能在此前提下设置格式。

  const char* format = image_animation->format ? image_animation->format : "%s%d";
  tk_snprintf(name, TK_NAME_LEN, format, image_animation->image, image_animation->index);

• 函数原型：

ret_t image_animation_set_format (widget_t* widget, const char* format);

• 参数说明：

image_animation_set_image 函数

• 函数功能：

设置图片前缀。

• 函数原型：

ret_t image_animation_set_image (widget_t* widget, const char* image);

• 参数说明：

image_animation_set_interval 函数

• 函数功能：

设置播放间隔时间。

• 函数原型：

ret_t image_animation_set_interval (widget_t* widget, uint32_t interval);

• 参数说明：

image_animation_set_loop 函数

• 函数功能：

设置是否循环播放。

• 函数原型：

ret_t image_animation_set_loop (widget_t* widget, bool_t loop);

• 参数说明：

image_animation_set_range_sequence 函数

• 函数功能：

设置播放序列。比如image为”fire”，start_index为0, end_index为99, 将依次播放”fire0”, …,
“fire99”。

若指定的图片不存在，则重复上一张图片。

• 函数原型：

ret_t image_animation_set_range_sequence (widget_t* widget, uint32_t start_index, uint32_t end_index);

• 参数说明：

image_animation_set_sequence 函数

• 函数功能：

设置播放序列。比如image为”fire”，sequence为”12223”, 将依次播放”fire1”, “fire2”, “fire2”, “fire2”,
“fire3”。

• 函数原型：

ret_t image_animation_set_sequence (widget_t* widget, const char* sequence);

• 参数说明：

image_animation_set_unload_after_paint 函数

• 函数功能：

设置绘制完成后unload图片，以释放内存空间。

• 函数原型：

ret_t image_animation_set_unload_after_paint (widget_t* widget, bool_t unload_after_paint);

• 参数说明：

image_animation_stop 函数

• 函数功能：

停止(并重置index为0)。

• 函数原型：

ret_t image_animation_stop (widget_t* widget);

• 参数说明：

auto_play 属性

是否自动播放。

• 类型：bool_t

delay 属性

自动播放时延迟播放的时间(毫秒)。

• 类型：uint32_t

end_index 属性

图片结束序数。

• 类型：uint32_t

format 属性

索引到图片名转换时的格式，缺省为”%s%d”。

• 类型：char*

image 属性

图片名称的前缀。

• 类型：char*

interval 属性

每张图片播放的时间(毫秒)。

• 类型：uint32_t

loop 属性

是否循环播放。

• 类型：bool_t

sequence 属性

播放的序列，字符可选值为:0-9,a-z,A-Z。

• 类型：char*

start_index 属性

图片起始序数。

• 类型：uint32_t

unload_after_paint 属性

绘制完成后unload图片，以释放内存空间。

• 类型：bool_t