AWTK中的窗口动画

窗口动画是现代GUI最基本的功能之一，在窗口打开或关闭时，引入一个过渡动画，让用户感觉这个过程是流畅的。窗口动画的基本原理很简单：在打开或关闭窗口时，把前后两个窗口预先绘制到两张内存图片上，按照指定规则显示两张图片，形成动画效果。

一、介绍

窗口本身只需指定期望的动画类型，由窗口管理器负责在适当的时候(如打开和关闭窗口时)，创建窗口动画并让窗口动画绘制到屏幕上。在窗口动画期间，窗口管理器会禁止窗口本身的绘制，并忽略所有输入事件。目前支持的动画有：

普通窗口动画：

htranslate: 左右平移动画(速度最快，嵌入式平台推荐使用)。
vtranslate: 上下平移动画。
slide_up: 向上弹出。
slide_down: 向下弹出。
slide_left: 向左弹出。
slide_right: 向右弹出。

对话框动画：

popup: 向上弹出(速度最快，嵌入式平台推荐使用)。
popdown: 向下弹出。
fade: 淡入淡出动画。
center_scale: 缩放动画(没有硬件时加速慎用)。

以前的bottom_to_top相当于popup，仍然可以使用，但建议用popup代替。

以前的top_to_bottom相当于popdown，仍然可以使用，但建议用popdown代替。

对话框的动画可与对话框的highlight属性一起使用。

窗口动画有三种实现方式：

在系统支持OpenGL时，使用vgcanvas进行绘制，因为使用了浮点数，整个动画最为平滑。
在系统支持FrameBuffer，使用lcd绘图函数实现动画。
在低端系统上，不启用动画。

二、使用方法

给窗口或对话框指定动画效果，只需设置窗口或对话框的anim_hint属性即可：

  <window name="main" anim_hint="vtranslate">
...
  </window>

anim_hint的可选值，请参考window_animator.h中的定义。

三、动画参数

可以为动画指定参数，其格式为类似函数调用的参数格式。

1.所有动画都支持下面的参数：

duration 动画持续时间(毫秒)
easing 插值算法名称

如：

anim_hint="center_scale(duration=300)"

2.slide_up、slide_down、slide_left和slide_right动画特有参数:

alpha值用于在背景上画一层透明的颜色，这能够实现让背景变暗的效果。如果start_alpha和end_alpha不相同，则能实现动态变暗的效果，这有额外的运行开销，如果性能不佳，建议设置alpha即可。

start_alpha 起始alpha值(0-255)。
end_alpha 结束alpha值(0-255)。
alpha 相当于将start_alpha和end_alpha设置为同一个值。

四、示例

demoui演示了各种窗口动画：

./bin/demoui

五、自定义动画

开发者可以自定义动画，自定义的动画可以像内置动画一样，在XML文件中启用。

自定义动画非常简单，通常只需要几行代码即可。步骤如下：

1.实现window_animator_t接口。如：

static const window_animator_vtable_t s_window_animator_popup_vt = { 
    .overlap = TRUE,
    .type = "popup",
    .desc = "popup",
    .size = sizeof(window_animator_t),
    .draw_prev_window = window_animator_overlap_default_draw_prev,
    .draw_curr_window = window_animator_to_top_draw_curr};

window_animator_t* window_animator_popup_create(bool_t open, object_t* args) {
  return window_animator_create(open, &s_window_animator_popup_vt);
}

2.注册到window_animator工厂。如：

  window_animator_factory_register(factory, WINDOW_ANIMATOR_POPUP,
                                   window_animator_popup_create);

完整示例请参考：https://github.com/zlgopen/awtk/tree/master/src/window_animators

3.9 KiB Raw Blame History Unescape Escape