Convertir des fichiers SVG par lots en Python

Quick Answer: Pour convertir des fichiers SVG par lots en Python, parcourez un dossier d’entrée, chargez chaque fichier .svg avec SVGDocument, créez les options du format cible et appelez Converter.convert_svg() pour chaque fichier de sortie.

Flux de conversion par lots

La conversion par lots est utile quand une application doit produire des vignettes, des aperçus web, des images de rapport exportées ou des copies PDF pour un dossier de fichiers SVG. Le flux est le même que pour un seul fichier, mais il est répété pour chaque source :

1. Choisir un dossier d’entrée et un dossier de sortie.
2. Créer les options du format cible, par exemple ImageSaveOptions ou PdfSaveOptions.
3. Parcourir les fichiers .svg.
4. Charger chaque SVG avec SVGDocument.
5. Convertir le document avec Converter.convert_svg() et écrire le fichier de sortie.

Avant d’exécuter les exemples, installez Aspose.SVG for Python via .NET dans votre environnement Python.

Convertir SVG en PNG par lots

PNG est un bon choix par défaut pour les aperçus web et les sorties raster transparentes. L’exemple suivant convertit chaque fichier .svg du dossier data/svg/ en fichier .png dans output/png/.

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

# Batch convert SVG files to PNG
input_folder = "data/svg/"
output_folder = "output/png/"
os.makedirs(output_folder, exist_ok=True)

options = ImageSaveOptions()

for file_name in os.listdir(input_folder):
    if not file_name.lower().endswith(".svg"):
        continue

    input_path = os.path.join(input_folder, file_name)
    output_name = os.path.splitext(file_name)[0] + ".png"
    output_path = os.path.join(output_folder, output_name)

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

Convertir SVG en JPG par lots

Lors de la conversion en JPG, définissez ImageFormat.JPEG et choisissez une couleur de fond, car JPG ne prend pas en charge la transparence.

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.rendering.image import ImageFormat
from aspose.svg.saving import ImageSaveOptions
from aspose.pydrawing import Color

# Batch convert SVG files to JPG with a solid background
input_folder = "data/svg/"
output_folder = "output/jpg/"
os.makedirs(output_folder, exist_ok=True)

options = ImageSaveOptions()
options.format = ImageFormat.JPEG
options.background_color = Color.from_argb(255, 255, 255)

for file_name in os.listdir(input_folder):
    if not file_name.lower().endswith(".svg"):
        continue

    input_path = os.path.join(input_folder, file_name)
    output_name = os.path.splitext(file_name)[0] + ".jpg"
    output_path = os.path.join(output_folder, output_name)

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

Convertir SVG en PDF par lots

Utilisez PdfSaveOptions lorsque chaque fichier SVG doit devenir un fichier PDF séparé.

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.saving import PdfSaveOptions

# Batch convert SVG files to separate PDF files
input_folder = "data/svg/"
output_folder = "output/pdf/"
os.makedirs(output_folder, exist_ok=True)

options = PdfSaveOptions()

for file_name in os.listdir(input_folder):
    if not file_name.lower().endswith(".svg"):
        continue

    input_path = os.path.join(input_folder, file_name)
    output_name = os.path.splitext(file_name)[0] + ".pdf"
    output_path = os.path.join(output_folder, output_name)

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

Créer un convertisseur par lots réutilisable

Les exemples précédents répètent la même boucle de dossiers pour PNG, JPG et PDF. Dans le code d’une application, il est généralement plus clair de garder cette boucle dans une fonction auxiliaire et de passer seulement les éléments qui changent : le dossier de sortie, l’extension de sortie et les options d’enregistrement.

Utilisez ce modèle lorsque votre projet prend en charge plusieurs formats d’export et que vous ne voulez pas maintenir trois boucles séparées. La fonction ci-dessous crée toujours un fichier de sortie par SVG ; elle supprime seulement le code répété.

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.rendering.image import ImageFormat
from aspose.svg.saving import ImageSaveOptions, PdfSaveOptions
from aspose.pydrawing import Color

def batch_convert_svg(input_folder, output_folder, output_extension, options):
    os.makedirs(output_folder, exist_ok=True)

    for file_name in os.listdir(input_folder):
        if not file_name.lower().endswith(".svg"):
            continue

        input_path = os.path.join(input_folder, file_name)
        output_name = os.path.splitext(file_name)[0] + output_extension
        output_path = os.path.join(output_folder, output_name)

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

input_folder = "data/svg/"

# Reuse the same helper for PNG output
png_options = ImageSaveOptions()
batch_convert_svg(input_folder, "output/png/", ".png", png_options)

# Reuse the same helper for JPG output
jpg_options = ImageSaveOptions()
jpg_options.format = ImageFormat.JPEG
jpg_options.background_color = Color.from_argb(255, 255, 255)
batch_convert_svg(input_folder, "output/jpg/", ".jpg", jpg_options)

# Reuse the same helper for PDF output
pdf_options = PdfSaveOptions()
batch_convert_svg(input_folder, "output/pdf/", ".pdf", pdf_options)

Erreurs courantes et solutions

Problème	Cause probable	Solution
Aucun fichier n’est converti	Le script utilise le mauvais dossier d’entrée ou filtre la mauvaise extension	Affichez input_folder et vérifiez qu’il contient des fichiers .svg
Les fichiers de sortie s’écrasent	Plusieurs fichiers d’entrée produisent le même nom de base	Conservez les sous-dossiers ou ajoutez un suffixe aux noms générés
Images liées ou CSS manquent	Les ressources relatives ne sont pas disponibles à côté du SVG source	Chargez chaque SVG depuis son chemin d’origine et gardez les ressources aux emplacements relatifs attendus
Le JPG a un fond inattendu	JPG ne prend pas en charge la transparence	Définissez ImageSaveOptions.background_color
Un SVG incorrect arrête tout le lot	Les exceptions ne sont pas gérées fichier par fichier	Encapsulez chaque conversion dans try/except et journalisez les fichiers en échec

FAQ

Comment convertir des fichiers SVG par lots en Python ?

Parcourez un dossier d’entrée, chargez chaque fichier .svg avec SVGDocument et appelez Converter.convert_svg() avec les options d’enregistrement nécessaires.

Puis-je convertir SVG en JPG par lots ?

Oui. Utilisez ImageSaveOptions, définissez options.format = ImageFormat.JPEG, choisissez une couleur de fond et enregistrez chaque fichier de sortie avec l’extension .jpg.

Puis-je convertir SVG en PDF par lots ?

Oui. Utilisez PdfSaveOptions et écrivez chaque document converti dans un chemin de sortie .pdf.

Puis-je convertir des fichiers SVG dans des sous-dossiers ?

Oui. Utilisez un parcours récursif des dossiers dans votre code Python et créez les dossiers de sortie correspondants avant l’enregistrement.

Puis-je créer un seul PDF à partir de plusieurs fichiers SVG ?

Ce flux par lots crée un fichier de sortie par SVG. Si vous avez besoin d’un PDF multi-page combiné, utilisez la classe SvgRenderer avec un périphérique de sortie PdfDevice ; le renderer peut envoyer plusieurs documents SVG vers le même périphérique PDF.

Articles associés

• Convertir des fichiers SVG en Python donne une vue d’ensemble des formats et API de conversion.
• Convertir SVG en PNG en Python explique les options de sortie PNG.
• Convertir SVG en JPG en Python explique les fonds JPG, la mise en page et la résolution.
• Convertir SVG en PDF en Python explique les options de conversion PDF.
• Créer un fichier SVG montre comment charger des documents SVG avant conversion.