MGEffV1dot0ProgrammingGuide < Main < TWiki Page 2 of 版本日期

Transcription

1 MGEffV1dot0ProgrammingGuide < Main < TWiki Page 1 of 2 mgeff 编程指南 目录修订记录版本变更记录 目录 前言 版权声明 关于本指南 第一部分 mgeff 简介 第一章动画原理 第二章 mgeff 架构与特性 第二部分 mgeff 使用基础 第三章开始启程 第四章创建和运行动画 第五章动画的参数 第六章动力曲线 第七章动画的属性 第八章动画上下文信息 第九章动画的运行方式及控制 第十章动画组 第十一章动画回调函数 第三部分 mgeff 高级动画 第十二章特效器 第十三章主窗体动画 第四部分 mgeff 使用进阶 第十四章自定义特效器 第十五章自定义动力曲线 第五部分附录 附录 1 相关数据结构 附录 2 FAQ? 修订记录 版本 作者完成日期评审者评审日期版本 董凯王旭斌胡兆麟 V1.0 变更记录

2 MGEffV1dot0ProgrammingGuide < Main < TWiki Page 2 of 版本日期内容备注 V 完成初稿 mgeff V1.0 - rev XuBinWang - 12 Jan 2011 This topic: Main > MiniGUI > MGEffV1dot0ProgrammingGuide History: r23-15 Feb :10:36 - YongmingWei Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

3 MGEffV1dot0PGC00CopyrightClaim < Main < TWiki Page 1 of 版权声明 版权声明 版权声明 mgeff 编程指南 版本 1.0, 适用于 mgeff Version 1.0.x 版权所有 (C) 2003~2011, 北京飞漫软件技术有限公司, 保留所有权利 无论您以何种方式获得该手册的全部或部分文字或图片资料, 无论是普通印刷品还是电子文档, 北京飞漫软件技术有限公司仅仅授权您阅读的权利, 任何形式的格式转换 再次发布 传播以及复制其内容的全部或部分, 或将其中的文字和图片未经书面许可而用于商业目的, 均被视为侵权行为, 并可能导致严重的民事或刑事处罚 -- ZhaolinHu - 18 Jan 2011 This topic: Main > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC00CopyrightClaim History: r3-11 Feb :09:16 - XuBinWang Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

4 MGEffV1dot0PGC00AboutMe < Main < TWiki Page 1 of 1 关于本编程指南 章节编排 章节编排 第一部分 mgeff 简介 介绍了动画的原理以及 mgeff 的框架等 第二部分 mgeff 编程基础 本部分将从最简单的例子开始, 完整的向读者介绍 mgeff 动画的基础接口与生命周期等 第三部分 mgeff 高级动画 本部分介绍 mgeff 内建特效器的使用和主窗口动画,mGEff 提供了大量稳定而高效的特效器, 为读者快速实现翻转, 放大, 滚屏, 卷页等常用动画提供了可能 并且 mgeff 可以与 MiniGUI 结合, 以双缓冲为基础开发了针对主窗口动画的动画接口 第四部分 mgeff 编程进阶 --- 本部分属于高阶编程, 介绍如何自定义动力曲线与特效器, 并通过重载各种默认的动画回调以更有力的控制动画执行, 协助读者随心所欲的实现高效而富有个性的动画 -- KaiDong - 19 Jan 2011 This topic: Main > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC00AboutMe History: r4-27 Jan :29:40 - XuBinWang Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

5 MGEffV1dot0PGC00 < Main < TWiki Page 1 of mgeff 前言 前言 前言 -- XuBinWang - 12 Jan 2011 This topic: Main > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC00 History: r4-11 Feb :08:57 - XuBinWang Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

6 MGEffV1dot0PGC01 < Main < TWiki Page 1 of 1 动画原理 动画的原理帧动画属性动画 mgeff 支持的是属性动画 动画的原理 动画是将静止的画面变为动态的艺术, 实现由静止到动态的变化, 主要依靠的是人眼的视觉残留效应, 一般而言, 动画分为两种类型 : 帧 (Frame) 动画和属性 (Property) 动画 帧动画 帧动画是指播放事先准备好的一系列存在一定差异的图像来实现图像上事物动态变化的一种动画, 比如 GIF 图片等 ; 属性动画 属性动画则是指通过改变被显示对象的各种属性 ( 例如尺寸 位置 角度 透明度等 ) 来达到变化效果的一种动画, 这种动画也有帧的概念, 只不过每一帧是通过实时计算对象的属性值来产生的 mgeff 支持的是属性动画 mgeff 支持的是属性动画 : 用户通过设置动画对象相关属性的一些参数, 比如属性的起始值 终止值 动力曲线 ( 变化方式 ) 以及动画持续的时间等相关参数, 然后 mgeff 就可以根据这些相关的参数, 随时间的变化计算出一组从起始值到终止值变化的数值, 按这组时间属性值的变化曲线设置动画对象的相关属性, 即可产生相应的动画效果 归纳起来,mGEff 实现了一种在一定时间范围内, 根据给定的动力曲线将属性值从起始值变化到终止值的动画机制 在下一章 我们将详细介绍 mgeff 是如何实现属性动画的 -- XuBinWang - 12 Jan 2011 This topic: Main > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC01 History: r15-27 Jan :29:41 - XuBinWang Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

7 MGEffV1dot0PGC02 < Main < TWiki Page 1 of 2 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC02 r12-27 Jan :29:42 - XuBinWang mgeff 的架构与特性 mgeff 是什么设计目标 mgeff 的框架 mgeff 的类主要特性本章小结 mgeff 是什么 mgeff 是一个轻量级动画框架, 它提供了一套高效灵活的动画实现方案 设计目标 mgeff 的设计目标是建立起一套平台无关的动画机制, 它可以和 MiniGUI GTK+ 等 GUI 系统相结合开发相应的 (GDI 级 控件级和窗口级 ) 动画 mgeff 的框架 以下是它与 MiniGUI 相结合的框架 : mgeff 的类 mgeff 本身采用 C 语言开发的, 但其设计及实现上运用了一些基本的面向对象思想, 比如以 struct 模拟 class 等, 了解这些结构 ( 类 ) 对使用它会很有帮助, 下面是 mgeff 的 类 图 : // TODO 类图 主要特性 mgeff 提供了以下主要特性 : 驱动动画 动力曲线 串行 并行动画组 特效器 主窗体动画

8 MGEffV1dot0PGC02 < Main < TWiki Page 2 of 2 本章小结 本章简单介绍了 mgeff 的框架结构和主要特性 接下来的章节将会就这些特性逐步展开进行详细的介绍 -- XuBinWang - 12 Jan 2011 I Attachment Action Size Date Who Comment mgeff.png manage 10.1 K 19 Jan :32 KaiDong Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

9 MGEffV1dot0PGC03 < Main < TWiki Page 1 of 6 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC03 r20-14 Feb :12:58 - XuBinWang 开始启程 使用 mgeff 库函数原型初始化 mgeff 库函数注销 mgeff 库函数使用示例运行结果注意事项本章小结 使用 mgeff 库 在上一章中我们简单介绍了下 mgeff 的框架和特性, 在接下来的章节, 将带领大家进入奇妙的动画世界, 首先我们先介绍下 mgeff 库的使用 函数原型 mgeff 库提供了 mgeffinit/mgeffdeinit 函数分别负责库的初始化和注销 其原型为 : 初始化 mgeff 库函数 /* 初始化 mgeff 库函数 */ int mgeffinit (void); 参数说明 : void - 无参数 ; 返回值说明 : int - 0 初始化成功 ; 注销 mgeff 库函数 /* 注销 mgeff 库函数 */ void mgeffdeinit (void); 参数说明 : void - 无参数 ; 返回值说明 : void - 无返回值 ; 使用示例 下面我们结合一个简单的示例来给大家讲解下 mgeff 库的使用 在这里我们将只关注

