Convertir SVG a PDF – C#

Consideremos cómo convertir un documento SVG a un formato de archivo de formato de documento portátil (PDF). Con Aspose.HTML, puede convertir formato SVG a PDF mediante programación con control total sobre una amplia gama de parámetros de conversión.

En este artículo, encontrará información sobre cómo convertir SVG a PDF usando los métodos ConvertSVG() de la clase Converter y cómo aplicar los parámetros PdfSaveOptions y ICreateStreamProvider. Además, puede probar un convertidor SVG en línea para probar la funcionalidad API Aspose.HTML y convertir SVG sobre la marcha.

Convertidor SVG en línea

Puede convertir SVG a otros formatos con la API Aspose.HTML en tiempo real. Cargue SVG desde el sistema de archivos local, seleccione el formato de salida y ejecute el ejemplo. Las opciones de guardado están configuradas de forma predeterminada. Recibirá inmediatamente el resultado de la conversión como un archivo separado.

Si desea convertir un archivo SVG a PDF mediante programación, consulte los siguientes ejemplos de código C#.

SVG a PDF con una sola línea de código

Los métodos estáticos de la clase Converter se utilizan principalmente como la forma más sencilla de convertir un archivo SVG a varios formatos. ¡Puedes convertir SVG a PDF en tu aplicación C# literalmente con una sola línea de código!

En el siguiente ejemplo, tomamos un archivo SVG en un sistema de archivos local ( shapes.svg), lo convertimos y lo guardamos en el sistema de archivos local.

// Invoke the ConvertSVG() method for SVG to PDF conversion
Converter.ConvertSVG(Path.Combine(DataDir, "shapes.svg"), new PdfSaveOptions(), Path.Combine(OutputDir, "convert-with-single-line.pdf"));

Convertir SVG a PDF

Convertir un archivo a otro formato utilizando el método ConvertSVG() es una secuencia de operaciones entre las que se incluyen cargar y guardar documentos. En el siguiente ejemplo, creamos un archivo SVG a partir de código.

1. Prepare el código para un documento SVG.
2. Cree un nuevo objeto PdfSaveOptions.
3. Utilice el método ConvertSVG(content, baseUri, options, outputPath) de la clase Converter para guardar SVG como un archivo PDF.

Eche un vistazo al siguiente fragmento de código C# que muestra el proceso de conversión de SVG a PDF usando Aspose.HTML for .NET.

// Prepare SVG code
var code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
           "<circle cx ='100' cy ='100' r ='50' fill='none' stroke='red' stroke-width='5' />" +
           "</svg>";

// Prepare a path for converted file saving
string savePath = Path.Combine(OutputDir, "circle.pdf");
           
// Initialize PdfSaveOptions
var options = new PdfSaveOptions();

// Convert SVG to PDF
Converter.ConvertSVG(code, ".", options, savePath);

Puede descargar los ejemplos completos y los archivos de datos desde GitHub.

Opciones de guardado – PdfSaveOptions

Aspose.HTML permite convertir SVG a PDF usando opciones de guardado predeterminadas o personalizadas. El uso de PdfSaveOptions le permite personalizar el proceso de renderizado; puede especificar el tamaño de la página, los márgenes, el color de fondo, los permisos de archivos, CSS, etc.

Property	Description
JpegQuality	Specifies the quality of JPEG compression for images. The default value is 95.
Css	Gets a CssOptions object which is used for configuration of CSS properties processing.
DocumentInfo	This property contains information about the output PDF document.
BackgroundColor	This property sets the color that will fill the background of every page. By default, this property is Transparent.
PageSetup	This property gets a page setup object and uses it for configuration output page-set.
HorizontalResolution	Sets horizontal resolution for output images in pixels per inch. The default value is 300 dpi.
VerticalResolution	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
Encryption	This property gets or sets encryption details. If it is not set, then no encryption will be performed.

Para obtener más información sobre PdfSaveOptions, lea el artículo Convertidores de ajuste fino.

Convierta SVG a PDF usando PdfSaveOptions

Para convertir SVG a PDF con la especificación PdfSaveOptions, debe seguir algunos pasos:

1. Cargue un archivo SVG usando uno de los constructores SVGDocument() de la clase SVGDocument. ( aspose.svg).
2. Cree un nuevo objeto PdfSaveOptions y especifique las opciones de guardado.
3. Utilice el método ConvertSVG() para guardar SVG como un archivo PDF. Debe pasar SVGDocument, PdfSaveOptions y la ruta del archivo de salida al método ConvertSVG() para la conversión de SVG a PDF.

El siguiente fragmento de código C# muestra cómo convertir SVG a PDF usando opciones de guardado personalizadas:

// Prepare a path to a source SVG file
string documentPath = Path.Combine(DataDir, "aspose.svg");

// Prepare a path for converted file saving
string savePath = Path.Combine(OutputDir, "aspose-options.pdf");

