WPF Animated GIF

https://github.com/xamlanimatedgif/wpfanimatedgif
Admin
WPF Animated GIF is a simple library to display animated GIF images in WPF applications, usable in...
Tokens:6,847
Snippets:59
Trust Score:7.3
License:Apache-2.0
Update:6 months ago
Show doc for...
Tokens:
Raw
### Install WPF Animated GIF

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Commands to add the library via the dotnet CLI or NuGet Package Manager Console.

```bash
# Using dotnet CLI
dotnet add package WpfAnimatedGif

# Using NuGet Package Manager Console
Install-Package WpfAnimatedGif
```

--------------------------------

### Disable Auto-Start

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Configure the Image control to prevent the animation from starting automatically upon loading.

```xml
<Image Name="img"
       gif:ImageBehavior.AnimatedSource="animated.gif"
       gif:ImageBehavior.AutoStart="False" />
```

--------------------------------

### Control Automatic Playback with AutoStart

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Configure whether an animation starts automatically upon loading. When AutoStart is False, use the ImageAnimationController to trigger playback manually.

```xml
<Window x:Class="MyApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="AutoStart Demo" Height="400" Width="400">
    <StackPanel>
        <!-- Animation starts automatically (default) -->
        <Image gif:ImageBehavior.AutoStart="True"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Animation does not start until Play() is called -->
        <Image Name="manualImg"
               gif:ImageBehavior.AutoStart="False"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <Button Content="Start Animation" Click="StartAnimation_Click" />
    </StackPanel>
</Window>
```

```csharp
using System.Windows;
using WpfAnimatedGif;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }

    private void StartAnimation_Click(object sender, RoutedEventArgs e)
    {
        var controller = ImageBehavior.GetAnimationController(manualImg);
        if (controller != null)
        {
            controller.Play();
        }
    }
}
```

--------------------------------

### Get Animation Controller for Manual Control

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Obtain an ImageAnimationController to manage GIF playback. Subscribe to AddAnimationLoadedHandler to ensure the controller is available. The controller provides access to frame count, duration, current frame, and pause/play states.

```csharp
using System;
using System.Windows;
using System.Windows.Controls;
using WpfAnimatedGif;

public partial class MainWindow : Window
{
    private ImageAnimationController _controller;

    public MainWindow()
    {
        InitializeComponent();

        // Subscribe to AnimationLoaded to get controller when ready
        ImageBehavior.AddAnimationLoadedHandler(img, OnAnimationLoaded);
    }

    private void OnAnimationLoaded(object sender, RoutedEventArgs e)
    {
        // Get the animation controller (returns null if animation not loaded)
        _controller = ImageBehavior.GetAnimationController(img);

        if (_controller != null)
        {
            // Access animation information
            int totalFrames = _controller.FrameCount;
            TimeSpan duration = _controller.Duration;
            int currentFrame = _controller.CurrentFrame;
            bool isPaused = _controller.IsPaused;
            bool isComplete = _controller.IsComplete;

            // Subscribe to frame change events
            _controller.CurrentFrameChanged += OnCurrentFrameChanged;

            // Update UI with frame count
            frameSlider.Maximum = totalFrames - 1;
        }
    }

    private void OnCurrentFrameChanged(object sender, EventArgs e)
    {
        // Update progress indicator when frame changes
        if (_controller != null)
        {
            frameSlider.Value = _controller.CurrentFrame;
        }
    }

    private void PauseButton_Click(object sender, RoutedEventArgs e)
    {
        _controller?.Pause();
    }

    private void PlayButton_Click(object sender, RoutedEventArgs e)
    {
        // Play resumes if paused, or restarts if complete
        _controller?.Play();
    }

    private void GotoFrame(int frameIndex)
    {
        // Seek to a specific frame
        _controller?.GotoFrame(frameIndex);
    }

    private void GotoFirstFrame()
    {
        _controller?.GotoFrame(0);
    }

    private void GotoLastFrame()
    {
        if (_controller != null)
        {
            _controller.GotoFrame(_controller.FrameCount - 1);
        }
    }
}
```

--------------------------------

### Define GIF Viewer UI in XAML

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Sets up the main window with playback buttons, a status bar, and an Image control configured with WpfAnimatedGif behaviors.

