跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI大前端

Webgal 自定义动画编写指南

WebGal 引擎中自定义动画的编写方法。内容包括编写原因、支持的关键字属性(如透明度、缩放、位置等)、JSON 数据结构原理、实战案例(NoHover 聚光灯效果)、动画文件的导入注册流程,以及如何利用 AI 工具辅助生成动画代码。通过掌握这些内容,可实现覆盖默认动画或创建特殊交互效果。

接口猎人发布于 2026/4/5更新于 2026/10/18122 浏览
Webgal 自定义动画编写指南

1. 为什么要编写自定义动画

很多时候需要覆盖引擎自带的默认动画,或者实现诸如 CG 平移预览等特定效果,此时只能编写新的动画。

2. 自定义动画的关键字

WebGal 提供了自定义动画的关键字,设置好每个关键帧的动画效果即可按线性播放。以下关键字参考官方文档:

属性名释义
alpha透明度,范围 0-1
scale缩放
position位置偏移
rotation旋转角度,单位为弧度
blur高斯模糊半径
brightness调节亮度
contrast调节对比度
saturation调节饱和度
gamma调节伽马值
colorRed颜色分量:红色,范围 0-255
colorGreen颜色分量:绿色,范围 0-255
colorBlue颜色分量:蓝色,范围 0-255
duration时间片持续时间,单位为毫秒 (ms)
oldFilm老电影效果,0 关闭,1 开启
dotFilm点状电影效果,0 关闭,1 开启
reflectionFilm反射电影效果,0 关闭,1 开启
glitchFilm故障电影效果,0 关闭,1 开启
rgbFilmRGB 电影效果,0 关闭,1 开启
godrayFilm光辉效果,0 关闭,1 开启

此外,每个关键帧尾部需包含 duration 关键字控制该阶段持续时间。例如一个简单的亮度变化动画:

[
  { "brightness": 1.0, "duration": 0 },
  { "brightness": 0.4, "duration": 600 }
]

注意:末状态不会随动画结束自动返回初始状态,如需恢复需额外编写动画。

其中,position 和 rotation 拥有子控件 x 和 y,分别对应 x 轴和 y 轴效果:

[
  {
    "scale": { "x": 1, :  },
    : { : -, :  },
    : 
  },
  {
    : { : , :  },
    : { : , :  },
    : 
  }
]
"y"
1
"position"
"x"
50
"y"
0
"duration"
0
"scale"
"x"
1
"y"
1
"position"
"x"
0
"y"
0
"duration"
500

3. 自定义动画的原理拆解

WebGal 使用 JSON 文件存储动画,本质是 JS 对象。自定义动画结构如下:

[
  { "xxx": xxx },
  { "xxx": xxx }
]
  • [] 表示数组(对象集合)
  • {} 表示对象
  • 多个对象间需用逗号隔开
  • duration 请设置在数组元素尾部
  • 数组元素内可嵌套数组(如偏移和旋转)

4. 案例:简单的 NoHover 动画编写

假设需求为:两人同时在场时,讲话方亮度正常,非讲话方变暗,形成聚光灯效果。

始状态为原始立绘,经过短时间后变为末状态(亮度和饱和度降低):

[
  { "brightness": 1, "saturation": 1, "duration": 0 },
  { "brightness": 0.7, "saturation": 0.8, "duration": 100 }
]

退出 NoHover 状态时,只需编写反向动画 nohover-out,对调始末状态即可。

5. 动画的导入以及使用

若下载或编写了新动画,需在 animationTable.json 中注册文件名(不含后缀)。

通常路径位于:release\public\games\yourgame\game\animation

打开该目录下的 animationTable.json,其结构记录了文件夹内的所有动画。添加新动画时,在列表末尾添加逗号并写入新动画名称(无需 .json 后缀),保存后刷新浏览器即可在可视化区域找到新动画。

建议将预设动画放入子文件夹,外层仅保留自定义动画以简化配置。

6. 善用 AI 编写简单动画

如果手动编写困难,可借助 AI 工具辅助生成。将动画文档链接及详细描述(精确到每个关键帧的变化)输入给 AI,等待几秒钟即可获得代码示例。

目录

  1. 1. 为什么要编写自定义动画
  2. 2. 自定义动画的关键字
  3. 3. 自定义动画的原理拆解
  4. 4. 案例:简单的 NoHover 动画编写
  5. 5. 动画的导入以及使用
  6. 6. 善用 AI 编写简单动画

更多推荐文章

查看全部
  • 豆包·图像创作模型 Seedream 4.0 评测与功能实战
  • STM32F103RC 与 TFT-LCD 电子相册开发及图片解码算法详解
  • VRChat 实时翻译工具使用指南
  • 小厂架构师 AI Agent 落地实战:从全能幻想到最小可用场景
  • Python 数据可视化毕业设计实战:从选题到部署
  • SpringBoot 配置文件核心用法(Properties & YAML)
  • Python 图形界面(GUI)编程技术详解
  • WAAPI:Web 动画开发的核心技术与实践
  • JavaScript 运算符与流程控制详解
  • Windows 平台 AI 自动化测试与业务处理工具 WinClaw 实战指南
  • Vivado 中 ILA 集成逻辑分析仪在线调试方法
  • PRIDE-PPPAR 多 GNSS 精密单点定位软件安装配置指南
  • C17 泛型如何支撑百万行级系统代码复用
  • 基于 aivectormemory 实现 AI 长期记忆方案
  • Python Tkinter Frame 核心解析与实战指南
  • 微服务架构:从入门到进阶指南
  • 医疗 AI 时代的生物医学 Go 编程:高性能计算与精准医疗案例分析
  • 大模型在日常生活中的五大应用场景与使用建议
  • Node.js 最新版下载安装与环境配置教程
  • 网络安全护网行动详解:红蓝对抗与防御体系

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online