GitHub - XamlAnimatedGif/WpfAnimatedGif: A simple library to display animated GIF images in WPF, usable in XAML or in code. (original) (raw)

Nuget package available here: WpfAnimatedGif.

A simple library to display animated GIF images in WPF, usable in XAML or in code.

It's very easy to use: in XAML, instead of setting the Source property, set the AnimatedSource attached property to the image you want:

You can also specify the repeat behavior (the default is 0x, which means it will use the repeat count from the GIF metadata):

    <Image gif:ImageBehavior.RepeatBehavior="3x"
           gif:ImageBehavior.AnimatedSource="Images/animated.gif" />

And of course you can also set the image in code:

var image = new BitmapImage(); image.BeginInit(); image.UriSource = new Uri(fileName); image.EndInit(); ImageBehavior.SetAnimatedSource(img, image);

See the wiki for more details on usage.

Features

• Animates GIF images in a normal Image control; no need to use a specific control
• Takes actual frame duration into account
• Repeat behavior can be specified; if unspecified, the repeat count from the GIF metadata is used
• Notification when the animation completes, in case you need to do something after the animation
• Animation preview in design mode (must be enabled explicitly)
• Support for controlling the animation manually (pause/resume/seek)

How to build

Run build.cmd.

Note: the library's version number is determined by MinVer based on Git history and tags. A consequence of this is that if you build the project outside a Git repository (e.g. if you just download sources), you'll get a version number of 0.0.0.0. So, in order to build with the correct version number, make sure you're in a Git clone of the project, and that your clone has the tags from the upstream project (git fetch upstream --tags, assuming your remote for the upstream project is named upstream).