Convert SVG to PNG in Python

To convert SVG to PNG in Python, load the source with SVGDocument, create ImageSaveOptions for PNG, and call Converter.convert_svg(). PNG creates lossless raster output and can preserve transparent areas of the SVG.

SVG stores vector shapes, paths, and text, whereas PNG stores a fixed grid of pixels. SVG to PNG conversion is useful for previews, thumbnails, web graphics, and applications that do not display SVG content. The output size and resolution should be selected for the image’s intended display or print size.

Convert SVG to PNG in Python

The following example loads the existing tulips.svg file and converts it to PNG. ImageFormat.PNG is specified explicitly so that the selected output format is clear in the code.

1. Load the SVG source into an SVGDocument.
2. Create ImageSaveOptions and select PNG as the output format.
3. Call Converter.convert_svg() with the document, options, and output path.

import os
import aspose.html.dom.svg as ahsvg
import aspose.html.converters as conv
import aspose.html.saving as sav
import aspose.html.rendering.image as rim

data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

input_path = os.path.join(data_dir, "tulips.svg")
output_path = os.path.join(output_dir, "tulips-default.png")

# Select PNG as the output format
options = sav.ImageSaveOptions(rim.ImageFormat.PNG)

# Load the SVG file and convert it to PNG
with ahsvg.SVGDocument(input_path) as document:
    conv.Converter.convert_svg(document, options, output_path)

The resulting tulips-default.png is a raster image. Scaling it beyond its generated pixel dimensions can reduce apparent sharpness, unlike scaling the original vector SVG.

Convert SVG to PNG Using ImageSaveOptions

Use ImageSaveOptions when the PNG needs a specific canvas size, margins, resolution, or background. The next example uses the same SVG file but places its rendered content on a 500 × 500 CSS-pixel page with 10 CSS-pixel margins.

import os
import aspose.html.dom.svg as ahsvg
import aspose.html.converters as conv
import aspose.html.drawing as dr
import aspose.html.rendering.image as rim
import aspose.html.saving as sav

data_dir = "data"
output_dir = "output"
os.makedirs(output_dir, exist_ok=True)

input_path = os.path.join(data_dir, "tulips.svg")
output_path = os.path.join(output_dir, "tulips.png")

# Configure PNG output and the first output page
options = sav.ImageSaveOptions(rim.ImageFormat.PNG)
options.page_setup.first_page = dr.Page(
    dr.Size(500, 500),
    dr.Margin(10, 10, 10, 10)
)

# Convert SVG to PNG with custom page settings
with ahsvg.SVGDocument(input_path) as document:
    conv.Converter.convert_svg(document, options, output_path)

The custom page size changes the canvas and the space available for the rendered SVG. The final bitmap dimensions also depend on the output resolution. At the default 300 dpi, a 500 × 500 CSS-pixel page produces a PNG of approximately 1562 × 1562 pixels. The following illustration shows the generated tulips.png image.

Useful ImageSaveOptions for PNG

Property	What it controls
format	Selects PNG or another supported raster format. PNG is also the default format.
page_setup	Sets the page dimensions and margins in CSS pixels when plain numeric values are used.
horizontal_resolution and vertical_resolution	Set the output and internal image resolution in pixels per inch.
background_color	Fills the output page with a color. The default background is transparent.

The SVG width, height, and viewBox define the source coordinate system and visible region. page_setup defines the output page, while the resolution determines how many bitmap pixels are generated for that page. If the page is too small for the rendered content, the PNG can be clipped; a larger page can introduce additional space around it.

Common SVG to PNG Issues

Problem	Likely cause and solution
The PNG is cropped	The SVG viewport or output page is smaller than the visible content. Check the SVG viewBox, width, and height, or increase the page size in page_setup.
The PNG has unexpected empty space	The output canvas is larger than the rendered SVG. Adjust the page dimensions and margins.
Text uses a different font	A font referenced by the SVG is unavailable in the conversion environment. Install the font or embed a suitable font in the SVG.
Linked images or styles are missing	Relative resource paths cannot be resolved. Load the SVG from its original location and keep linked resources at the expected relative paths.

FAQ

Does SVG to PNG conversion preserve transparency?

Yes. PNG supports transparent pixels, and ImageSaveOptions uses a transparent background by default. Setting background_color fills the output page and replaces that transparent page background with the selected color.

Is the converted PNG still a vector image?

No. The SVG source is vector-based, but the PNG result is a raster image with fixed pixel dimensions. Keep the original SVG when later editing or unrestricted scaling is required.

How do I convert an SVG embedded in HTML to PNG?

Use convert_svg() for a standalone SVG document or SVG markup string. If the SVG is part of an HTML page and you need the rendered page, load the HTML document and use Converter.convert_html() with PNG image options.

Related Guides

• SVG Converter – choose another SVG output format.
• Convert SVG to JPG – create compressed raster output when transparency is not required.
• Convert SVG to PDF – preserve SVG content in a fixed-layout document.
• Fine-Tuning Converters – configure page setup, resolution, and rendering behavior.

Other Platforms

• Convert SVG to PNG in C#
• Convert SVG to PNG in Java

Try Online SVG to PNG Conversion

Use the free online SVG to PNG Converter for quick manual conversion without writing Python code.