Openize.Animated-GIF for .NET

A .NET library for creating and reading animated GIF files. This is a C# port of the popular animated-gif-lib-for-java library, providing robust support for GIF encoding and decoding with advanced features like color quantization, transparency control, and frame management.

Features

• Animated GIF Encoding: Create animated GIFs from any sequence of images
• GIF Decoding: Extract frames and metadata from existing GIF files
• Advanced Color Quantization: Uses NeuQuant algorithm for optimal color reduction
• Transparency Support: Full control over transparent colors
• Animation Control: Set frame delays, loop counts, and disposal methods
• Background Management: Specify background colors and handle oversized images

Installation

dotnet add package Openize.Animated.GIF

Or via NuGet Package Manager:

Install-Package Openize.Animated.GIF

Quick Start

Creating an Animated GIF

using Openize.Animated.GIF; using System.Drawing; // Initialize the encoder var encoder = new AnimatedGifEncoder(); encoder.Start("output.gif"); // Configure animation settings encoder.SetDelay(500); // 500ms between frames encoder.SetRepeat(0); // Loop infinitely // Add frames encoder.AddFrame(new Bitmap("frame1.png")); encoder.AddFrame(new Bitmap("frame2.png")); // Finish encoding encoder.Finish();

Reading an Animated GIF

// Initialize the decoder var decoder = new GifDecoder(); decoder.Read("input.gif"); // Get information int frameCount = decoder.GetFrameCount(); int loopCount = decoder.GetLoopCount(); // 0 = infinite // Extract frames for (int i = 0; i < frameCount; i++) { Bitmap frame = decoder.GetFrame(i); frame.Save($"frame_{i}.png"); }

Advanced Options

// Configure transparency encoder.SetTransparent(Color.White, true); // Exact match // Set specific background color encoder.SetBackground(Color.Black); // Custom size (for oversized images) encoder.SetSize(800, 600);

Requirements

• .NET 6.0 or later
• System.Drawing.Common (automatically installed)

Platform Compatibility

This library uses System.Drawing.Common which has some limitations on non-Windows platforms. For production use on Linux or macOS, you may need to install additional dependencies:

• Linux: apt-get install libgdiplus
• macOS: brew install mono-libgdiplus

License

Openize.Animated-GIF for .NET is licensed under the Apache License 2.0.

[!CAUTION] Openize does not and cannot grant You a patent license for the utilization of animated-gif-lib-for-java compression/decompression technologies.

Contributing

Feel free to submit issues and enhancement requests!

Acknowledgments

This library is a C# port of animated-gif-lib-for-java by Roberto Tyley, ported and maintained by Openize Pty Ltd.

OSS Notice

Sample files used for tests and located in the "./testdata/" folder belong to animated-gif-lib-for-java and are used according to Apache License 2.0.

---

For more information and documentation, visit Openize.com.