```xml
<!-- MainWindow.xaml -->
<Window x:Class="GifViewer.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="GIF Viewer" Height="500" Width="600">
    <DockPanel>
        <StackPanel DockPanel.Dock="Top" Orientation="Horizontal" Margin="5">
            <Button Content="Open File" Click="OpenFile_Click" Margin="5" />
            <Button Content="Play" Click="Play_Click" Margin="5" />
            <Button Content="Pause" Click="Pause_Click" Margin="5" />
            <ComboBox Name="repeatCombo" Width="100" Margin="5"
                      SelectionChanged="RepeatCombo_SelectionChanged">
                <ComboBoxItem Content="Default" IsSelected="True" />
                <ComboBoxItem Content="Forever" />
                <ComboBoxItem Content="3 times" />
            </ComboBox>
        </StackPanel>

        <StatusBar DockPanel.Dock="Bottom">
            <TextBlock Name="statusText" Text="Ready" />
        </StatusBar>

        <Grid>
            <Image Name="gifImage"
                   Stretch="Uniform"
                   gif:ImageBehavior.AutoStart="True"
                   gif:ImageBehavior.AnimationLoaded="GifImage_AnimationLoaded"
                   gif:ImageBehavior.AnimationCompleted="GifImage_AnimationCompleted" />
        </Grid>
    </DockPanel>
</Window>
```

--------------------------------

### Implement GIF Viewer Logic in C#

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Handles file selection, animation control via ImageAnimationController, and dynamic repeat behavior updates.

```csharp
// MainWindow.xaml.cs
using System;
using System.Windows;
using System.Windows.Media.Animation;
using System.Windows.Media.Imaging;
using Microsoft.Win32;
using WpfAnimatedGif;

namespace GifViewer
{
    public partial class MainWindow : Window
    {
        private ImageAnimationController _controller;

        public MainWindow()
        {
            InitializeComponent();
        }

        private void OpenFile_Click(object sender, RoutedEventArgs e)
        {
            var dialog = new OpenFileDialog
            {
                Filter = "GIF Images|*.gif|All Files|*.*"
            };

            if (dialog.ShowDialog() == true)
            {
                LoadGif(dialog.FileName);
            }
        }

        private void LoadGif(string path)
        {
            try
            {
                var bitmap = new BitmapImage();
                bitmap.BeginInit();
                bitmap.UriSource = new Uri(path, UriKind.RelativeOrAbsolute);
                bitmap.CacheOption = BitmapCacheOption.OnLoad;
                bitmap.EndInit();

                ImageBehavior.SetAnimatedSource(gifImage, bitmap);
                statusText.Text = $"Loaded: {path}";
            }
            catch (Exception ex)
            {
                MessageBox.Show($"Error loading GIF: {ex.Message}");
            }
        }

        private void GifImage_AnimationLoaded(object sender, RoutedEventArgs e)
        {
            _controller = ImageBehavior.GetAnimationController(gifImage);

            if (_controller != null)
            {
                statusText.Text = $"Frames: {_controller.FrameCount}, Duration: {_controller.Duration.TotalSeconds:F2}s";
                _controller.CurrentFrameChanged += (s, args) =>
                {
                    Dispatcher.Invoke(() =>
                    {
                        statusText.Text = $"Frame {_controller.CurrentFrame + 1}/{_controller.FrameCount}";
                    });
                };
            }
        }

        private void GifImage_AnimationCompleted(object sender, RoutedEventArgs e)
        {
            statusText.Text = "Animation completed";
        }

        private void Play_Click(object sender, RoutedEventArgs e)
        {
            _controller?.Play();
        }

        private void Pause_Click(object sender, RoutedEventArgs e)
        {
            _controller?.Pause();
        }

        private void RepeatCombo_SelectionChanged(object sender, System.Windows.Controls.SelectionChangedEventArgs e)
        {
            if (gifImage == null) return;

            switch (repeatCombo.SelectedIndex)
            {
                case 0: // Default
                    ImageBehavior.SetRepeatBehavior(gifImage, default(RepeatBehavior));
                    break;
                case 1: // Forever
                    ImageBehavior.SetRepeatBehavior(gifImage, RepeatBehavior.Forever);
                    break;
                case 2: // 3 times
                    ImageBehavior.SetRepeatBehavior(gifImage, new RepeatBehavior(3));
                    break;
            }
        }
    }
}
```

--------------------------------

### Display Animated GIF in Code

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Use ImageBehavior.SetAnimatedSource to programmatically assign GIF sources from file paths or streams.

