Convert SVG to PNG in C#

To convert SVG to PNG in C#, load the SVG document or open the SVG file as a stream, create ImageSaveOptions, and call Converter.ConvertSVG() with the source, options, and output path or stream provider. PNG is the default ImageSaveOptions.Format value.

PNG is a lossless raster format that preserves sharp edges, text, icons, diagrams, and transparency-friendly output. SVG to PNG conversion is useful when vector graphics must be rendered as images for previews, thumbnails, UI assets, or systems that cannot consume SVG directly.

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 PNG with One Line of C#

The static Converter class provides a compact way to render SVG content to PNG. The example below converts SVG to PNG with default image save options.

// Convert SVG to PNG using C#

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

Convert an SVG File to PNG in C#

Use this workflow when the SVG source exists on disk and the PNG should be saved to a file path.

The workflow is:

1. Prepare the SVG source file or load it as an SVGDocument.
2. Create an ImageSaveOptions instance. The default Format value is PNG.
3. Call Converter.ConvertSVG(source, options, savePath).
4. Save the generated PNG file to the target output path.

// Convert SVG to PNG in C#

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

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

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

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

When to Use SVG to PNG Conversion

Use PNG output when the rendered SVG must keep crisp lines, transparent backgrounds, diagrams, icons, or UI details. PNG is often a better choice than JPG for technical graphics and documentation images. If smaller photographic previews are more important than lossless edges, use SVG to JPG. If the output must remain a document, use SVG to PDF.

Customize SVG to PNG with ImageSaveOptions

Use ImageSaveOptions when the generated PNG needs custom rendering settings.

To customize SVG to PNG conversion:

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

Option	Use it to control
Format	The output image format. The default value is PNG.
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 PNG in C# with custom settings

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

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

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

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

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

Related Image Workflows

• How to Resize Document During Conversion from HTML?
• Set Font Folder to Render HTML
• Fine-Tuning Converters
• Rendering Options

Save SVG to PNG with an Output Stream Provider

Use ICreateStreamProvider when the conversion output should be written through streams instead of only to a file path. This is useful for memory-based workflows, remote storage, databases, and services that decide where rendered image output is stored.

// Implement a custom MemoryStream provider for advanced control over HTML rendering output streams

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (MemoryStream stream in Streams)
            stream.Dispose();
    }
}

The following example converts SVG to PNG with MemoryStreamProvider.

// Convert SVG to PNG in C# using memory stream

// Create an instance of MemoryStreamProvider
using MemoryStreamProvider streamProvider = new MemoryStreamProvider();

// Prepare SVG code
string code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
              "<circle cx='50' cy='50' r='40' stroke='black' stroke-width='3' fill='red' />" +
              "</svg>";

// Convert SVG to PNG using the MemoryStreamProvider
Converter.ConvertSVG(code, ".", new ImageSaveOptions(), streamProvider);

// Get access to the memory stream that contains the result data
MemoryStream memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.png")))
{
    memory.CopyTo(fs);
}

Related SVG Conversion Guides

• Convert SVG to PDF – render SVG as a PDF document.
• Convert SVG to JPG – render SVG as compact JPEG output.
• Convert SVG to BMP – render SVG as bitmap output.
• Convert SVG to TIFF – render SVG as TIFF output.

Other Platforms

• Convert SVG to PNG in Java
• Convert SVG to PNG in Python via .NET

Try Online SVG to PNG Conversion

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