AnimationImage.WPF 2.0.0

AnimationImage

基于 SkiaSharp 的 WPF & AvaloniaUI 极简动图播放方案

🚀 简介

AnimationImage支持播放 Lottie(JSON)、GIF 和 WebP 格式，相比现有方案，具有更高的帧率、更佳的渲染性能以及更低的内存占用。

🚝使用方法

引入命名空间：xmlns:ani="https://github.com/LazyCuteLion/AnimationImage"

WPF：

<Image ani:AnimationBehavior.AnimatableBitmap="[path]"
       ani:AnimationBehavior.ForceFPS="144"
       ani:AnimationBehavior.RepeatBehavior="Forever" />


<Image Source="{ani:AnimatableBitmap '[path]',Preload=true}" />


<Rectangle Fill="{ani:AnimatableBitmap '[path]'}" />

<Border Background="{ani:AnimatableBitmap '[path]'}" />


<Image ani:AnimationBehavior.AutoStart="false" …… />


<Slider Maximum="{Binding ElementName=img, Path=(ani:AnimationBehavior.AnimatableBitmap).Metadata.Duration}"
        Value="{Binding ElementName=img, Path=(ani:AnimationBehavior.AnimationTime), Mode=TwoWay}" />


<StackPanel DataContext="{Binding ElementName=img, Path=(ani:AnimationBehavior.AnimatableBitmap)}"
            Orientation="Horizontal">
            <Button Command="{Binding BeginCommand, Mode=OneTime}"
                    Content="Play" />
            <Button Margin="10,0"
                    Command="{Binding PauseCommand, Mode=OneTime}"
                    Content="Pause" />
            <Button Command="{Binding StopCommand, Mode=OneTime}"
                    Content="Stop" />
</StackPanel>

Avalonia（用法与WPF基本相同）：

<Image ani:AnimationBehavior.AnimatableBitmap="[path]"
       ani:AnimationBehavior.LoopCount="-1" />

public partial class App : Application
{
   public override void Initialize()
   {
       //修改默认配置
       AnimatableBitmapOptions.Default = new AnimatableBitmapOptions()
       {
           UseGPU = false,//禁用显卡加速
           Preload = false,//禁用预加载缓存
       };
       AvaloniaXamlLoader.Load(this);
   }
}

✈️更新日志

v2.0.0
🚨 重大变更：取消了预加载机制，移除了 PreloadCount/PreloadOptions 和 RenderScale（因为画面会糊）。
🧨 新增：MMFFrameCache （代替预加载）基于内存映射文件的帧缓存，默认已启用（几乎与预加载到内存一样流畅，但无需占用内存）。
🐛 修复：Lottie 像素舍入、GPU 资源生命周期、动画状态不一致等若干问题。

v1.0.7
🐛 修复：修复Lottie文件初始化大小不准确以及帧率异常的问题。（VS智能补全代码害死人，稍不留神就出BUG）
🚨 重大变更：统一命名空间xmlns:ani="https://github.com/LazyCuteLion/AnimationImage"。

v1.0.6
🧨 功能回归：全新的GIF/WebP 预加载机制：若解码速度不能满足帧率要求，则自动预加载，然后开启后台线程持续解码并缓存。可通过AnimatableBitmapOptions.Default来调整这一默认行为。

v1.0.5
👏 重大变更：引入Vortice.Direct3D12，为Lottie提供显卡加速功能，对于复杂场景的动画有很大的提升！默认已开启，也可以通过UseGPU关闭。

v1.0.4
🐛 修复：修复Lottie文件不能自动播放的问题。

v1.0.3
✨ 优化：对于Lottie文件，增加了设置渲染比例选项。
🚨 重大变更：预加载功能有较大缺陷，暂时取消。

v1.0.2
✨ 优化：AI生成的代码不是很靠谱，重新优化预加载算法。

v1.0.1
🐛 修复：修复命令状态没有即时更新的问题。

v1.0.0
🚀 发布：初始版本正式发布。