Convert SVG to Image in Python

Use SVGDocument to load an SVG file, create ImageSaveOptions, set the image format, and call Converter.convert_svg(document, options, output_path). Use ImageSaveOptions to control the background color, page size, margins, and output resolution.

Aspose.SVG APIs Used

API	Purpose
SVGDocument	Loads the source SVG document
Converter.convert_svg()	Converts SVG to raster image formats
ImageSaveOptions	Configures image output for converter-based workflows
ImageRenderingOptions	Configures image output for device-based rendering workflows
ImageDevice	Receives rendered SVG content and writes an image file
ImageFormat	Selects the target image format

SVG to Image Conversion in Python

Aspose.SVG for Python via .NET can convert SVG documents to raster image formats such as JPG, BMP, TIFF, GIF, and PNG. Use JPG when transparency is not required, PNG for transparent raster output, TIFF for publishing and image-processing workflows, BMP for simple bitmap output, and GIF for lightweight raster output.

For a PNG-focused tutorial, see Convert SVG to PNG in Python. This article focuses on the broader SVG-to-image workflow and format selection.

Before running the examples, install Aspose.SVG for Python via .NET in your Python environment.

Convert SVG to JPG Using Converter.convert_svg()

The following example converts an SVG file to JPG and sets a custom background, page size, margins, and resolution. JPG does not support transparency, so setting a background color is usually important.

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

# Convert SVG to JPG with custom background, page size, and resolution
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "christmas-tree.svg")
output_path = os.path.join(output_folder, "christmas-tree.jpg")
os.makedirs(output_folder, exist_ok=True)

options = ImageSaveOptions()
options.format = ImageFormat.JPEG
options.background_color = Color.from_argb(233, 255, 241)
options.page_setup.any_page = Page(Size(450, 450), Margin(20, 20, 20, 20))
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 following image shows the source SVG and the converted JPG result with a custom background color.

Change the Output Image Format

To save SVG as another image format, set options.format and use the matching file extension. For example, use ImageFormat.GIF with .gif, ImageFormat.BMP with .bmp, or ImageFormat.TIFF with .tiff.

options.format = ImageFormat.GIF
output_path = os.path.join(output_folder, "image.gif")

Common ImageSaveOptions Properties

Property	What it controls
format	Target image format such as JPG, PNG, BMP, TIFF, or GIF
background_color	Background color for transparent SVG areas
page_setup	Output image size, margins, and page layout
horizontal_resolution	Horizontal output resolution in pixels per inch
vertical_resolution	Vertical output resolution in pixels per inch
smoothing_mode	Rendering quality for shapes and edges
compression	TIFF compression settings

ImageSaveOptions inherits image rendering settings from ImageRenderingOptions, so many output properties are shared between converter-based and device-based workflows.

Convert SVG to Image Using render_to()

The render_to() method sends SVG content to an image rendering device. This pattern is useful when your application already uses rendering devices or needs to select the target device explicitly.

import os
from aspose.svg import SVGDocument
from aspose.svg.drawing import Margin, Page, Resolution, Size
from aspose.svg.rendering.image import ImageDevice, ImageFormat, ImageRenderingOptions

# Render SVG to JPG through an ImageDevice
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "image.svg")
output_path = os.path.join(output_folder, "image.jpg")
os.makedirs(output_folder, exist_ok=True)

options = ImageRenderingOptions()
options.format = ImageFormat.JPEG
options.horizontal_resolution = Resolution.from_dots_per_inch(96.0)
options.vertical_resolution = Resolution.from_dots_per_inch(96.0)
options.page_setup.any_page = Page(Size(600, 600), Margin(10, 10, 10, 10))

with SVGDocument(input_path) as document:
    with ImageDevice(options, output_path) as device:
        document.render_to(device)

Common Mistakes and Fixes

Problem	Likely cause	Fix
JPG output has a black or unexpected background	JPG does not support transparency	Set options.background_color before conversion
The output image is cropped or too large	Page setup does not match the SVG viewport or desired output size	Configure page_setup.any_page with Page, Size, and Margin
The image is blurry	Output resolution or page size is too low	Increase horizontal_resolution, vertical_resolution, or output dimensions
The wrong format is produced	The image format and file extension do not match	Set both options.format and the output file extension deliberately
External images or CSS are missing	Relative resources cannot be resolved during conversion	Keep resources next to the SVG file or use correct absolute paths

Online SVG to Image Converter

Use the free online SVG to JPG Converter or the general SVG Converter to test SVG-to-image conversion before implementing it in Python.

FAQ

How do I convert SVG to JPG in Python?

Load the SVG with SVGDocument, set ImageSaveOptions.format to ImageFormat.JPEG, and call Converter.convert_svg(document, options, output_path).

Can I convert SVG to BMP, TIFF, or GIF with the same code?

Yes. Change options.format to the required ImageFormat value and use the matching output file extension.

Why should I set a background color for JPG output?

JPG does not support transparency. A background color makes transparent SVG areas predictable in the converted image.

Can I control the output image size?

Yes. Configure options.page_setup.any_page with a Page, Size, and Margin, and set the resolution if needed.

Should I use Converter.convert_svg() or render_to()?

Use Converter.convert_svg() for ordinary file conversion. Use render_to() when you need a rendering-device workflow with ImageDevice.

Related Articles

• Convert SVG to PNG in Python focuses on PNG output and transparency.
• Convert SVG to PDF in Python explains PDF conversion options.
• Convert SVG Files in Python gives an overview of all supported conversion workflows.
• Create SVG File shows how to create or load SVG before conversion.
• Edit SVG File explains how to modify SVG content before saving it as an image.