```csharp
using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media.Imaging;
using WpfAnimatedGif;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }

    private void LoadAnimatedGif(string filePath)
    {
        // Create BitmapImage from file path
        var image = new BitmapImage();
        image.BeginInit();
        image.UriSource = new Uri(filePath, UriKind.RelativeOrAbsolute);
        image.EndInit();

        // Set the animated source on the Image control
        ImageBehavior.SetAnimatedSource(img, image);
    }

    private void LoadFromStream(System.IO.Stream stream)
    {
        // Load from stream (e.g., embedded resource or downloaded content)
        var image = new BitmapImage();
        image.BeginInit();
        image.StreamSource = stream;
        image.CacheOption = BitmapCacheOption.OnLoad;
        image.EndInit();

        ImageBehavior.SetAnimatedSource(img, image);
    }

    private void ClearImage()
    {
        // Clear the animated image
        ImageBehavior.SetAnimatedSource(img, null);
    }
}
```

--------------------------------

### Retrieve Animation Controller

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Obtain the controller instance for a specific Image control to enable manual animation manipulation.

```csharp
var controller = ImageBehavior.GetAnimationController(imageControl);
```

--------------------------------

### Control Animation Playback

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Methods to pause, resume, or navigate to specific frames within the animation.

```csharp
// Pause the animation
controller.Pause();

// Resume the animation (or restart it if it was completed)
controller.Play();

// Go to the last frame
controller.GotoFrame(controller.FrameCount - 1);
```

--------------------------------

### Set Animated Source in C#

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/blob/master/README.md

Programmatically assign an animated source to an Image control using the ImageBehavior.SetAnimatedSource method.

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

--------------------------------

### Set Repeat Behavior in C#

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Control animation loops programmatically using the ImageBehavior.SetRepeatBehavior method.

```csharp
// Repeat 3 times
ImageBehavior.SetRepeatBehavior(img, new RepeatBehavior(3));

// Repeat for 10 seconds
ImageBehavior.SetRepeatBehavior(img, new RepeatBehavior(TimeSpan.FromSeconds(10)));

// Repeat forever
ImageBehavior.SetRepeatBehavior(img, RepeatBehavior.Forever);
```

--------------------------------

### Display Animated GIF in XAML

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Use the ImageBehavior.AnimatedSource attached property instead of the standard Source property.

```xml
<Image gif:ImageBehavior.AnimatedSource="Images/animated.gif" />
```

--------------------------------

### Configure Repeat Behavior in XAML

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Control animation loops using the ImageBehavior.RepeatBehavior attached property with various formats.

```xml
 <!-- Repeat 3 times -->
<Image gif:ImageBehavior.RepeatBehavior="3x"
       gif:ImageBehavior.AnimatedSource="Images/animated.gif" />

 <!-- Repeat for 10 seconds -->
<Image gif:ImageBehavior.RepeatBehavior="0:0:10"
       gif:ImageBehavior.AnimatedSource="Images/animated.gif" />

 <!-- Repeat forever -->
<Image gif:ImageBehavior.RepeatBehavior="Forever"
       gif:ImageBehavior.AnimatedSource="Images/animated.gif" />
```

--------------------------------

### Declare XML Namespace for WPF Animated GIF

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Add the library namespace to the root element of your XAML file to enable attached properties.

```xml
<Window x:Class="WpfAnimatedGif.Demo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com">
```

--------------------------------

### Subscribe to Animation Completion

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Handle the AnimationCompleted attached event to trigger logic when an animation finishes.

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

--------------------------------

### Handle AnimationLoaded Event in C#

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Subscribe to the AnimationLoaded event to safely access the ImageAnimationController once the GIF is ready. Ensure handlers are removed during cleanup to prevent memory leaks.

```csharp
using System.Windows;
using WpfAnimatedGif;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        // Subscribe using static method
        ImageBehavior.AddAnimationLoadedHandler(img, OnAnimationLoaded);
    }

    private void OnAnimationLoaded(object sender, RoutedEventArgs e)
    {
        // Animation is now loaded and ready
        var controller = ImageBehavior.GetAnimationController(img);

        if (controller != null)
        {
            // Safe to access controller properties
            statusText.Text = $"Loaded: {controller.FrameCount} frames, {controller.Duration.TotalSeconds:F1}s";
        }

        // Check the IsAnimationLoaded property
        bool isLoaded = ImageBehavior.GetIsAnimationLoaded(img);
    }

    protected override void OnClosed(EventArgs e)
    {
        // Clean up event handler
        ImageBehavior.RemoveAnimationLoadedHandler(img, OnAnimationLoaded);
        base.OnClosed(e);
    }
}
```

