Convert SVG to JPG in Python

To convert SVG to JPG in Python, load the source with SVGDocument, create ImageSaveOptions with ImageFormat.JPEG, and call Converter.convert_svg(). Set a background color when the SVG contains transparent areas because JPG does not support transparency.

JPG and JPEG are two file extensions for the same image format. Converting SVG to JPG creates a raster image that is widely supported by browsers, office applications, content management systems, and image-processing tools. It is suitable for previews and illustrations when a transparent background and editable vector elements are not required.

Convert SVG to JPG in Python

The following example loads the existing tulips.svg file and converts it to JPG with the default rendering settings.

1. Load the SVG source into an SVGDocument.
2. Create ImageSaveOptions and select JPEG output.
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.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-default.jpg")

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

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

The generated tulips-default.jpg contains pixels rather than SVG paths and shapes. Keep the source SVG if the artwork must remain editable or scale without raster-image limitations.

Convert SVG to JPG Using ImageSaveOptions

The next example creates JPG output with a white background, a 500 × 500 CSS-pixel page, 10 CSS-pixel margins, and a resolution of 150 dpi. These settings provide a predictable canvas and prevent transparent SVG areas from receiving an unintended JPG background.

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
import aspose.pydrawing as pd

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-options.jpg")

# Configure JPEG output
options = sav.ImageSaveOptions(rim.ImageFormat.JPEG)
options.background_color = pd.Color.white
options.page_setup.first_page = dr.Page(
    dr.Size(500, 500),
    dr.Margin(10, 10, 10, 10)
)
options.horizontal_resolution = dr.Resolution.from_dots_per_inch(150.0)
options.vertical_resolution = dr.Resolution.from_dots_per_inch(150.0)

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

Page dimensions and resolution work together to determine the physical bitmap size. In this example, the 500 × 500 CSS-pixel page rendered at 150 dpi produces a JPG of approximately 781 × 781 pixels.

The following illustration previews the tulip pattern rendered by the example. The Python code writes the actual result in JPG format.

Useful ImageSaveOptions for JPG

Property	What it controls
format	Selects JPEG output. Use .jpg or .jpeg for the output file.
background_color	Fills transparent SVG areas before the result is saved in a format without transparency.
page_setup	Sets the output page dimensions and margins.
horizontal_resolution and vertical_resolution	Set the output and internal image resolution in pixels per inch.

Common SVG to JPG Issues

Problem	Likely cause and solution
The JPG has a dark or unexpected background	The source contains transparency, which JPG cannot store. Set background_color explicitly.
The image is cropped	The SVG viewport or configured output page is smaller than the visible artwork. Check the SVG viewBox, width, and height, or increase the page size.
Curves or text look blurred	The output dimensions or resolution are too low for the intended display size. Increase the page size or resolution before conversion.
Text uses a substituted font	A font referenced by the SVG is unavailable. Install the font or embed an appropriate font in the SVG.

FAQ

Are JPG and JPEG the same format?

Yes. .jpg and .jpeg are alternative extensions for the same JPEG image format. Use ImageFormat.JPEG with either extension.

Does JPG preserve SVG transparency?

No. JPG does not support transparent pixels. Set ImageSaveOptions.background_color to control how transparent areas are filled.

Is the converted JPG still scalable like SVG?

No. JPG is a raster format with fixed pixel dimensions. Enlarging it beyond the generated size can reduce apparent sharpness.

Related Guides

• SVG Converter – choose another SVG output format.
• Convert SVG to PNG – create lossless raster output that can preserve transparency.
• Convert SVG to PDF – convert SVG to a fixed-layout document.
• Fine-Tuning Converters – configure page setup, resolution, and rendering behavior.

Other Platforms

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

Try Online SVG to JPG Conversion

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