Convertir SVG a PDF en Python

Quick Answer: Use SVGDocument para cargar SVG, cree PdfSaveOptions y llame a Converter.convert_svg(document, options, output_path) para guardar SVG como PDF. Use PdfSaveOptions para configurar tamaño de página, fondo, resolución, calidad JPEG, metadatos o cifrado.

Convertir SVG a PDF programáticamente

PDF es un formato común cuando los gráficos SVG deben imprimirse, archivarse, adjuntarse a documentos o compartirse con diseño estable. Aspose.SVG for Python via .NET permite convertir SVG a PDF con una API de alto nivel o con un dispositivo de renderizado cuando necesita control explícito del pipeline.

Use Converter.convert_svg() para la mayoría de conversiones. Use SVGDocument.render_to() con PdfDevice cuando su flujo ya trabaja con dispositivos de renderizado.

Antes de ejecutar los ejemplos, instale Aspose.SVG for Python via .NET en su entorno Python.

Convertir SVG a PDF con Converter.convert_svg()

La forma más sencilla es cargar el SVG con SVGDocument, crear PdfSaveOptions y llamar a 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 a PDF con opciones personalizadas

Use PdfSaveOptions cuando necesite controlar la salida PDF. El ejemplo define un fondo transparente, ajusta la página al contenido SVG, cambia la resolución de imágenes ráster y ajusta la calidad 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)

Propiedades comunes de PdfSaveOptions

Propiedad	Qué controla
background_color	Color de fondo de página si el SVG tiene transparencia
page_setup	Tamaño de página, márgenes y modo de ajuste
horizontal_resolution	Resolución horizontal de recursos rasterizados en el PDF
vertical_resolution	Resolución vertical de recursos rasterizados en el PDF
jpeg_quality	Calidad JPEG de imágenes ráster incrustadas
document_info	Metadatos PDF como título, autor, asunto y palabras clave
encryption	Cifrado PDF y permisos

PdfSaveOptions hereda ajustes de renderizado PDF de PdfRenderingOptions, por lo que muchas propiedades son comunes para flujos con converter y con dispositivo.

Convertir SVG a PDF con render_to()

El método render_to() envía el SVG cargado a un dispositivo de renderizado. Es útil cuando la aplicación ya trabaja con dispositivos Aspose.SVG o debe elegir el dispositivo de destino explícitamente.

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() frente a render_to()

Método	Mejor para
Converter.convert_svg()	Conversión directa SVG a PDF con código breve y opciones de guardado
SVGDocument.render_to()	Flujos con dispositivos de salida como PdfDevice

Para conversión SVG a PDF normal, empiece con Converter.convert_svg(). Use render_to() cuando necesite el patrón basado en dispositivo.

Errores comunes y soluciones

Problema	Causa probable	Solución
El tamaño de página PDF no es el esperado	La configuración predeterminada no coincide con el viewport o contenido SVG	Configure options.page_setup.sizing, tamaño de página o márgenes
Las áreas transparentes aparecen con fondo no deseado	El visor PDF o el flujo de salida aplica su propio fondo	Defina options.background_color antes de convertir
Imágenes incrustadas borrosas o muy grandes	Resolución y calidad JPEG no coinciden con el destino	Ajuste horizontal_resolution, vertical_resolution y jpeg_quality
No se crea el PDF	La carpeta destino no existe o el script guarda en otro directorio	Cree la carpeta con os.makedirs() y use os.path.join()
Faltan texto o recursos externos	El SVG referencia fuentes, imágenes o CSS no resolubles	Use rutas correctas y mantenga recursos relativos al SVG

Conversor SVG a PDF en línea

Puede probar la conversión con el SVG to PDF Converter gratuito. Suba un SVG, ejecute la conversión y compare el resultado antes de implementarlo en Python.

FAQ

¿Cómo convierto SVG a PDF en Python?

Cargue SVG con SVGDocument, cree PdfSaveOptions y llame a Converter.convert_svg(document, options, output_path).

¿Puedo definir el tamaño de página PDF durante la conversión?

Sí. Use la propiedad page_setup de PdfSaveOptions o PdfRenderingOptions para configurar tamaño, márgenes y modo de ajuste.

¿Puedo convertir SVG a PDF sin usar Converter?

Sí. Cree PdfRenderingOptions, abra un PdfDevice y llame a document.render_to(device).

¿La conversión SVG a PDF conserva transparencia?

El contenido transparente puede conservarse, pero el resultado visible depende del visor PDF y del flujo. Defina background_color si necesita un fondo predecible.

¿Cómo reduzco el tamaño del PDF generado?

Reduzca jpeg_quality, baje la resolución de imágenes ráster incrustadas y simplifique SVG grandes o complejos antes de convertir.

Artículos relacionados

• Convertir SVG a PNG en Python explica conversión ráster y opciones de imagen.
• Convertir SVG a JPG en Python explica JPG con ajustes de fondo.
• Convertir archivos SVG por lotes en Python muestra conversión múltiple a PDF, PNG o JPG.
• Convertir SVG a imagen en Python cubre JPG, BMP, TIFF, GIF y otros formatos ráster.
• Convertir archivos SVG en Python resume todos los formatos de conversión.
• Crear archivo SVG muestra cómo crear o cargar SVG antes de convertir.
• Editar archivo SVG explica cómo modificar SVG antes de guardarlo o convertirlo.
• Guardar archivo SVG explica cómo guardar documentos SVG.
• Navegar SVG muestra cómo inspeccionar elementos SVG antes de convertir.
• Formatos de archivo compatibles lista formatos de entrada y salida.
• Licencias explica cómo aplicar una licencia o solicitar una temporal.