Convertir SVG a PNG en Python

Quick Answer: Para convertir SVG a PNG en Python, cargue el archivo fuente con SVGDocument, cree ImageSaveOptions y páselos a Converter.convert_svg(). PNG es el formato de imagen predeterminado y ImageSaveOptions permite controlar fondo, tamaño de página, márgenes y resolución.

Convertir SVG a PNG en Python

PNG es un formato ráster sin pérdida que admite transparencia. Es útil para gráficos web, vistas previas, miniaturas y aplicaciones que no renderizan SVG directamente.

El siguiente ejemplo convierte document.svg a result.png con ajustes PNG predeterminados:

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

El código realiza tres acciones:

1. SVGDocument carga el SVG y resuelve contenido y recursos vinculados.
2. ImageSaveOptions selecciona salida de imagen; el formato predeterminado es PNG.
3. Converter.convert_svg() renderiza el documento y escribe result.png.

Convertir SVG a PNG con opciones personalizadas

Use ImageSaveOptions cuando el PNG necesite un lienzo, fondo o resolución concretos. El ejemplo convierte winter.svg, añade fondo sólido, crea una página de 600 × 550 con márgenes de 10 píxeles y renderiza a 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)

El PNG resultante usa la configuración de página solicitada en lugar de depender solo del viewport SVG.

Propiedades importantes de ImageSaveOptions

Propiedad	Cuándo usarla
background_color	Rellenar áreas transparentes con un color elegido
page_setup	Definir dimensiones de página y márgenes
horizontal_resolution	Definir resolución horizontal en dpi
vertical_resolution	Definir resolución vertical en dpi
smoothing_mode	Controlar calidad de rasterización
text	Configurar renderizado de texto mediante TextOptions

Si background_color no se define, las áreas transparentes permanecen transparentes en PNG. La resolución afecta la densidad ráster y page_setup controla el lienzo de salida.

Errores comunes y soluciones

Problema	Causa probable	Solución
PNG vacío o recortado	SVG sin viewport útil o página de salida demasiado pequeña	Defina width, height o viewBox, o configure options.page_setup.any_page
Transparencias inesperadas	No se especificó fondo de salida	Defina options.background_color si necesita lienzo sólido
Texto diferente	Falta una fuente referenciada	Instale la fuente o vectorice texto si necesita glifos exactos
Faltan imágenes o CSS	No se resuelven recursos relativos	Cargue SVG desde su ruta o proporcione una base URI correcta
Dimensiones inesperadas	Tamaño de página y resolución se confunden	Use page_setup para dimensiones y horizontal_resolution/vertical_resolution para dpi

Conversor SVG a PNG en línea

También puede probar la conversión SVG a PNG en el navegador. Suba un SVG, seleccione PNG y compare el resultado con su salida programática.

FAQ

¿Cuál es la forma más corta de convertir SVG a PNG en Python?

Cree ImageSaveOptions, abra el origen con SVGDocument y llame a Converter.convert_svg(document, options, output_path).

¿La conversión SVG a PNG conserva la transparencia?

Sí. PNG admite transparencia y las áreas SVG transparentes permanecen transparentes salvo que defina ImageSaveOptions.background_color.

¿Cómo defino el tamaño del PNG?

Configure ImageSaveOptions.page_setup con Page, Size y Margin. Use la resolución por separado si necesita dpi concretos.

¿Puedo convertir contenido SVG almacenado en una cadena?

Sí. Cree un SVGDocument desde la cadena SVG y una base URI, y pase el documento a Converter.convert_svg().

Artículos relacionados

• Convertir archivos SVG en Python explica flujos de conversión y formatos de salida.
• Convertir SVG a PDF en Python muestra opciones PDF y PdfDevice.
• Convertir SVG a JPG en Python explica JPG cuando no se requiere transparencia.
• Convertir archivos SVG por lotes en Python muestra conversión de carpetas SVG.
• Convertir SVG a imagen cubre JPG, BMP, TIFF, GIF y otros formatos ráster.
• Crear archivo SVG muestra cómo crear o cargar SVG antes de convertir.
• Editar archivo SVG explica cómo modificar elementos SVG antes de guardar o convertir.
• Guardar archivo SVG explica cómo guardar documentos SVG.
• Navegar SVG muestra inspección con selectores CSS y XPath.
• Formatos de archivo compatibles lista formatos admitidos por Aspose.SVG for Python via .NET.
• Licencias explica licencias y licencias temporales.