Convertir SVG en PNG en Python

Quick Answer: Pour convertir SVG en PNG en Python, chargez la source avec SVGDocument, créez ImageSaveOptions et passez les deux objets à Converter.convert_svg(). PNG est le format image par défaut, et ImageSaveOptions contrôle fond, taille, marges et résolution.

Convertir SVG en PNG en Python

PNG est un format raster sans perte qui prend en charge la transparence. Il convient aux graphiques web, aperçus, miniatures et applications qui ne rendent pas SVG directement.

L’exemple suivant convertit document.svg en result.png avec les paramètres PNG par défaut :

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")

Le code effectue trois opérations :

1. SVGDocument charge le SVG et résout son contenu et ses ressources liées.
2. ImageSaveOptions sélectionne la sortie image ; le format par défaut est PNG.
3. Converter.convert_svg() rend le document et écrit result.png.

Convertir SVG en PNG avec des options personnalisées

Utilisez ImageSaveOptions lorsque le PNG nécessite un canevas, un fond ou une résolution précise. L’exemple convertit winter.svg, ajoute un fond uni, crée une page 600 × 550 avec des marges de 10 pixels et rend à 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)

Le PNG obtenu utilise les paramètres de page demandés au lieu de dépendre uniquement du viewport SVG.

Propriétés importantes de ImageSaveOptions

Propriété	Quand l’utiliser
background_color	Remplir les zones transparentes avec une couleur choisie
page_setup	Définir dimensions de page et marges
horizontal_resolution	Définir la résolution horizontale en dpi
vertical_resolution	Définir la résolution verticale en dpi
smoothing_mode	Contrôler la qualité de rasterisation
text	Configurer le rendu du texte via TextOptions

Si background_color n’est pas défini, les zones transparentes restent transparentes en PNG. La résolution agit sur la densité raster, tandis que page_setup contrôle le canevas de sortie.

Erreurs courantes et solutions

Problème	Cause probable	Solution
Le PNG est vide ou rogné	Le SVG n’a pas de viewport utile ou la page de sortie est trop petite	Définissez width, height ou viewBox, ou options.page_setup.any_page
Les zones transparentes sont inattendues	Aucun fond de sortie n’a été défini	Définissez options.background_color si un canevas uni est nécessaire
Le texte semble différent	Une police référencée est absente	Installez la police ou vectorisez le texte si la forme exacte est requise
Images ou CSS liés manquent	Les ressources relatives ne sont pas résolues	Chargez SVG depuis son chemin ou fournissez une base URI correcte
Les dimensions de sortie sont inattendues	Taille de page et résolution sont confondues	Utilisez page_setup pour les dimensions et la résolution pour les dpi

Convertisseur SVG en PNG en ligne

Vous pouvez aussi tester SVG vers PNG dans le navigateur. Téléversez un SVG, sélectionnez PNG et comparez le résultat avec votre sortie programmatique.

FAQ

Quel est le moyen le plus court de convertir SVG en PNG en Python ?

Créez ImageSaveOptions, ouvrez la source avec SVGDocument et appelez Converter.convert_svg(document, options, output_path).

La conversion SVG vers PNG conserve-t-elle la transparence ?

Oui. PNG prend en charge la transparence, et les zones SVG transparentes restent transparentes sauf si vous définissez ImageSaveOptions.background_color.

Comment définir la taille du PNG ?

Configurez ImageSaveOptions.page_setup avec Page, Size et Margin. Utilisez les propriétés de résolution séparément si vous avez besoin d’un dpi précis.

Puis-je convertir du contenu SVG stocké dans une chaîne ?

Oui. Créez un SVGDocument depuis la chaîne SVG et une base URI, puis passez ce document à Converter.convert_svg().

Articles associés

• Convertir des fichiers SVG en Python explique les flux et formats de conversion.
• Convertir SVG en PDF en Python montre les options PDF et PdfDevice.
• Convertir SVG en JPG en Python explique JPG sans transparence.
• Convertir des fichiers SVG par lots en Python montre la conversion de dossiers SVG.
• Convertir SVG en image couvre JPG, BMP, TIFF, GIF et autres sorties raster.
• Créer un fichier SVG montre comment créer ou charger SVG avant conversion.
• Modifier un fichier SVG explique comment modifier des éléments SVG avant conversion.