Convert SVG to PNG in Python

To convert SVG to PNG in Python, load the source file with SVGDocument, create ImageSaveOptions, and pass both objects to Converter.convert_svg(). PNG is the default image output format, and ImageSaveOptions lets you control the background color, page size, margins, and resolution.

Aspose.SVG APIs Used

API	Purpose
SVGDocument	Loads the source SVG document
Converter.convert_svg()	Converts and saves the SVG document as PNG
ImageSaveOptions	Configures image rendering and output settings
Page and Resolution	Set the output page and raster resolution

Convert SVG to PNG in Python

PNG is a lossless raster format that supports transparency. It is a practical output format for web graphics, previews, thumbnails, and applications that cannot render SVG directly.

The following example converts document.svg to result.png using the default PNG settings:

from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.saving import ImageSaveOptions

# Convert an SVG file to PNG using the default save options
options = ImageSaveOptions()

with SVGDocument("document.svg") as document:
    Converter.convert_svg(document, options, "result.png")

The code performs three operations:

1. SVGDocument loads the SVG file and resolves its content and linked resources.
2. ImageSaveOptions selects image output; its default format is PNG.
3. Converter.convert_svg() renders the document and writes result.png.

Convert SVG to PNG with Custom Options

Use ImageSaveOptions when the PNG needs a specific canvas, background, or resolution. The following example converts winter.svg, adds a solid background, creates a 600 × 550 page with 10-pixel margins, and renders at 96 dpi:

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.saving import ImageSaveOptions
from aspose.svg.drawing import Resolution, Page, Size, Margin
from aspose.pydrawing import Color

# Convert SVG to PNG with a custom background, page, and resolution
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "winter.svg")
output_path = os.path.join(output_folder, "winter.png")
os.makedirs(output_folder, exist_ok=True)

options = ImageSaveOptions()
options.background_color = Color.from_argb(231, 217, 230)
options.page_setup.any_page = Page(Size(600, 550), Margin(10, 10, 10, 10))
options.horizontal_resolution = Resolution.from_dots_per_inch(96.0)
options.vertical_resolution = Resolution.from_dots_per_inch(96.0)

with SVGDocument(input_path) as document:
    Converter.convert_svg(document, options, output_path)

The resulting PNG uses the requested page settings instead of relying only on the SVG viewport. The illustration compares the source SVG with the PNG rendered on the new background.

Important ImageSaveOptions Properties

Property	When to use it
background_color	Fill transparent areas with a chosen color
page_setup	Set page dimensions and margins
horizontal_resolution	Set horizontal output resolution in dpi
vertical_resolution	Set vertical output resolution in dpi
smoothing_mode	Control rasterization quality
text	Configure text rendering through TextOptions

If background_color is not set, transparent SVG areas remain transparent in PNG. Resolution affects raster density, while page_setup controls the output canvas. When page dimensions are specified in pixels, pixel dimensions are usually more important than increasing dpi alone.

Common Mistakes and Fixes

Problem	Likely cause	Fix
The PNG is blank or cropped	The SVG has no usable viewport or the output page is too small	Define SVG width, height, or viewBox, or set options.page_setup.any_page
Transparent areas appear unexpected	No output background was specified	Set options.background_color when a solid canvas is required
Text looks different	A referenced font is unavailable	Install the font or vectorize text before conversion when exact glyph appearance is required
Linked images or CSS are missing	Relative resources cannot be resolved	Load the SVG from its file path or provide a correct base URI
Output dimensions are not as expected	Page size and resolution are being treated as the same setting	Use page_setup for dimensions and horizontal_resolution/vertical_resolution for dpi

Online SVG to PNG Converter

You can also test SVG to PNG conversion in a browser. Upload an SVG file, select PNG, and compare the result with your programmatic output.

Try the free online SVG to PNG Converter to convert an SVG file without writing code.

FAQ

What is the shortest way to convert SVG to PNG in Python?

Create ImageSaveOptions(), open the source with SVGDocument, and call Converter.convert_svg(document, options, output_path).

Does SVG to PNG conversion preserve transparency?

Yes. PNG supports transparency, and transparent SVG areas remain transparent unless you set ImageSaveOptions.background_color.

How do I set the PNG size?

Set ImageSaveOptions.page_setup.any_page with a Page, Size, and Margin. Use the resolution properties separately when you need a particular dpi.

Can I convert SVG content stored in a string?

Yes. Create an SVGDocument from the SVG string and a base URI, then pass that document to Converter.convert_svg().

Related Articles

• Convert SVG Files in Python explains the available conversion workflows and output formats.
• Convert SVG to PDF in Python shows PDF save options and PdfDevice rendering.
• Convert SVG to Image covers JPG, BMP, TIFF, GIF, and other raster outputs.
• Create SVG File shows how to create or load an SVG before conversion.
• Edit SVG File explains how to modify SVG elements before saving or converting the document.
• Save SVG File explains how to save SVG documents after creating or editing them.
• Navigate SVG shows how to inspect SVG elements with CSS selectors and XPath before conversion.
• Supported File Formats lists input and output formats supported by Aspose.SVG for Python via .NET.
• Licensing explains how to apply a license or request a temporary license for full conversion results.