--------------------------------

### Display Animated GIF in XAML

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/blob/master/README.md

Use the gif:ImageBehavior.AnimatedSource attached property on an Image control to display a GIF.

```xml
<Window x:Class="WpfAnimatedGif.Demo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <Image gif:ImageBehavior.AnimatedSource="Images/animated.gif" />
```

--------------------------------

### Configure GIF Repeat Behavior in XAML

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/blob/master/README.md

Specify the number of times the animation should repeat using the gif:ImageBehavior.RepeatBehavior property.

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

--------------------------------

### Display Animated GIF in XAML

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Use the ImageBehavior.AnimatedSource attached property to display GIFs from local files, pack URIs, remote URLs, or data bindings.

```xml
<Window x:Class="MyApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="Animated GIF Demo" Height="400" Width="400">
    <Grid>
        <!-- Basic usage with local file -->
        <Image gif:ImageBehavior.AnimatedSource="Images/loading.gif" />

        <!-- Using pack URI for embedded resource -->
        <Image gif:ImageBehavior.AnimatedSource="pack://application:,,,/Images/spinner.gif" />

        <!-- Loading from remote URL -->
        <Image gif:ImageBehavior.AnimatedSource="http://example.com/animation.gif" />

        <!-- With data binding -->
        <Image gif:ImageBehavior.AnimatedSource="{Binding CurrentGifPath}" />
    </Grid>
</Window>
```

--------------------------------

### ImageBehavior.GetAnimationController - Manual Animation Control

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

The GetAnimationController static method returns an ImageAnimationController instance that provides programmatic control over the animation including pause, resume, and frame seeking capabilities.

```APIDOC
## ImageBehavior.GetAnimationController - Manual Animation Control

### Description
The `GetAnimationController` static method returns an `ImageAnimationController` instance that provides programmatic control over the animation including pause, resume, and frame seeking capabilities.

### Method
Static method call

### Endpoint
N/A (Local method call)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```csharp
// Assuming 'img' is an Image control with WpfAnimatedGif behavior attached
var controller = ImageBehavior.GetAnimationController(img);
if (controller != null)
{
    controller.Pause();
    controller.Play();
    controller.GotoFrame(10);
}
```

### Response
#### Success Response (ImageAnimationController)
- **ImageAnimationController** (object) - An instance providing control over the animation.

#### Response Example
```csharp
// Example of accessing controller properties
if (controller != null)
{
    int totalFrames = controller.FrameCount;
    TimeSpan duration = controller.Duration;
    bool isPaused = controller.IsPaused;
}
```
```

--------------------------------

### Control Animation Speed with AnimationSpeedRatio

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Adjust the animation playback speed using the `AnimationSpeedRatio` attached property. A value of 1.0 is normal speed, 2.0 is twice as fast, and 0.5 is half speed. This property is mutually exclusive with `AnimationDuration`.

```xml
<Window x:Class="MyApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="Speed Ratio Demo" Height="400" Width="600">
    <StackPanel>
        <!-- Normal speed -->
        <Image gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Double speed -->
        <Image gif:ImageBehavior.AnimationSpeedRatio="2.0"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Half speed (slow motion) -->
        <Image gif:ImageBehavior.AnimationSpeedRatio="0.5"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Bound to slider for dynamic control -->
        <Image gif:ImageBehavior.AnimationSpeedRatio="{Binding SpeedRatio}"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />
        <Slider Minimum="0.1" Maximum="5.0" Value="{Binding SpeedRatio}" />
    </StackPanel>
</Window>
```

--------------------------------

### Set Animation Repeat Behavior Programmatically

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

The `SetRepeatBehavior` static method allows programmatic control over animation repetition. Use it to set specific counts, durations, or infinite repetition.

```csharp
using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media.Animation;
using WpfAnimatedGif;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }

    private void SetRepeatCount(int count)
    {
        // Repeat a specific number of times
        ImageBehavior.SetRepeatBehavior(img, new RepeatBehavior(count));
    }

    private void SetRepeatDuration(TimeSpan duration)
    {
        // Repeat for a specific duration
        ImageBehavior.SetRepeatBehavior(img, new RepeatBehavior(duration));
    }

    private void SetRepeatForever()
    {
        // Repeat forever
        ImageBehavior.SetRepeatBehavior(img, RepeatBehavior.Forever);
    }

    private void UseMetadataRepeatCount()
    {
        // Use the repeat count from GIF metadata
        ImageBehavior.SetRepeatBehavior(img, default(RepeatBehavior));
    }
}
```