10 MGEffV1dot0PGC03 < Main < TWiki Page 2 of 6 mgeffinit/mgeffdeinit 这两个函数的使用, 其他函数的使用将在后续章节中讲解 : #include <stdio.h> #include <string.h> #include <minigui/common.h> #include <minigui/gdi.h> #include <minigui/window.h> #include <minigui/minigui.h> #include <mgeff/mgeff.h> /********************************************************************* #define CAPTION "animation_sync" #define BAR_HEIGHT 50 #define DURATION (20 * 1000) #define START_VAL 0x00 #define END_VAL 0xFF /********************************************************************* static char g_str[64]; static int g_value = 0x00; /********************************************************************* /* main window proc */ static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPAR /* draw a frame */ static void draw_frame (HWND hwnd); /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int /* create and run an animation */ static int do_animation (HWND hwnd); /********************************************************************* int MiniGUIMain (int argc, const char *argv[]) HWND hmainhwnd; MAINWINCREATE createinfo; MSG msg; #ifdef _MGRM_PROCESSES JoinLayer (NAME_DEF_LAYER, "animation", 0, 0); #endif createinfo.dwstyle = WS_VISIBLE WS_BORDER WS_CAPTION; createinfo.dwexstyle = WS_EX_NONE; createinfo.spcaption = CAPTION; createinfo.hmenu = 0;

11 MGEffV1dot0PGC03 < Main < TWiki Page 3 of 6 createinfo.hcursor = GetSystemCursor (0); createinfo.hicon = 0; createinfo.mainwindowproc = mainwindowproc; createinfo.lx = 0; createinfo.ty = 0; createinfo.rx = 240; createinfo.by = 320; createinfo.ibkcolor = COLOR_lightwhite; createinfo.dwadddata = 0; createinfo.hhosting = HWND_DESKTOP; hmainhwnd = CreateMainWindow (&createinfo); if (hmainhwnd == HWND_INVALID) return -1; ShowWindow (hmainhwnd, SW_SHOWNORMAL); while (GetMessage (&msg, hmainhwnd)) TranslateMessage (&msg); DispatchMessage (&msg); MainWindowThreadCleanup (hmainhwnd); return 0; /********************************************************************** /* main window proc */ static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPARA switch (message) case MSG_CREATE: /* init mgeff library */ mgeffinit (); sprintf (g_str, "you can press any key."); do_animation (hwnd); break; case MSG_KEYDOWN: sprintf (g_str, "you press key, keycode(%d)", wparam); printf ("%s\n", g_str);

12 MGEffV1dot0PGC03 < Main < TWiki Page 4 of 6 InvalidateRect (hwnd, NULL, TRUE); break; case MSG_PAINT: draw_frame (hwnd); break; case MSG_CLOSE: DestroyMainWindow (hwnd); PostQuitMessage (hwnd); /* deinit mgeff library */ mgeffdeinit (); break; default: break; return DefaultMainWinProc (hwnd, message, wparam, lparam); /* draw a frame */ static void draw_frame (HWND hwnd) HDC dc; RECT rc; int client_w, client_h; char str[64]; int color; /* begin draw */ dc = BeginPaint (hwnd); /* get client rect */ GetClientRect (hwnd, &rc); client_w = RECTW (rc); client_h = (RECTH (rc) - BAR_HEIGHT) * g_value / (END_VAL - STA color = g_value; /* set brush and draw area */ SetBrushColor (dc, RGB2Pixel (dc, color, 0x00, 0x00)); FillBox (dc, 0, BAR_HEIGHT, client_w, client_h);

13 MGEffV1dot0PGC03 < Main < TWiki Page 5 of 6 /* draw the text */ sprintf (str, "current color: RGB(%d,0,0)", color); TextOut (dc, 0, 0, str); /* print information */ TextOut (dc, 0, BAR_HEIGHT / 2, g_str); EndPaint (hwnd, dc); /* end draw */ /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int i /* set animation property */ g_value = *value; /* update */ InvalidateRect (hwnd, NULL, TRUE); /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION; start_val = START_VAL; end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) prope /* set animation property */ /* duration */ mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */

14 MGEffV1dot0PGC03 < Main < TWiki Page 6 of 6 mgeffanimationsetendvalue (animation, &end_val); /* running */ mgeffanimationsyncrun (animation); /* delete the animation object */ mgeffanimationdelete (animation); return 0; 可以看到, 程序在创建的时候 ( 消息 MSG_CREATE 中 ) 调用了初始化函数 mgeffinit(), 在关闭的时候 ( 消息 MSG_CLOSE 中 ) 调用了注销函数 mgeffdeinit() 在这两个函数之间调用诸如创建动画, 设置属性, 运行动画等 mgeff 函数 运行结果 注意事项 但需要注意的是,mGEff 不是线程安全的, 所以请不要在多个线程中同时使用 本章小结 本章通过一个简单的 mgeff 示例演示了如何在 MiniGUI 程序中引入和准备 mgeff 环境, 做好了这些准备工作, 就能够开始使用 mgeff 实现动画了 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

