Convert SVG to GIF in C#

To convert SVG to GIF in C#, load the SVG document or prepare SVG content, create ImageSaveOptions with ImageFormat.Gif, and call Converter.ConvertSVG() with the source, options, and output path.

GIF is a simple raster image format often used for lightweight web graphics and legacy compatibility. SVG to GIF conversion is useful when vector graphics must be rendered for systems that expect GIF output, while keeping control over page setup, background color, resolution, and rendering quality.

Before running the examples, install and configure Aspose.HTML for .NET in your project. The complete C# example project is available in the Aspose.HTML for .NET GitHub repository.

Convert SVG to GIF with One Line of C#

The static Converter class provides a compact way to render SVG content to GIF. The example below converts a local SVG file to GIF.

// Convert SVG to GIF in C#

// Invoke the ConvertSVG() method for SVG to GIF conversion
Converter.ConvertSVG(Path.Combine(DataDir, "shapes.svg"), new ImageSaveOptions(ImageFormat.Gif), Path.Combine(OutputDir, "convert-with-single-line.gif"));

Convert SVG to GIF in C#

Use this workflow when SVG content is created in code and then saved as a GIF file.

The workflow is:

1. Prepare the SVG content and base URI.
2. Create ImageSaveOptions with ImageFormat.Gif. The default Format value is PNG, so the format must be set for GIF output.
3. Call Converter.ConvertSVG(content, baseUri, options, outputPath).
4. Save the generated GIF file to the target output path.

// Convert SVG to GIF using C#

// Prepare SVG code
string code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
              "<circle cx ='100' cy ='100' r ='55' fill='pink' stroke='red' stroke-width='8' />" +
              "</svg>";

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "circle.gif");

// Create an instance of the ImageSaveOptions class
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Gif);

// Convert SVG to GIF
Converter.ConvertSVG(code, ".", options, savePath);

When to Use SVG to GIF Conversion

Use GIF output when compatibility with simple image viewers, lightweight web graphics, or legacy systems matters more than full-color fidelity. GIF is usually not ideal for detailed SVG artwork, gradients, or high-quality previews. For sharper lossless rendering, use SVG to PNG. For smaller previews, use SVG to JPG.

Customize SVG to GIF with ImageSaveOptions

Use ImageSaveOptions when the generated GIF needs custom rendering settings.

To customize SVG to GIF conversion:

1. Load the SVG file as an SVGDocument.
2. Create ImageSaveOptions with ImageFormat.Gif.
3. Configure only the settings required by the output, such as PageSetup, BackgroundColor, resolution, or UseAntialiasing.
4. Pass the document, options, and output path to Converter.ConvertSVG().

Option	Use it to control
Format	The output image format. The default value is PNG; use ImageFormat.Gif for GIF output.
BackgroundColor	The color used to fill the image background. The default value is transparent.
PageSetup	Page size, margins, and page layout settings.
HorizontalResolution and VerticalResolution	Output resolution values used by the rendering process. The default value is 300 dpi for each property.
UseAntialiasing	Image rendering quality. Antialiasing is enabled by default.
Text	Text rendering configuration through TextOptions.

// Convert SVG to GIF in C# with custom background, resolution, and antialiasing settings

// Prepare a path to a source SVG file
string documentPath = Path.Combine(DataDir, "gradient.svg");

// Prepare a path to save the converted file
string savePath = Path.Combine(OutputDir, "gradient-options.gif");

// Initialize an SVG document from the file
using SVGDocument document = new SVGDocument(documentPath);

// Initialize ImageSaveOptions. Set up the SmoothingMode, resolutions, and change the background color to AliceBlue
ImageSaveOptions options = new ImageSaveOptions(ImageFormat.Gif)
{
    UseAntialiasing = true,
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue
};

// Convert SVG to GIF
Converter.ConvertSVG(document, options, savePath);

The image below illustrates a GIF rendering result with custom image save options.

Related SVG Conversion Guides

• Convert SVG to PDF – render SVG as a PDF document.
• Convert SVG to PNG – render SVG as lossless raster output.
• Convert SVG to JPG – render SVG as compact JPEG output.
• Convert SVG to TIFF – render SVG as TIFF output.

Other Platforms

• SVG Converter in Java
• SVG Converter in Python via .NET

Try Online SVG to GIF Conversion

Use the online SVG to GIF Converter for quick manual conversion. Use Aspose.HTML for .NET when SVG to GIF conversion must run inside a C# application, service, or document pipeline.