Convertir SVG en PDF en Python

Quick Answer: Utilisez SVGDocument pour charger SVG, créez PdfSaveOptions et appelez Converter.convert_svg(document, options, output_path) pour enregistrer SVG en PDF. PdfSaveOptions permet de régler taille de page, fond, résolution, qualité JPEG, métadonnées ou chiffrement.

Convertir SVG en PDF par programmation

PDF est un format courant lorsque des graphiques SVG doivent être imprimés, archivés, intégrés à des documents ou partagés avec une mise en page stable. Aspose.SVG for Python via .NET permet de convertir SVG en PDF avec une API de conversion de haut niveau ou avec un périphérique de rendu.

Utilisez Converter.convert_svg() pour la plupart des conversions. Utilisez SVGDocument.render_to() avec PdfDevice si votre flux utilise déjà des périphériques de rendu.

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

Convertir SVG en PDF avec Converter.convert_svg()

Le plus simple consiste à charger le SVG avec SVGDocument, créer PdfSaveOptions et appeler Converter.convert_svg().

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

# Convert an SVG file to PDF using the default save options
options = PdfSaveOptions()

with SVGDocument("document.svg") as document:
    Converter.convert_svg(document, options, "document.pdf")

Convertir SVG en PDF avec des options personnalisées

Utilisez PdfSaveOptions pour contrôler la sortie PDF. L’exemple définit un fond transparent, ajuste la page au contenu SVG, modifie la résolution des images raster et règle la qualité JPEG.

import os
from aspose.svg import SVGDocument
from aspose.svg.converters import Converter
from aspose.svg.drawing import Resolution
from aspose.svg.rendering import SizingType
from aspose.svg.saving import PdfSaveOptions
from aspose.pydrawing import Color

# Convert SVG to PDF and customize page sizing and image quality
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "document.svg")
output_path = os.path.join(output_folder, "document.pdf")
os.makedirs(output_folder, exist_ok=True)

options = PdfSaveOptions()
options.background_color = Color.from_argb(0, 255, 255, 255)
options.page_setup.sizing = SizingType.FIT_CONTENT
options.horizontal_resolution = Resolution.from_dots_per_inch(96.0)
options.vertical_resolution = Resolution.from_dots_per_inch(96.0)
options.jpeg_quality = 80

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

Propriétés courantes de PdfSaveOptions

Propriété	Rôle
background_color	Fond de page si le SVG contient de la transparence
page_setup	Taille de page, marges et mode de dimensionnement
horizontal_resolution	Résolution horizontale des ressources raster dans le PDF
vertical_resolution	Résolution verticale des ressources raster dans le PDF
jpeg_quality	Qualité JPEG des images raster intégrées
document_info	Métadonnées PDF comme titre, auteur, sujet et mots-clés
encryption	Chiffrement PDF et permissions

PdfSaveOptions hérite des paramètres de rendu PDF de PdfRenderingOptions, donc de nombreuses propriétés sont partagées entre les flux converter et device.

Convertir SVG en PDF avec render_to()

La méthode render_to() envoie le document SVG chargé vers un périphérique de rendu. Ce modèle est utile si l’application travaille déjà avec des périphériques Aspose.SVG.

import os
from aspose.svg import SVGDocument
from aspose.svg.rendering import SizingType
from aspose.svg.rendering.pdf import PdfDevice, PdfRenderingOptions

# Render SVG to PDF through a PdfDevice
input_folder = "data/"
output_folder = "output/"
input_path = os.path.join(input_folder, "document.svg")
output_path = os.path.join(output_folder, "document.pdf")
os.makedirs(output_folder, exist_ok=True)

options = PdfRenderingOptions()
options.jpeg_quality = 80
options.page_setup.sizing = SizingType.FIT_CONTENT

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

Converter.convert_svg() ou render_to()

Méthode	Idéal pour
Converter.convert_svg()	Conversion SVG vers PDF directe avec peu de code et des options d’enregistrement
SVGDocument.render_to()	Flux de rendu utilisant des périphériques de sortie comme PdfDevice

Pour une conversion SVG vers PDF ordinaire, commencez par Converter.convert_svg(). Utilisez render_to() lorsque vous avez besoin du modèle à périphérique de rendu.

Erreurs courantes et solutions

Problème	Cause probable	Solution
La taille de page PDF est inattendue	La configuration par défaut ne correspond pas au viewport ou au contenu SVG	Définissez options.page_setup.sizing et configurez taille ou marges
Les zones transparentes ont un fond non souhaité	Le lecteur PDF ou le flux de sortie applique son propre fond	Définissez options.background_color avant conversion
Les images intégrées sont floues ou volumineuses	Résolution et qualité JPEG ne conviennent pas à la cible	Ajustez horizontal_resolution, vertical_resolution et jpeg_quality
Le PDF n’est pas créé	Le dossier cible n’existe pas ou le script enregistre ailleurs	Créez le dossier avec os.makedirs() et utilisez os.path.join()
Texte ou ressources externes manquent	SVG référence des polices, images ou CSS non résolus	Utilisez des chemins corrects et gardez les ressources près du SVG

Convertisseur SVG en PDF en ligne

Vous pouvez tester la conversion avec le SVG to PDF Converter gratuit. Téléversez un SVG, lancez la conversion et comparez le résultat avant de l’implémenter en Python.

FAQ

Comment convertir SVG en PDF en Python ?

Chargez SVG avec SVGDocument, créez PdfSaveOptions et appelez Converter.convert_svg(document, options, output_path).

Puis-je définir la taille de page PDF pendant la conversion ?

Oui. Utilisez page_setup dans PdfSaveOptions ou PdfRenderingOptions pour configurer taille, marges et mode de dimensionnement.

Puis-je convertir SVG en PDF sans la classe Converter ?

Oui. Créez PdfRenderingOptions, ouvrez un PdfDevice et appelez document.render_to(device).

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

Le contenu transparent peut être conservé, mais le résultat visible dépend du lecteur PDF et du flux. Définissez background_color pour un fond prévisible.

Comment réduire la taille du PDF généré ?

Réduisez jpeg_quality, diminuez la résolution des images raster intégrées et simplifiez les SVG volumineux ou complexes.

Articles associés

• Convertir SVG en PNG en Python explique les options de sortie raster.
• Convertir SVG en JPG en Python explique JPG avec fond.
• Convertir des fichiers SVG par lots en Python montre la conversion multiple.
• Convertir SVG en image en Python couvre JPG, BMP, TIFF, GIF et autres formats raster.
• Convertir des fichiers SVG en Python résume les formats pris en charge.