Cómo rasterizar un PDF a imágenes en C#

¿Dónde se guardan las imágenes de salida?

Por defecto, las imágenes de salida se guardan en el directorio de trabajo actual de la aplicación, normalmente la carpeta bin/Debug o bin/Release del proyecto. Puede especificar una ruta absoluta o relativa para guardar las imágenes en una ubicación personalizada. Por ejemplo, @"C:\Output\page_*.png" guarda imágenes en el directorio C:\Output.

Si los valores de los campos de formulario deben ser visibles en las imágenes de salida, aplane el PDF antes de convertirlo en una imagen o pase true al parámetro Flatten del método. Los formularios no serán detectables tras usar el método Flatten. Obtenga más información sobre aplanar PDF para comprender mejor el proceso.

Aprende a rellenar y editar formularios PDF mediante programación en el artículo: "Cómo rellenar y editar formularios PDF."

¿Cómo puedo generar imágenes de mapa de bits de alta calidad?

Para conservar la resolución original de las imágenes al convertirlas a mapa de bits, utilice ToBitmapHighQuality en lugar de ToBitmap. El método ToBitmap devuelve una imagen decodificada desde JPEG, mientras que el método ToBitmapHighQuality devuelve una imagen decodificada desde el formato BMP.

El formato BMP almacena datos de píxeles sin procesar, lo que da como resultado imágenes más nítidas pero archivos de mayor tamaño. JPEG utiliza compresión con pérdida, lo que reduce significativamente el tamaño del archivo a costa de una ligera borrosidad. Para la mayoría de los casos de uso, como la impresión y visualización de PDF, la calidad de imagen JPEG es suficiente. Para los PDF que requieren una alta fidelidad visual, consulte nuestra guía sobre formateo HTML perfecto.

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-to-bitmap-high-quality.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("url.pdf");

var image = pdf.ToBitmapHighQuality();
image[0].SaveAs("output.png");

¿A qué formatos de imagen puedo exportar?

Otro parámetro permite especificar los tipos de archivo para las imágenes de salida. Los formatos admitidos son BMP, JPEG, PNG, GIF, TIFF y SVG. Cada tipo tiene un método correspondiente que puede invocarse directamente desde el objeto PdfDocument:

• ToBitmap: Rasteriza el PDF en objetos AnyBitmap individuales, un Bitmap por página.
• ToJpegImages: Renderiza páginas PDF como archivos JPEG y las guarda en disco.
• ToPngImages: Renderiza páginas PDF como archivos PNG y las guarda en disco.
• ToTiffImages: Renderiza páginas PDF como archivos TIFF de una sola página y las guarda en el disco.
• ToMultiPageTiffImage: Renderiza páginas PDF como un único archivo TIFF multipágina.
• Guardar como SVG: Convierte el PDF a formato SVG y lo guarda en la ruta especificada.
• ToSvgString: Convierte una página PDF específica a formato SVG y la devuelve como una cadena.

Para trabajar con gráficos vectoriales, explore nuestra guía sobre utilización de gráficos SVG en la generación de PDF, que complementa la funcionalidad de exportación de SVG.

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-image-type.cs

¿Cómo mejorar la claridad de la imagen con la configuración de PPP?

El DPI predeterminado de 96 puede producir imágenes borrosas. Para mejorar la claridad, especifique un valor de PPP más alto al rasterizar. DPI (puntos por pulgada) afecta directamente a la resolución y al tamaño del archivo. Los valores de DPI más altos producen imágenes más claras, pero dan lugar a archivos de mayor tamaño.

Ajustes DPI comunes:

• 96 PPP: Resolución de pantalla estándar para visualización web
• 150 PPP: Adecuado para la visualización general de documentos
• 300 DPI: alta calidad para impresión
• 600 PPP: Calidad de impresión Professional

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-dpi.cs

using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF with DPI 150
pdf.RasterizeToImageFiles("wikipage_*.png", DPI: 150);

¿Cómo convierto determinadas páginas en imágenes?

Puede especificar las páginas del documento PDF que desea rasterizar en imágenes. El siguiente ejemplo genera imágenes de las páginas 1-3 del PDF. Esta función es útil para crear miniaturas de páginas específicas o cuando se trabaja con documentos PDF de gran tamaño en los que sólo algunas páginas necesitan ser imágenes.

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-page-indexes.cs

using IronPdf;
using System.Linq;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF page 1_3
pdf.RasterizeToImageFiles("wikipage_*.png", Enumerable.Range(1, 3));

Para la manipulación avanzada de páginas, explore nuestras guías sobre añadir, copiar y eliminar páginas o dividir PDFs.

¿Cómo controlo las dimensiones de la imagen de salida?

Al convertir documentos PDF en imágenes, puede personalizar la altura y la anchura de las imágenes de salida. Los valores especificados representan las dimensiones máximas conservando la relación de aspecto del documento original. Para un documento PDF vertical, el valor de altura especificado será exacto, mientras que la anchura se ajustará para mantener la relación de aspecto correcta.

Esta función es esencial cuando las imágenes deben ajustarse a dimensiones específicas para su visualización en la web, miniaturas u otras aplicaciones que requieran un tamaño coherente. La conservación de la relación de aspecto garantiza que el contenido no aparezca estirado o distorsionado.

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-image-dimensions.cs

using IronPdf;

// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render PDF from web URL
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

// Export images from PDF
pdf.RasterizeToImageFiles("wikipage_*.png", 500, 500);

$vbLabelText   $csharpLabel

¿Qué ocurre con las relaciones de aspecto al establecer las dimensiones?

Las dimensiones de la imagen de salida se especifican utilizando el formato de anchura por altura (anchura x altura). IronPDF gestiona de forma inteligente la conservación de la relación de aspecto para garantizar que las imágenes mantengan las proporciones originales.

Retrato

Paisaje