--------------------------------

### Handle Animation Completion Event in C#

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Implement the OnAnimationCompleted event handler to respond to the completion of a GIF animation. This handler can be used to update UI elements or trigger further actions, such as restarting the animation.

```csharp
using System.Windows;
using WpfAnimatedGif;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }

    private void OnAnimationCompleted(object sender, RoutedEventArgs e)
    {
        statusText.Text = "Animation completed!";

        // Optionally restart or load a different animation
        // var controller = ImageBehavior.GetAnimationController(img);
        // controller?.Play(); // Restart from beginning
    }
}
```

--------------------------------

### Enable Animation in Design Mode

Source: https://github.com/xamlanimatedgif/wpfanimatedgif/wiki/Home

Set the AnimateInDesignMode attached property to true on the root element to preview animations in the XAML designer.

```xml
<Window x:Class="WpfAnimatedGif.Demo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        gif:ImageBehavior.AnimateInDesignMode="True">
```

--------------------------------

### Control Animation Repeat Behavior with RepeatBehavior

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Use the `RepeatBehavior` attached property to control how many times an animation repeats. Options include a specific count ('3x'), a time duration ('0:0:10'), or 'Forever'. The default value uses GIF metadata.

```xml
<Window x:Class="MyApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="Repeat Behavior Demo" Height="400" Width="600">
    <StackPanel Orientation="Horizontal">
        <!-- Use repeat count from GIF metadata (default) -->
        <Image gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Repeat exactly 3 times -->
        <Image gif:ImageBehavior.RepeatBehavior="3x"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Repeat for 10 seconds duration -->
        <Image gif:ImageBehavior.RepeatBehavior="0:0:10"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Repeat forever -->
        <Image gif:ImageBehavior.RepeatBehavior="Forever"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- With data binding -->
        <Image gif:ImageBehavior.RepeatBehavior="{Binding SelectedRepeatBehavior}"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />
    </StackPanel>
</Window>
```

--------------------------------

### ImageBehavior.AnimationCompleted Event - Handle Animation Completion

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

The AnimationCompleted attached event fires when the animation finishes all its iterations. This event is not raised when RepeatBehavior is set to Forever.

```APIDOC
## ImageBehavior.AnimationCompleted Event - Handle Animation Completion

### Description
The `AnimationCompleted` attached event fires when the animation finishes all its iterations. This event is not raised when `RepeatBehavior` is set to `Forever`.

### Method
Event Subscription

### Endpoint
N/A (Attached event)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
```xml
<Image gif:ImageBehavior.AnimationCompleted="OnAnimationCompleted" ... />
```

### Response
#### Success Response (Event Handler)
- **sender** (object) - The object that raised the event.
- **e** (RoutedEventArgs) - Event arguments.

#### Response Example
```csharp
private void OnAnimationCompleted(object sender, RoutedEventArgs e)
{
    // Handle animation completion logic here
    // e.g., update UI, load next animation
}
```
```

--------------------------------

### Handle Animation Completion Event in XAML

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Use the ImageBehavior.AnimationCompleted attached event to execute logic when an animation finishes. This event is not fired if the animation is set to repeat indefinitely.

```xaml
<Window x:Class="MyApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="Animation Completed Demo" Height="400" Width="400">
    <StackPanel>
        <Image Name="img"
               gif:ImageBehavior.RepeatBehavior="3x"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif"
               gif:ImageBehavior.AnimationCompleted="OnAnimationCompleted" />

        <TextBlock Name="statusText" Text="Playing..." />
    </StackPanel>
</Window>
```

--------------------------------

### Set Fixed Animation Duration in XAML

Source: https://context7.com/xamlanimatedgif/wpfanimatedgif/llms.txt

Use the AnimationDuration attached property to override frame timing with a fixed duration. This property is mutually exclusive with AnimationSpeedRatio.

```xml
<Window x:Class="MyApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:gif="http://wpfanimatedgif.codeplex.com"
        Title="Duration Demo" Height="400" Width="400">
    <StackPanel>
        <!-- Complete animation in exactly 2 seconds -->
        <Image gif:ImageBehavior.AnimationDuration="0:0:2"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />

        <!-- Complete animation in 5 seconds -->
        <Image gif:ImageBehavior.AnimationDuration="0:0:5"
               gif:ImageBehavior.AnimatedSource="Images/anim.gif" />
    </StackPanel>
</Window>
```
Tokens:
Raw