SuperAPI AI 工具集

pixijs-scene-gif

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:在 PixiJS v8 中把动画 GIF 作为显示对象播放。GifSprite 继承 Sprite,是叶子节点,不能在其内部嵌套子对象;需要组合多个 GifSprite 时用 Container 包裹。

主要能力:Assets.load('animation.gif') 返回 GifSource(不是 Texture),需用 GifSprite 包装。必须副作用导入 'pixi.js/gif' 以注册加载器扩展,否则 Assets.load 无法识别 GIF。GifSprite 与 GifSource 从 pixi.js/gif 导出,而非 pixi.js。

用法: import "pixi.js/gif"; import { GifSprite } from "pixi.js/gif"; const source = await Assets.load("animation.gif"); const gif = new GifSprite({ source, autoPlay: true, loop: true, animationSpeed: 1 });

构造选项:source(必填)、autoPlay(默认 true)、loop(默认 true)、animationSpeed(默认 1,为原生帧时长的倍数)、autoUpdate(默认 true,连接 Ticker.shared;设为 false 时自行调用 gif.update(ticker))、fps(默认 30,无逐帧延迟时的回退帧率)、onComplete、onLoop、onFrameChange、scaleMode(8.13.0 起弃用,改由 Assets.load 的 data 传入)。也可直接 new GifSprite(source)。

播放控制:play()、stop()、currentFrame(从 0 开始)、animationSpeed、playing(只读)、progress(0-1)、totalFrames、duration(毫秒)。加载选项可在 Assets.load 的 data 中传 fps、scaleMode、resolution,也支持 data:image/gif URI。

限制与注意:GIF 每帧解码为独立 canvas 纹理,帧数多且性能敏感时建议改用 spritesheet 配合 AnimatedSprite。gif.destroy() 不会释放 GifSource 与帧纹理,需 destroy(true) 或 Assets.unload;共享 source 时应在最后一个使用者结束后再销毁。

适用场景:需要在 PixiJS 场景中直接播放 GIF 动画的开发者。前提是熟悉 pixijs-scene-core-concepts。其余细节暂未提供。