// Initialize an SVG document from the file
using var document = new SVGDocument(documentPath);

// Initialize PdfSaveOptions. Set up the page-size, margins, resolutions, JpegQuality, and change the background color to AliceBlue
var options = new PdfSaveOptions()
{
    HorizontalResolution = 200,
    VerticalResolution = 200,
    BackgroundColor = System.Drawing.Color.AliceBlue,
    JpegQuality = 100
};
options.PageSetup.AnyPage = new Page(new Aspose.Html.Drawing.Size(500, 500), new Margin(30, 10, 10, 10));

// Convert SVG to PDF
Converter.ConvertSVG(document, options, savePath);

El constructor PdfSaveOptions() inicializa una instancia de la clase PdfSaveOptions que se pasa al método ConvertSVG(). El método ConvertSVG() toma el document, las options, la ruta del archivo de salida savePath y realiza la operación de conversión.

En el ejemplo anterior, usamos:

• Propiedad BackgroundColor que establece el color que rellenará el fondo. El color de fondo predeterminado es transparente.
• Propiedades HorizontalResolution y VerticalResolution que establecen la resolución horizontal/vertical para las imágenes de salida en píxeles por pulgada. De forma predeterminada, estas propiedades son 300 ppp.
• Propiedad JpegQuality que le permite especificar la calidad de la compresión JPEG para imágenes.
• Propiedad PageSetup que especifica el page size y los margins.

La clase PdfSaveOptions proporciona numerosas propiedades que le brindan control total sobre una amplia gama de parámetros y mejoran el proceso de conversión de SVG a formato PDF. Entre estas propiedades, JpegQuality que le permite especificar la calidad de la compresión JPEG para imágenes. El valor predeterminado es 95, pero puede configurar el requerido.

La figura ilustra el archivo aspose-options.pdf con el tamaño de página, color de fondo, etc. especificados.

Proveedores de flujo de salida – Output Stream Providers

Si es necesario guardar archivos en el almacenamiento remoto (por ejemplo, nube, base de datos, etc.), puede implementar la interfaz ICreateStreamProvider para tener control manual sobre el proceso de creación de archivos. Esta interfaz está diseñada como un objeto de devolución de llamada para crear una secuencia al comienzo del documento/página (según el formato de salida) y liberar la secuencia creada inicialmente después de renderizar el documento/página.

Aspose.HTML for .NET proporciona varios tipos de formatos de salida para operaciones de renderizado. Algunos de estos formatos producen un único archivo de salida (por ejemplo, PDF, XPS), otros crean varios archivos (formatos de imagen: JPG, PNG, etc.).

El siguiente ejemplo muestra cómo implementar y utilizar su propio MemoryStreamProvider en la aplicación:

class MemoryStreamProvider : Aspose.Html.IO.ICreateStreamProvider
{
    // List of MemoryStream objects created during the document rendering
    public List<MemoryStream> Streams { get; } = new List<MemoryStream>();

    public Stream GetStream(string name, string extension)
    {
        // This method is called when only one output stream is required, for instance for XPS, PDF or TIFF formats
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public Stream GetStream(string name, string extension, int page)
    {
        // This method is called when the creation of multiple output streams are required. For instance, during the rendering HTML to list of image files (JPG, PNG, etc.)
        MemoryStream result = new MemoryStream();
        Streams.Add(result);
        return result;
    }

    public void ReleaseStream(Stream stream)
    {
        // Here you can release the stream filled with data and, for instance, flush it to the hard-drive
    }

    public void Dispose()
    {
        // Releasing resources
        foreach (var stream in Streams)
            stream.Dispose();
    }
}

// Create an instance of MemoryStreamProvider
using var streamProvider = new MemoryStreamProvider();

// Prepare SVG code
var code = "<svg xmlns='http://www.w3.org/2000/svg'>" +
           "<circle cx='50' cy='50' r='40' stroke='black' stroke-width='3' fill='red' />" +
           "</svg>";

// Convert SVG to PDF using the MemoryStreamProvider
Converter.ConvertSVG(code, ".", new PdfSaveOptions(), streamProvider);

// Get access to the memory stream that contains the result data
var memory = streamProvider.Streams.First();
memory.Seek(0, SeekOrigin.Begin);

// Flush the result data to the output file
using (FileStream fs = File.Create(Path.Combine(OutputDir, "stream-provider.pdf")))
{
    memory.CopyTo(fs);
}

Compruebe la calidad de la conversión de SVG a PDF con nuestro Convertidor de SVG a PDF en línea. Sube, convierte tus archivos y obtén resultados en unos segundos. ¡Pruebe nuestro potente conversor de SVG a PDF gratis ahora!

Descargue nuestra biblioteca Aspose.HTML for .NET que le permite convertir con éxito, rápida y fácilmente sus documentos HTML, MHTML, EPUB, SVG y Markdown a los formatos más populares.

Puede descargar los ejemplos completos y los archivos de datos desde GitHub.