15 MGEffV1dot0PGC04 < Main < TWiki Page 1 of 4 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC04 r18-14 Feb :13:43 - XuBinWang 创建和运行动画 创建和运行动画函数原型创建动画对象函数回调函数同步运行动画对象函数使用示例运行结果句柄的概念本章小结 创建和运行动画 在上一章中我们介绍了 mgeff 库的初始化和注销, 通过例子我们学习了库的初始化和注销函数在什么地方什么时候调用 在这章里面我们将要学习如何创建一个动画对象以及使这个动画动起来 函数原型 mgeff 库提供了两个函数分别用来创建动画对象和运行动画 其原型为 : 创建动画对象函数 BeautifierPlugin Error: Unable to handle " cpp " language. /* 创建动画对象 */ MGEFF_ANIMATION mgeffanimationcreate (void *target, MGEFF_SETPROPERTY_ 参数说明 : target - 要进行动画的目标对象, 这里因为我们只演示 mgeff 创建动画的方式, 所以先暂时传入 NULL, 没有具体的动画对象 ; setproperty - 属性变化时要调用的回调函数指针, 此函数会在动画的每一帧产生时被调用, 稍后会着重进行介绍 ; id - 属性 / 动画的 ID, 这个值将作为参数传递给回调函数, 用来在多个动画共用同一回调函数时区分要修改的属性 ; varianttype - 属性值的类型, 这个参数决定了属性起始值与终止值的数据类型,mGEff 里定义了一组类型的枚举, 其定义如下 : BeautifierPlugin Error: Unable to handle " cpp " language. enum EffVariantType MGEFF_INT = 0, /* 整型 */ MGEFF_FLOAT = 1, /* 浮点类型 */ MGEFF_DOUBLE = 2, /* 双精度浮点类型 */ MGEFF_POINT = 3, /* 整型点 */

16 MGEffV1dot0PGC04 < Main < TWiki Page 2 of 4 ; MGEFF_POINTF = 4, /* 浮点类型点 */ MGEFF_3DPOINT = 5, /* 整型 3 维点 */ MGEFF_3DPOINTF = 6, /* 浮点类型 3 维点 */ MGEFF_RECT = 7, /* 区域 */ MGEFF_COLOR = 8, /* 颜色 */ MGEFF_MAX 返回值说明 : handle - 动画对象句柄 ; 回调函数 mgeff 是属性动画, 而当动画的属性值 ( 比如当前幀 状态 方向等 ) 改变的时候,mGEff 会通过调用回调的方式来通知用户 比如这里的 MGEFF_SETPROPERTY_CB 回调函数就会在每一幀发生的时候调用, 用户可以在这里根据属性的变化值绘制动画对象 这里我们先接触一下帧回调函数, 关于回调函数的概念我们将有专门的一章来介绍它, 回调函数的原型 : BeautifierPlugin Error: Unable to handle " cpp " language. typedef void (* MGEFF_SETPROPERTY_CB)(MGEFF_ANIMATION handle, void *tar 参数说明 : handle - 调用本函数的动画句柄, 通过这个句柄可以在函数中访问到与动画相关的一些信息 ; target - 要进行动画的目标对象, 它在调用 mgeffanimationcreate 创建动画时被指定, 它可以是窗口 控件句柄或者是自定义的对象 ; id - 属性的 ID 值, 同样也是在调用 mgeffanimationcreate 时指定的, 有时用户希望在多个动画里共用同一个回调函数以控制对象多个属性的变化, 此时可以为每个属性设置不同的 ID 值, 让用户在回调函数里判断当前发生改变的属性 针对一些常用的属性对象, 预先设置了如下 ID 值, 用户可以直接拿来用 : BeautifierPlugin Error: Unable to handle " cpp " language. ; enum EffPropertyID ID_NULL = 0, ID_POS, /* POINT */ ID_SIZE, /* RECT */ ID_RECT, /* RECT, pos & size */ ID_OPACITY, /* int */... ID_USER = 1000; value - 属性的当前值, 属性的起始值与终止值由 mgeffanimationsetstartvalue/mgeffanimationsetendvalue 两个函数设置, 在前面提到过 mgeff 的整个动画过程就是将属性从起始值变化到终止值, 而这个 value, 每一幀的变化值 本示例中只是将该值做打印处理, 用户可以用它来驱动动画对象的相关属性, 比如长度, 大小, 颜色等, 来实现相关的动画效果

17 MGEffV1dot0PGC04 < Main < TWiki Page 3 of 4 返回值说明 : void - 无返回值 ; 同步运行动画对象函数 BeautifierPlugin Error: Unable to handle " cpp " language. /* 同步运行动画 */ int mgeffanimationsyncrun (MGEFF_ANIMATION handle); 参数说明 : handle - 动画对象句柄 返回值说明 : int - 使用示例 仍然以上一章中的示例为例, 函数 do_animation 中包含了创建和运行一个动画的全过程 : BeautifierPlugin Error: Unable to handle " cpp " language. /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int /* set animation property */ g_value = *value; /* update */ InvalidateRect (hwnd, NULL, TRUE); /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION; start_val = START_VAL; end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) property /* set animation property */

18 MGEffV1dot0PGC04 < Main < TWiki Page 4 of 4 /* duration */ mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */ mgeffanimationsetendvalue (animation, &end_val); /* running */ mgeffanimationsyncrun (animation); /* delete the animation object */ mgeffanimationdelete (animation); return 0; 通过阅读上述代码, 我们看到创建一个动画对象的步骤为 : 先创建了一个动画对象, 设置幀回调函数 然后对这个动画对象, 设置了相关属性的起始值 结束值和动画持续时间等 最后调用动画运行函数, 运行这个动画 运行结果 句柄的概念 从上面的代码可以看到, 正如 MiniGUI 一样,mGEff 对外提供的对象访问方式也是通过 句柄 来完成的 句柄与普通指针的区别在于 : 指针包含的是引用对象的内存地址, 而句柄则是由框架所管理的引用标识, 该标识可以被框架重新定位到一个内存地址上 这种间接访问对象的模式增强了系统对引用对象的控制, 并减少对外暴露的数据结构, 有利于保持一个较简洁的 API 接口层 本章小结 本章展示了一个最简单的动画是如何创建 运行的, 并附带了一个简单的示例, 在之后的章节里, 会逐渐扩展完善这个示例以便向用户演示更多的 mgeff 特性 另外这一章详细描述了属性变化回调函数的概念和用法, 通过实现不同的属性变化回调, 用户可以得到各种各样的动画特效, 概括起来就是 mgeff 只提供了运行动画的驱动力, 具体要如何运用这个驱动力来产生动画, 主要就看用户如何实现这个回调函数了 最后还介绍了 句柄 一词在 mgeff 中的含义, 通过句柄访问对象是 mgeff 提供统一访问途径 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

19 MGEffV1dot0PGC05 < Main < TWiki Page 1 of 3 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC05 r11-14 Feb :52:01 - XuBinWang 动画的参数 动画的参数函数原型设置动画运行时间函数设置动画属性开始值函数设置动画属性结束值函数使用示例运行结果本章小结 动画的参数 在上一章中我们介绍了如何创建动画以及如何运行这个动画, 接下来我们将介绍如何去控制动画的运行时间以及动画对象相关属性值的控制比如起始值和结束值等 函数原型 mgeff 提供了三个函数分别用于控制动画的运行时间和设置动画属性值的起始值和结束值 其原型分别是 : 设置动画运行时间函数 /* 设置动画运行时间 */ void mgeffanimationsetduration (MGEFF_ANIMATION handle, int duration_m 参数说明 : handle - 动画对象句柄 ; duration_ms - 运行时间, 单位 ms; 返回值说明 : void - 无返回值 ; 设置动画属性开始值函数 /* 设置动画开始值 */ void mgeffanimationsetstartvalue (MGEFF_ANIMATION handle, const void * 参数说明 : handle - 动画对象句柄 ; value - value 是 void* 型, 这就允许往里面传入任意类型的指针 这么设计的原因是动画要控制的属性可能有多种类型, 例如整型 浮点型甚至是结构体, 所以这里并不限定具体的类型 而这一类型将在动画创建时指定, 具体请参考 创建和运行动画 一章中对 mgeffanimationcreate 函数的介绍 在调用上述两个函数设置属性的起止值时, 应

20 MGEffV1dot0PGC05 < Main < TWiki Page 2 of 3 返回值说明 : 该传入创建动画时所约定类型的指针, 否则会导致不可预料的程序错误! void - 无返回值 ; 设置动画属性结束值函数 /* 设置动画结束值 */ void mgeffanimationsetendvalue (MGEFF_ANIMATION handle, const void *va 参数说明 : handle - 动画对象句柄 ; value - 和传入 mgeffanimationsetstartvalue 的值的类型一致 ; 返回值说明 : void - 无返回值 ; 使用示例 仍以之前的示例代码片段为例, 介绍这几个函数的使用 : /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION; start_val = START_VAL; end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) prop /* set animation property */ /* duration */ mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */ mgeffanimationsetendvalue (animation, &end_val); /* running */

21 MGEffV1dot0PGC05 < Main < TWiki Page 3 of 3 mgeffanimationsyncrun (animation); /* delete the animation object */ mgeffanimationdelete (animation); return 0; 上述代码中,startvalue 和 endvalue 是 RGB 颜色中红色值的起始值和结束值, 改动画运行的效果就是将红色值从 0x00 变化到 0xFF 运行结果 本章小结 本章介绍了动画的几项运行时的参数, 包括属性起止值和持续时间,mGEff 会在动画运行过程中将属性值按照一定的变化规律 ( 动画曲线 ), 从起始值变化到结束值 并将变化值通过帧回调函数通知给用户, 用户可以根据这些绘制动画的每一帧 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

22 MGEffV1dot0PGC06 < Main < TWiki Page 1 of 3 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC06 r10-14 Feb :54:38 - XuBinWang 动力曲线 动力曲线函数原型设置动力曲线函数预置的动力曲线类型曲线示例运行结果本章小结 动力曲线 前面的章节介绍了如何创建及运行一个动画, 通过执行程序得到的控制台输出可以看到从起始值到终止值的变化过程 但同时也可以看到属性值在起止值之间的变化是均匀的, 即为线性变化 如果将这种变化应用到实际动画得到的效果会比较直接和呆板, 而用户往往需要将属性值进行诸如加速 减速甚至振荡等非线性的变化, 以便达到更灵活真实的动画特效, 这就需要用到 mgeff 中的另一个特性 动力曲线, 本章介绍的及时如何通过它控制动画的运行, 以达到属性值的不同变化效果 函数原型 mgeff 提供了一个函数用于设置动力曲线, 其原型如下 : 设置动力曲线函数 void mgeffanimationsetcurve(mgeff_animation handle, enum EffMotionTyp 参数说明 : handle - 要设置动力曲线的动画句柄 ; type - 预置曲线的类型, 类型见下一节 ; 返回值说明 : void - 无返回值 ; 预置的动力曲线类型 mgeff 中预置了几十种动力曲线以便用户选用, 通过给动画设置这些不同的曲线可以达到各种变化效果 : enum EffMotionType Linear, /* 线性曲线, 动画创建后默认的曲线类型 */ InQuad, OutQuad, InOutQuad, OutInQuad, InCubic, OutCubic, InOutCubic, OutInCubic, InQuart, OutQuart, InOutQuart, OutInQuart, InQuint, OutQuint, InOutQuint, OutInQuint, InSine, OutSine, InOutSine, OutInSine,

23 MGEffV1dot0PGC06 < Main < TWiki Page 2 of 3 ; InExpo, OutExpo, InOutExpo, OutInExpo, InCirc, OutCirc, InOutCirc, OutInCirc, InElastic, OutElastic, InOutElastic, OutInElastic, InBack, OutBack, InOutBack, OutInBack, InBounce, OutBounce, InOutBounce, OutInBounce, InCurve, OutCurve, SineCurve, CosineCurve, Custom, NCurveTypes 曲线示例 在这里我们对之前的示例代码进行扩充, 其值按照 InQuad 曲线方式变化 : /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION; start_val = START_VAL; end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) prope /* set animation property */ /* duration */ mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */ mgeffanimationsetendvalue (animation, &end_val); /* set curve */ mgeffanimationsetcurve (animation, InQuad); /* running */ mgeffanimationsyncrun (animation);

24 MGEffV1dot0PGC06 < Main < TWiki Page 3 of 3 /* delete the animation object */ mgeffanimationdelete (animation); return 0; 从执行结果可以看到改变动画的动力曲线后, 与之前默认的线性变化输出的插值有了明显的区别 : 属性值呈加速规律变化 可以想像如果将 printf 语句替换为真正设置对象属性的代码后 ( 如修改圆的半径, 矩形的宽高等 ), 使动画带有变速效果 运行结果 本章小结 本章介绍了动力曲线的作用及预置曲线的使用方法, 不同的曲线会给动画带来不同的变化效果, 使动画更加真实和灵活 在后面的章节中, 还会介绍自定义曲线的使用方法 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

25 MGEffV1dot0PGC07 < Main < TWiki Page 1 of 3 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC07 r11-14 Feb :14:36 - XuBinWang 动画的属性 动画的属性函数原型设置动画属性函数获取动画属性函数 mgeff 支持的动画属性使用示例运行结果本章小结 动画的属性 在开始这一章之前, 需要先明确两个概念 属性动画 和 动画的属性 : 属性动画, 指的是通过修改动画中某个目标对象的某些属性, 比如大小, 颜色等来达到目标对象动态变化的一种动画 ; 动画的属性, 指的是这个动画自身的一些属性, 比如前一章所说的运行时间, 总的运行次数, 当前运行次数等之类的属性 两者不可混淆 函数原型 mgeff 提供了如下函数来设置和获取动画的属性, 其原型如下 : 设置动画属性函数 void mgeffanimationsetproperty(mgeff_animation handle, enum EffAnimPro 参数说明 : handle - 动画对象句柄 ; id - 属性的标志, 具体值可参考 EffAnimProperty? 枚举定义 ; value - 要设置的属性值 ; 返回值说明 : void - 无返回值 ; 获取动画属性函数 int mgeffanimationgetproperty(mgeff_animation handle, enum EffAnimProp 参数说明 : handle - 动画对象句柄 ; id - 属性的标志, 具体值可参考 EffAnimProperty? 枚举定义 ; 返回值说明 :

26 MGEffV1dot0PGC07 < Main < TWiki Page 2 of 3 int - 当前属性值 ; mgeff 支持的动画属性 目前 mgeff 支持的动画属性定义如下 : enum EffAnimProperty MGEFF_PROP_DURATION = 0, /* 可读写属性, 动画执行一次的持续时间 MGEFF_PROP_CURLOOP = 1, /* 只读属性, 动画当前循环运行的次数 * MGEFF_PROP_LOOPCOUNT = 2, /* 可读写属性, 动画循环运行的次数 * MGEFF_PROP_DIRECTION = 3, /* 可读写属性, 动画运行的方向 */ MGEFF_PROP_CURFRAME = 4, /* 只读属性, 当前帧 */ MGEFF_PROP_STATE = 5, /* 只读属性, 当前状态 */ MGEFF_PROP_MAX ; 请注意上述属性的注释, 里面指明了哪些属性的只读属性, 哪些属性是可以设置的, 在使用过程应该区分开来 使用示例 下面通过扩展之前的示例来演示如何设置和获取动画的属性 : /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int /* set animation property */ g_value = *value; /* get current loop */ g_loop = mgeffanimationgetproperty (handle, MGEFF_PROP_CURLOOP /* update */ InvalidateRect (hwnd, NULL, TRUE); /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION; start_val = START_VAL;

27 MGEffV1dot0PGC07 < Main < TWiki Page 3 of 3 end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) prope /* set animation property */ /* set loopcount */ mgeffanimationsetproperty (animation, MGEFF_PROP_LOOPCOUNT, LOO /* duration */ mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */ mgeffanimationsetendvalue (animation, &end_val); /* running */ mgeffanimationsyncrun (animation); /* delete the animation object */ mgeffanimationdelete (animation); return 0; 上例中在创建动画时指定了动画的 MGEFF_PROP_LOOPCOUNT 属性为 3, 即动画运行后将循环 3 次 并在属性变化回调函数里获得当前循环过的次数 运行结果 本章小结 本章主要介绍了 属性动画 与 动画属性 两个概念的区别, 并针对 动画属性 的设置与获取进行了介绍 通过动画的属性, 可以很方便的操作动画的一些行为 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

28 MGEffV1dot0PGC08 < Main < TWiki Page 1 of 3 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC08 r11-14 Feb :15:05 - XuBinWang 动画上下文 动画上下文函数原型设置动画上下文函数获取动画上下文函数使用示例运行结果上下文生命域本章小结 动画上下文 一个动画可以设置上下文以便携带更多的用户信息, 该特性常被用在属性变化回调函数里面 函数原型 mgeff 提供了如下函数用来设置和获取动画的上下文 其原型如下 : 设置动画上下文函数 void mgeffanimationsetcontext(mgeff_animation handle, void* context); 参数说明 : handle - 动画对象句柄 ; context - 上下文信息指针 ; 返回值说明 : void - 无返回值 ; 获取动画上下文函数 void *mgeffanimationgetcontext(mgeff_animation handle); 参数说明 : handle - 从句柄为 handle 的动画中获取上下文信息 ; 返回值说明 : context - 动画对象的上下文信息指针 ; 通过上面两个函数, 可以设置和获得动画的上下文 上下文指针都是 void* 型的, 表明可以接收任意类型的指针, 其具体的类型由用户约定, 这里需要注意一个生命域的问题, 下面将有一节专门讲解这个 使用示例

29 MGEffV1dot0PGC08 < Main < TWiki Page 2 of 3 同样以之前的示例片断为例来介绍这一特性的使用方法 : /* callback of property */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int MY_CONTEXT *pcontext; /* get and print context */ pcontext = (MY_CONTEXT *)mgeffanimationgetcontext (handle); if (pcontext->value!= *value) pcontext->value = *value; printf ("CONTEXT: name(%s) value(%d)\n", pcontext->nam /* set animation property */ g_value = *value; /* get current loop */ g_loop = mgeffanimationgetproperty (handle, MGEFF_PROP_CURLOOP /* update */ InvalidateRect (hwnd, NULL, TRUE); /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION; start_val = START_VAL; end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) prop /* set animation property */ /* set loopcount */ mgeffanimationsetproperty (animation, MGEFF_PROP_LOOPCOUNT, LO /* duration */

30 MGEffV1dot0PGC08 < Main < TWiki Page 3 of 3 mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */ mgeffanimationsetendvalue (animation, &end_val); /* set context */ mgeffanimationsetcontext (animation, (void *)&g_my_context); /* running */ mgeffanimationsyncrun (animation); /* delete the animation object */ mgeffanimationdelete (animation); return 0; 运行结果 上下文生命域 由于动画上下文只是一个 void* 型的指针, 所以使用时具体类型要由用户来约定, 如果用户为上下文动态分配了空间, 也应该自己在动画完成后将其释放 另外需要注意的是如果上下文是在栈上分配的, 而动画以异步方式运行 ( 详情请参考 动画运行方式 一章 ), 那么很可能在动画的属性变化回调被调用时已经离开了上下文的生命域, 此时获得到的上下文指针已经指向无效的内容, 将会导致不可预料的运行错误, 例如将上例中的 mgeffanimationsyncrun 函数替换为 mgeffanimationasyncrun, 就可能会出现这种情况, 因为 context 数组是在栈上的 要避免这种情况发生有多种方法, 比如可以在离开 context 生命域之前调用 mgeffanimationwait 函数等待异步动画结束, 或者在堆上分配 context 空间, 并在动画结束时释放 ( 至于如何掌握动画的结束时机, 请参考 回调函数 章节 ) 本章小结 本章介绍了动画上下文这一特性及其应用方式, 通过上下文要以给动画附加更多信息并在有需要的地方获取这些信息 不过用户需要保证 context 的生命周期不能短于动画生命周期, 以防止出现在动画执行中获取不到正确上下文的情况 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

31 MGEffV1dot0PGC09 < Main < TWiki Page 1 of 8 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC09 r10-14 Feb :00:35 - XuBinWang 动画的运行方式及控制 动画的运行方式函数原型同步运行动画函数异步运行动画函数等待异步动画运行结束函数暂停动画运行函数恢复动画运行函数停止动画运行函数使用示例运行结果注意事项本章小结 动画的运行方式 动画支持同步及异步两种不同的执行方式 采用同步方式运行的动画, 程序阻塞在运行函数上, 直到动画结合, 函数返回, 程序才继续运行, 在这个过程中程序将无法响应消息 ; 而采用异步方式运行的动画, 运行函数调用后立即返回, 此时动画在后台被调度执行, 直到被中止或结束, 而程序可以相应消息处理 下面将分别介绍这两种运行方式的使用和控制 函数原型 截止到本章为止, 我们在所有的示例程序中的动画都是以同步方式运行的, 同步动画的使用比较简单, 直接在动画创建后调用 mgeffanimationsyncrun 函数就可以开始动画并且直到其结束才返回, 整个过程是阻塞的, 在此期间程序是不能响应消息处理 接下我们开始介绍异步运行动画函数和如何控制动画的运行 mgeff 提供了以下几个函数来运行和控制动画 其原型分别为 : 同步运行动画函数 int mgeffanimationsyncrun(mgeff_animation handle); 参数说明 : handle - 动画对象句柄 ; 返回值说明 : int - 0; 异步运行动画函数 int mgeffanimationasyncrun(mgeff_animation handle);

32 MGEffV1dot0PGC09 < Main < TWiki Page 2 of 8 参数说明 : handle - 动画对象句柄 ; 返回值说明 : *int - 0; 等待异步动画运行结束函数 MGEFF_BOOL mgeffanimationwait(void* phwnd, MGEFF_ANIMATION handle); 参数说明 : phwnd - 当前线程的窗体句柄的地址 ; handle - 动画对象句柄 ; 返回值说明 : MGEFF_BOOL - 成功返回 MGEFF_TRUE, 否则返回 MGEFF_FALSE 暂停动画运行函数 void mgeffanimationpause(mgeff_animation handle); 参数说明 : * handle - 动画对象句柄 ; 返回值说明 : void - 无返回值 ; 恢复动画运行函数 void mgeffanimationresume(mgeff_animation handle); 参数说明 : * handle - 动画对象句柄 ; 返回值说明 : void - 无返回值 ; 停止动画运行函数 void mgeffanimationstop(mgeff_animation handle); 参数说明 : * handle - 动画对象句柄 ; 返回值说明 : void - 无返回值 ; 使用示例 #include <stdio.h> #include <string.h> #include <minigui/common.h> #include <minigui/gdi.h>

33 MGEffV1dot0PGC09 < Main < TWiki Page 3 of 8 #include <minigui/window.h> #include <minigui/minigui.h> #include <mgeff/mgeff.h> /********************************************************************** #define CAPTION "animation_control" #define BAR_HEIGHT 50 #define DURATION (20 * 1000) #define START_VAL 0x00 #define END_VAL 0xFF /********************************************************************** static char g_str[64]; static int g_value = 0x00; static MGEFF_ANIMATION g_handle = NULL; /********************************************************************** /* main window proc */ static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPARA /* draw a frame */ static void draw_frame (HWND hwnd); /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int i /* create and run an animation */ static int do_animation (HWND hwnd); /********************************************************************** int MiniGUIMain (int argc, const char *argv[]) HWND hmainhwnd; MAINWINCREATE createinfo; MSG msg; #ifdef _MGRM_PROCESSES JoinLayer (NAME_DEF_LAYER, "animation", 0, 0); #endif createinfo.dwstyle = WS_VISIBLE WS_BORDER WS_CAPTION; createinfo.dwexstyle = WS_EX_NONE; createinfo.spcaption = CAPTION; createinfo.hmenu = 0; createinfo.hcursor = GetSystemCursor (0); createinfo.hicon = 0; createinfo.mainwindowproc = mainwindowproc; createinfo.lx = 0; createinfo.ty = 0; createinfo.rx = 240;

34 MGEffV1dot0PGC09 < Main < TWiki Page 4 of 8 createinfo.by = 320; createinfo.ibkcolor = COLOR_lightwhite; createinfo.dwadddata = 0; createinfo.hhosting = HWND_DESKTOP; hmainhwnd = CreateMainWindow (&createinfo); if (hmainhwnd == HWND_INVALID) return -1; ShowWindow (hmainhwnd, SW_SHOWNORMAL); while (GetMessage (&msg, hmainhwnd)) TranslateMessage (&msg); DispatchMessage (&msg); MainWindowThreadCleanup (hmainhwnd); return 0; /********************************************************************** /* main window proc */ static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPARA switch (message) case MSG_CREATE: /* init mgeff library */ mgeffinit (); sprintf (g_str, "you can press any key."); do_animation (hwnd); break; case MSG_KEYDOWN: sprintf (g_str, "you press key, keycode(%d)", wparam); printf ("%s\n", g_str); if (g_handle!= NULL) if (wparam == SCANCODE_S) /* stop animation */ mgeffanimationstop (g_handle); sprintf (g_str, "stop animation");

35 MGEffV1dot0PGC09 < Main < TWiki Page 5 of 8 if (wparam == SCANCODE_P) /* pause animation */ mgeffanimationpause (g_handle); sprintf (g_str, "pause animation"); if (wparam == SCANCODE_R) /* resume animation */ mgeffanimationresume (g_handle); sprintf (g_str, "resume animation"); InvalidateRect (hwnd, NULL, TRUE); break; case MSG_PAINT: draw_frame (hwnd); break; case MSG_CLOSE: DestroyMainWindow (hwnd); PostQuitMessage (hwnd); /* deinit mgeff library */ mgeffdeinit (); break; default: break; return DefaultMainWinProc (hwnd, message, wparam, lparam); /* draw a frame */ static void draw_frame (HWND hwnd) HDC dc; RECT rc; int client_w, client_h; char str[64]; int color; /* begin draw */ dc = BeginPaint (hwnd);

36 MGEffV1dot0PGC09 < Main < TWiki Page 6 of 8 /* get client rect */ GetClientRect (hwnd, &rc); client_w = RECTW (rc); client_h = (RECTH (rc) - BAR_HEIGHT) * g_value / (END_VAL - STA color = g_value; /* set brush and draw area */ SetBrushColor (dc, RGB2Pixel (dc, color, 0x00, 0x00)); FillBox (dc, 0, BAR_HEIGHT, client_w, client_h); /* draw the text */ sprintf (str, "current color: RGB(%d,0,0)", color); TextOut (dc, 0, 0, str); /* print information */ TextOut (dc, 0, BAR_HEIGHT / 2, g_str); EndPaint (hwnd, dc); /* end draw */ /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int i /* set animation property */ g_value = *value; /* update */ InvalidateRect (hwnd, NULL, TRUE); /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION;

37 MGEffV1dot0PGC09 < Main < TWiki Page 7 of 8 start_val = START_VAL; end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) prope g_handle = animation; /* set animation property */ /* duration */ mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */ mgeffanimationsetendvalue (animation, &end_val); /* set loopcount */ // mgeffanimationsetproperty (animation, MGEFF_PROP_LOOPCOUN /* running */ mgeffanimationasyncrun (animation); /* wait animation stop */ mgeffanimationwait ((void *) &hwnd, animation); g_handle = NULL; /* delete the animation object */ mgeffanimationdelete (animation); return 0; 运行结果 注意事项 上述几个函数禁止用于同步运行动画对象 本章小结 本章介绍了动画的两种运行方式 同步和异步 这两种方式有各自的应用场景, 现将其优缺点整理如下 : 同步动画

38 MGEffV1dot0PGC09 < Main < TWiki Page 8 of 8 优点 缺点 异步动画 优点 缺点 使用简单 易于掌握生命周期 运行时程序无法响应其它消息 运行时程序仍然可以响应其它消息 用户可能需要自行控制其生命周期 涉及的函数较多, 使用稍为复杂 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

39 MGEffV1dot0PGC10 < Main < TWiki Page 1 of 7 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC10 r13-14 Feb :16:17 - XuBinWang 动画组 动画组函数原型创建动画组函数添加到动画组函数一点概念使用示例并行动画组串行动画组本章小结 动画组 在实际应用中, 用户往往不只是希望同时执行一个动画, 而是需要将多个动画关联起来并行或串行地执行, 以获得更复杂的动画效果 所以 mgeff 引入了动画组机制, 用户可以通过创建并行 (Parallel) 或串行 (Sequential) 组来达到执行一组动画的需求 并行组动画并行组的特点是当动画组执行时组内所有动画都同时被调度, 表现的效果是这些动画同时在进行, 组动画的总运行时间由最长的那个动画运行时间决定 串行组动画串行组的特点是动画组执行时组内动画将被顺序调度, 表现的效果是这些动画分先后秩序进行, 组动画的总运行时间为所有动画运行时间的和 另外可以将一个动画组当作一个动画添加到另一个组, 其调度规则同上 函数原型 mgeff 提供了如下几个函数用于支持动画组的创建和使用 其函数原型如下 : 创建动画组函数 MGEFF_ANIMATION mgeffanimationcreategroup(enum EffAnimationType type); 参数说明 : type - 动画组类型, 可以是 MGEFF_PARALLEL ( 并行 ) 和 MGEFF_SEQUENTIAL ( 串行 ) 二值之一 ; 返回值说明 : handle - 成功返回动画组句柄, 否则返回 NULL; 添加到动画组函数 /** * 将一个动画加入动画组

40 MGEffV1dot0PGC10 < Main < TWiki Page 2 of 7 */ void mgeffanimationaddtogroup(mgeff_animation group, MGEFF_ANIMATION an 参数说明 : group - 动画组句柄 ; animation - 将加入 group 中的动画句柄 ; 返回值说明 : void - ; 一点概念 从函数原型可以看到, 动画组的句柄和动画句柄是同样的类型, 前面介绍过 mgeff 的设计上采用了一些面向对象思想, 动画组对象从动画对象 继承 而来 动画组也是一种动画, 之前介绍过的动画属性 上下文和运行方式相关的函数均可作用于动画组, 这一点将在下一节的示例中展示出来 使用示例 并行动画组 #include <stdio.h> #include <string.h> #include <minigui/common.h> #include <minigui/gdi.h> #include <minigui/window.h> #include <minigui/minigui.h> #include <mgeff/mgeff.h> /********************************************************************** #define CAPTION "group_animation_parallel" #define BAR_HEIGHT 50 #define DURATION (5 * 1000) #define START_VAL 0x00 #define END_VAL 0xFF #define ANIMATION_NUM 3 /********************************************************************** static int g_color[animation_num] = 0 ; /********************************************************************** /* main window proc */ static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPARA /* draw a frame */ static void draw_frame (HWND hwnd); /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int i

41 MGEffV1dot0PGC10 < Main < TWiki Page 3 of 7 /* create and run an animation */ static int do_animation (HWND hwnd); /********************************************************************** int MiniGUIMain (int argc, const char *argv[]) HWND hmainhwnd; MAINWINCREATE createinfo; MSG msg; #ifdef _MGRM_PROCESSES JoinLayer (NAME_DEF_LAYER, "animation", 0, 0); #endif createinfo.dwstyle = WS_VISIBLE WS_BORDER WS_CAPTION; createinfo.dwexstyle = WS_EX_NONE; createinfo.spcaption = CAPTION; createinfo.hmenu = 0; createinfo.hcursor = GetSystemCursor (0); createinfo.hicon = 0; createinfo.mainwindowproc = mainwindowproc; createinfo.lx = 0; createinfo.ty = 0; createinfo.rx = 240; createinfo.by = 320; createinfo.ibkcolor = COLOR_lightwhite; createinfo.dwadddata = 0; createinfo.hhosting = HWND_DESKTOP; hmainhwnd = CreateMainWindow (&createinfo); if (hmainhwnd == HWND_INVALID) return -1; ShowWindow (hmainhwnd, SW_SHOWNORMAL); while (GetMessage (&msg, hmainhwnd)) TranslateMessage (&msg); DispatchMessage (&msg); MainWindowThreadCleanup (hmainhwnd); return 0; /**********************************************************************

42 MGEffV1dot0PGC10 < Main < TWiki Page 4 of 7 static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPARA switch (message) case MSG_CREATE: /* init mgeff library */ mgeffinit (); do_animation (hwnd); break; case MSG_PAINT: draw_frame (hwnd); break; case MSG_CLOSE: DestroyMainWindow (hwnd); PostQuitMessage (hwnd); /* deinit mgeff library */ mgeffdeinit (); break; default: break; return DefaultMainWinProc (hwnd, message, wparam, lparam); static void draw_frame (HWND hwnd) HDC dc; RECT rc; int client_w, client_h; char str[animation_num][64]; dc = BeginPaint (hwnd); /* get client rect */ GetClientRect (hwnd, &rc); client_w = RECTW (rc); client_h = RECTH (rc);// - BAR_HEIGHT) * g_value / (END_VAL - S /* draw */ /* red */ SetBrushColor (dc, RGB2Pixel (dc, g_color[0], 0, 0));

43 MGEffV1dot0PGC10 < Main < TWiki Page 5 of 7 FillBox (dc, 0, client_h * 0 / ANIMATION_NUM, client_w, client_ sprintf (str[0], "%d", g_color[0]); TextOut (dc, 0, client_h * 0 / ANIMATION_NUM, str[0]); /* green */ SetBrushColor (dc, RGB2Pixel (dc, 0, g_color[1], 0)); FillBox (dc, 0, client_h * 1 / ANIMATION_NUM, client_w, client_ sprintf (str[1], "%d", g_color[1]); TextOut (dc, 0, client_h * 1 / ANIMATION_NUM, str[1]); /* blue */ SetBrushColor (dc, RGB2Pixel (dc, 0, 0, g_color[2])); FillBox (dc, 0, client_h * 2 / ANIMATION_NUM, client_w, client_ sprintf (str[2], "%d", g_color[2]); TextOut (dc, 0, client_h * 2 / ANIMATION_NUM, str[2]); EndPaint (hwnd, dc); static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int i g_color[id] = *value; InvalidateRect (hwnd, NULL, TRUE); static int do_animation (HWND hwnd) MGEFF_ANIMATION animation[animation_num]; MGEFF_ANIMATION group_animation; int duration;; int start_val; int end_val; int i; /* set value */ duration = DURATION; start_val = START_VAL; end_val = END_VAL; /* create an animation group */ group_animation = mgeffanimationcreategroup (MGEFF_PARALLEL); //group_animation = mgeffanimationcreategroup (MGEFF_SEQUENTIAL

44 MGEffV1dot0PGC10 < Main < TWiki Page 6 of 7 /* create and animation and add it to a group */ for (i = 0; i < ANIMATION_NUM; i++) /* create animation */ animation[i] = mgeffanimationcreate ((void *) hwnd, (vo /* set property */ /* duration */ mgeffanimationsetduration (animation[i], duration); /* start value */ mgeffanimationsetstartvalue (animation[i], &start_val); /* end value */ mgeffanimationsetendvalue (animation[i], &end_val); /* add animation to group */ mgeffanimationaddtogroup (group_animation, animation[i] /* running */ mgeffanimationasyncrun (group_animation); /* wait animation end */ mgeffanimationwait ((void *) &hwnd, group_animation); /* delete the animation object */ mgeffanimationdelete (group_animation); return 0; 串行动画组 只要将上个示例中的创建动画组函数调用替换成下面这句, 就可以实现一个串行动画组 : /*... */ group = mgeffanimationcreategroup(mgeff_sequential); /*... */ 本章小结 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd.

45 MGEffV1dot0PGC10 < Main < TWiki Page 7 of 7 Ideas, requests, problems regarding TWiki? Send feedback

46 MGEffV1dot0PGC11 < Main < TWiki Page 1 of 9 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC11 r16-14 Feb :17:22 - XuBinWang 动画回调函数 回调函数函数原型动画结束时的回调函数动画循环次数改变时的回调函数动画运行方向改变时的回调函数动画状态改变时的回调函数使用示例运行结果本章小结 回调函数 在 mgeff 的动画播放或其状态发生改变时, 框架会尝试调用用户设置的回调函数, 以便让用户做出一些相应的处理, 下面介绍一下这些回调函数 : 函数原型 动画结束时的回调函数 如果用户设置了动画结束回调函数, 将在动画播放完后被调用, 一般可以用来在动画结束时释放资源 具体回调函数原型和设置回调的 API 如下 : /* 动画结束时调用的回调原型 */ typedef void (*MGEFF_FINISHED_CB)(MGEFF_ANIMATION handle); 参数说明 : handle - 动画对象句柄 ; 返回值说明 : void - 无返回值 ; /* 设置动画结束时要调用的回调函数 */ void mgeffanimationsetfinishedcb(mgeff_animation handle, MGEFF_FINISHE 参数说明 : handle - 动画对象句柄 ; cb - 回调函数指针 ; 返回值说明 : void - 无返回值 ; 动画循环次数改变时的回调函数 当动画循环次数发生改变, 而且用户设置了相应的回调函数时,mGEff 会调用这个回调函数 :

47 MGEffV1dot0PGC11 < Main < TWiki Page 2 of 9 /* 动画循环次数发生改变时调用的回调原型 */ typedef void (*MGEFF_CURLOOPCHANGED_CB)(MGEFF_ANIMATION handle); 参数说明 : handle - 动画对象句柄 ; 返回值说明 : void - 无返回值 ; /* 设置动画循环次数改变时要调用的回调函数 */ void mgeffanimationsetcurloopchangedcb(mgeff_animation handle, MGEFF_C 参数说明 : handle - 动画对象句柄 ; cb - 回调函数指针 ; 返回值说明 : void - 无返回值 ; 动画运行方向改变时的回调函数 当动画的运行方向发生改变, 而且用户设置了相应的回调函数时, 该回调将被 mgeff 调用 : /* 动画运行方向发生改变时调用的回调原型 */ typedef void (*MGEFF_DIRCHANGED_CB)(MGEFF_ANIMATION handle); 参数说明 : handle - 动画对象句柄 ; 返回值说明 : void - 无返回值 ; /* 设置动画运行方向改变时要调用的回调函数 */ void mgeffanimationsetdirchangedcb(mgeff_animation handle, MGEFF_DIRCH 参数说明 : handle - 动画对象句柄 ; cb - 回调函数指针 ; 返回值说明 : void - 无返回值 ; 动画状态改变时的回调函数 当动画的状态发生改变, 而且用户设置了相应的回调函数时, 该回调将被 mgeff 调用 : /* 动画状态发生改变时调用的回调原型 */ typedef void (*MGEFF_STATECHANGED_CB)(MGEFF_ANIMATION handle, enum Eff 参数说明 :

48 MGEffV1dot0PGC11 < Main < TWiki Page 3 of 9 handle - 动画对象句柄 ; neweffstate - 新的状态值 ; oldeffstate - 旧的状态值 ; 返回值说明 : void - 无返回值 ; /* 设置动画状态改变时要调用的回调函数 */ void mgeffanimationsetstatechangedcb(mgeff_animation handle, MGEFF_STA 参数说明 : handle - 动画对象句柄 ; cb - 回调函数指针 ; 返回值说明 : void - 无返回值 ; 使用示例 #include <stdio.h> #include <string.h> #include <minigui/common.h> #include <minigui/gdi.h> #include <minigui/window.h> #include <minigui/minigui.h> #include <mgeff/mgeff.h> /********************************************************************* #define CAPTION "animation_callback" #define BAR_HEIGHT 50 #define DURATION (20 * 1000) #define LOOPCOUNT 3 #define START_VAL 0x00 #define END_VAL 0xFF /********************************************************************* static char g_str[64]; static int g_value = 0x00; static int g_loop = 0; /********************************************************************* /* main window proc */ static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPAR /* draw a frame */ static void draw_frame (HWND hwnd); /* callback function called when property change */

49 MGEffV1dot0PGC11 < Main < TWiki Page 4 of 9 static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int i /* create and run an animation */ static int do_animation (HWND hwnd); /* callback function called when animation finished */ static void finished_callback (MGEFF_ANIMATION handle); /* callback function called when animation loop count is changed */ static void curloopchanged_callback (MGEFF_ANIMATION handle); /* callback function called when animation direction changed */ static void dirchanged_callback (MGEFF_ANIMATION handle); /* callback function called when animation state changed */ static void statechanged_callback (MGEFF_ANIMATION handle, enum EffStat /********************************************************************** int MiniGUIMain (int argc, const char *argv[]) HWND hmainhwnd; MAINWINCREATE createinfo; MSG msg; #ifdef _MGRM_PROCESSES JoinLayer (NAME_DEF_LAYER, "animation", 0, 0); #endif createinfo.dwstyle = WS_VISIBLE WS_BORDER WS_CAPTION; createinfo.dwexstyle = WS_EX_NONE; createinfo.spcaption = CAPTION; createinfo.hmenu = 0; createinfo.hcursor = GetSystemCursor (0); createinfo.hicon = 0; createinfo.mainwindowproc = mainwindowproc; createinfo.lx = 0; createinfo.ty = 0; createinfo.rx = 240; createinfo.by = 320; createinfo.ibkcolor = COLOR_lightwhite; createinfo.dwadddata = 0; createinfo.hhosting = HWND_DESKTOP; hmainhwnd = CreateMainWindow (&createinfo); if (hmainhwnd == HWND_INVALID) return -1; ShowWindow (hmainhwnd, SW_SHOWNORMAL); while (GetMessage (&msg, hmainhwnd))

50 MGEffV1dot0PGC11 < Main < TWiki Page 5 of 9 TranslateMessage (&msg); DispatchMessage (&msg); MainWindowThreadCleanup (hmainhwnd); return 0; /********************************************************************** /* main window proc */ static int mainwindowproc (HWND hwnd, int message, WPARAM wparam, LPARA switch (message) case MSG_CREATE: /* init mgeff library */ mgeffinit (); sprintf (g_str, "you can press any key."); do_animation (hwnd); break; case MSG_KEYDOWN: sprintf (g_str, "you press key, keycode(%d)", wparam); printf ("%s\n", g_str); InvalidateRect (hwnd, NULL, TRUE); break; case MSG_PAINT: draw_frame (hwnd); break; case MSG_CLOSE: DestroyMainWindow (hwnd); PostQuitMessage (hwnd); /* deinit mgeff library */ mgeffdeinit (); break; default: break; return DefaultMainWinProc (hwnd, message, wparam, lparam);

51 MGEffV1dot0PGC11 < Main < TWiki Page 6 of 9 /* draw a frame */ static void draw_frame (HWND hwnd) HDC dc; RECT rc; int client_w, client_h; char str[64]; int color; /* begin draw */ dc = BeginPaint (hwnd); /* get client rect */ GetClientRect (hwnd, &rc); client_w = RECTW (rc); client_h = (RECTH (rc) - BAR_HEIGHT) * g_value / (END_VAL - STA color = g_value; /* set brush and draw area */ SetBrushColor (dc, RGB2Pixel (dc, color, 0x00, 0x00)); FillBox (dc, 0, BAR_HEIGHT, client_w, client_h); /* draw the text */ sprintf (str, "current color: RGB(%d,0,0)", color); TextOut (dc, 0, 0, str); /* print information */ TextOut (dc, 0, BAR_HEIGHT / 3, g_str); /* print curloop */ sprintf (str, "current loop: (%d)", g_loop); TextOut (dc, 0, 2 * BAR_HEIGHT / 3, str); EndPaint (hwnd, dc); /* end draw */ /* callback function called when property change */ static void property_callback (MGEFF_ANIMATION handle, HWND hwnd, int i

52 MGEffV1dot0PGC11 < Main < TWiki Page 7 of 9 /* set animation property */ g_value = *value; /* get current loop */ g_loop = mgeffanimationgetproperty (handle, MGEFF_PROP_CURLOOP) /* update */ InvalidateRect (hwnd, NULL, TRUE); /* create and run an animation */ static int do_animation (HWND hwnd) MGEFF_ANIMATION animation; int animation_id = 1; int duration; int start_val; int end_val; /* set value */ duration = DURATION; start_val = START_VAL; end_val = END_VAL; /* create animation object */ animation = mgeffanimationcreate ((void *) hwnd, (void *) prope /* set animation property */ /* set loopcount */ mgeffanimationsetproperty (animation, MGEFF_PROP_LOOPCOUNT, LOO /* duration */ mgeffanimationsetduration (animation, duration); /* start value */ mgeffanimationsetstartvalue (animation, &start_val); /* end value */ mgeffanimationsetendvalue (animation, &end_val); /* set callback */ mgeffanimationsetfinishedcb (animation, finished_callback); mgeffanimationsetcurloopchangedcb (animation, curloopchanged_ca mgeffanimationsetdirchangedcb (animation, dirchanged_callback); mgeffanimationsetstatechangedcb (animation, statechanged_callba /* running */

53 MGEffV1dot0PGC11 < Main < TWiki Page 8 of 9 mgeffanimationasyncrun (animation); /* wait animation stop */ mgeffanimationwait ((void *) &hwnd, animation); /* delete the animation object */ mgeffanimationdelete (animation); return 0; /* callback function called when animation finished */ static void finished_callback (MGEFF_ANIMATION handle) printf ("finished_callback is called.\n"); /* callback function called when animation loop count is changed */ static void curloopchanged_callback (MGEFF_ANIMATION handle) int cur_loop; printf ("curloopchanged_callback is called.\n"); cur_loop = mgeffanimationgetproperty (handle, MGEFF_PROP_CURLOO printf ("current loop : %d\n", cur_loop); /* callback function called when animation direction changed */ static void dirchanged_callback (MGEFF_ANIMATION handle) int direction; printf ("dirchanged_callback is called.\n"); direction = mgeffanimationgetproperty (handle, MGEFF_PROP_DIREC printf ("current direction : %d\n", direction); /* callback function called when animation state changed */ static void statechanged_callback (MGEFF_ANIMATION handle, enum EffStat int state; printf ("statechanged_callback is called.\n");

54 MGEffV1dot0PGC11 < Main < TWiki Page 9 of 9 state = mgeffanimationgetproperty (handle, MGEFF_PROP_STATE); printf ("current state : %d\n", state); printf ("new state : %d\n", neweffstate); printf ("old state : %d\n", oldeffstate); 运行结果 statechanged_callback is called. current state : 0 new state : 3 old state : 0 statechanged_callback is called. current state : 3 new state : 2 old state : 3 curloopchanged_callback is called. current loop : 1 curloopchanged_callback is called. current loop : 2 curloopchanged_callback is called. current loop : 3 statechanged_callback is called. current state : 2 new state : 0 old state : 2 finished_callback is called. 本章小结 本章介绍了 mgeff 框架中的一些回调函数, 通过设置这些回调函数, 可以在动画的各个阶段以及状态发生改变时被框架所调用, 这就可以让用户在动画的不同阶段做出不同的处理 -- XuBinWang - 12 Jan 2011 Copyright by Beijing FMSoft Technologies Co., Ltd. Ideas, requests, problems regarding TWiki? Send feedback

55 MGEffV1dot0PGC12 < Main < TWiki Page 1 of 9 TWiki > Main Web > MiniGUI > MGEffV1dot0ProgrammingGuide > MGEffV1dot0PGC12 r5-14 Feb :25:00 - XuBinWang 特效器 特效器函数原型创建特效器函数删除特效器函数通过指定 DC 创建一个特效素材源函数往指定特效器里追加一个特效素材源函数创建特效器输出目标函数设置特效器的输出目标从特效器中创建动画内置的特效器内置特效器分类特效器的属性使用示例本章小结 特效器 由于 mgeff 提供的只是动画框架, 具体的动画交给用户去实现 而有些动画特效比较通用, 如果每次都要让用户实现, 即不利于代码复用又无法保证其实现是最优的 所以 mgeff 中引入了 Effector 的概念 简单的讲,Effector 将常用的动画特效 ( 如卷页 ) 实现并封装起来, 以便用户直接使用 特效器的本质是封装特定的动画特效, 而在使用方式上它有一个约定 : 用户创建特效器后传入至少两个素材源 ( 少数特效器需要两个以上素材源 ), 并设置输出目标, 这样在特效器开始运行后会将第一个素材源在指定时间内变化为第二个素材源, 并将这个过程显示在输出目标上 在当前版本的 mgeff 中素材源支持从 MiniGUI 的 DC 上创建, 而输出目标则是 MiniGUI 窗口 ( 或控件 ) 函数原型 mgeff 提供了如下函数操作特效器的创建和运行 其原型如下 : 创建特效器函数 MGEFF_EFFECTOR mgeffeffectorcreate(unsigned long key); 参数说明 : key - 特效器名称的 hash 值, 通过该值作为索引可以对应一个唯一的特效器 返回值说明 : MGEFF_EFFECTOR - 创建成功返回特效器句柄, 失败返回 NULL 删除特效器函数