Skip to content

Commit bbeeb27

Browse files
authored
Create README.md
1 parent 1fde251 commit bbeeb27

File tree

1 file changed

+103
-0
lines changed

1 file changed

+103
-0
lines changed

README.md

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
GMU_Anim
2+
=====
3+
简介
4+
-----
5+
本插件用于简化实例变量缓动的过程,旨在使用一个函数,即可完成复杂的缓动过程。
6+
7+
安装
8+
-----
9+
将文件下载到本地后
10+
1. 手动添加 Scripts 文件夹内的文件到资源列表的Scripts分类内;或可复制文件内容,手动添加同名Scrpit,将内容粘贴入Script。
11+
2. 手动创建以“_gmu_anim”(不带引号)为名称的Object,手动创建与 Objects\\_gmu_anim\\ 文件夹内文件的同名事件,并将文件内容复制粘贴进相应事件中。
12+
13+
简单使用
14+
-----
15+
若要为房间内某个实例或某个Object添加缓动,只需执行`一次`GMU_Anim_New(...)函数即可为指定实例添加缓动。
16+
```cpp
17+
GMU_Anim_New(target, "x", GMU_ANIM_QUAD, GMU_ANIM_OUT, 100, 200, 15, 30);
18+
```
19+
使`target`物体的所有实例的`x`变量,使用`EaseOutQuart`效果,在15帧内从100增大200,延迟30帧执行。<br>
20+
`GMU_ANIM_QUAD`和`GMU_ANIM_OUT`均为插件的自定义常量,详见`常量`部分。<br>
21+
本插件支持 www.easings.net 中列出的所有缓动效果。
22+
23+
函数
24+
-----
25+
* GMU_Anim_Init();
26+
* 描述
27+
* 声明常量,无需调用该函数。
28+
29+
* GMU_Anim_New(inst/obj, var_name, tween, ease, start, change, duration, delay*, extra1*, extra2*);
30+
* 描述
31+
* 为目标实例或目标物体的所有实例添加缓动。
32+
* inst/obj
33+
* 目标实例或物体
34+
* var_name
35+
* 变量名称
36+
* tween
37+
* tween效果,详见 常量 部分
38+
* ease
39+
* ease效果,详见 常量 部分
40+
* start
41+
* 起始值
42+
* change
43+
* 变更值
44+
* duration
45+
* 持续时间
46+
* delay
47+
* 延迟(可选)
48+
* extra1
49+
* 附加参数 1(可选)
50+
* extra2
51+
* 附加参数 2(可选)
52+
* 返回值
53+
* 缓动实例;若有多个目标实例,则会返回数组。
54+
55+
* GMU_Anim_Stop(anim/inst/obj);
56+
* 描述
57+
* 终止目标缓动实例,或终止目标实例的所有缓动实例,或终止目标物体的所有实例的所有缓动实例
58+
* anim/inst/obj
59+
* 目标缓动实例/实例/物体
60+
* 返回值
61+
* true/false 是否有缓动实例被终止。
62+
63+
* GMU_Anim_Skip(anim/inst/obj);
64+
* 描述
65+
* 提前结束目标缓动实例,或提前结束目标实例的所有缓动实例,或提前结束目标物体的所有实例的所有缓动实例
66+
* anim/inst/obj
67+
* 目标缓动实例/实例/物体
68+
* 返回值
69+
* true/false 是否有缓动实例被提前结束。
70+
71+
* GMU_Anim_IsExists(anim/inst/obj, var_name*);
72+
* 描述
73+
* 查询目标缓动实例是否存在,或查询目标实例上是否有缓动存在,或查询目标物体的所有实例上是否有缓动存在
74+
* anim/inst/obj
75+
* 目标缓动实例/实例/物体
76+
* var_name
77+
* 变量名称(可选),若填写,则检查查询到的缓动实例是否作用于指定的变量上。
78+
* 返回值
79+
* true/false 缓动实例是否存在。
80+
81+
常量
82+
-----
83+
tween效果
84+
-----
85+
0. GMU_ANIM_LINEAR
86+
1. GMU_ANIM_SINE
87+
2. GMU_ANIM_QUAD
88+
3. GMU_ANIM_CUBIC
89+
4. GMU_ANIM_QUART
90+
5. GMU_ANIM_QUINT
91+
6. GMU_ANIM_EXPO
92+
7. GMU_ANIM_CIRC
93+
8. GMU_ANIM_BACK
94+
9. GMU_ANIM_ELASTIC
95+
10. GMU_ANIM_BOUNCE
96+
97+
ease效果
98+
-----
99+
11. GMU_ANIM_IN
100+
12. GMU_ANIM_OUT
101+
13. GMU_ANIM_IN_OUT
102+
103+
您可以在 www.easings.net 观看不同的缓动效果。

0 commit comments

Comments
 (0)