如何用 C# 将 PDF 栅格化为图像

输出图像保存在哪里？

默认情况下，输出图像会保存到应用程序的当前工作目录，通常是项目的 bin/Debug 或 bin/Release 文件夹。 您可以指定绝对路径或相对路径，将图像保存到自定义位置。 例如，@"C:\Output\page_*.png"将图像保存到C:\Output目录。

如果输出图像中的表单字段值应该可见，请在将 PDF 转换为图像之前对其进行扁平化处理，或向方法的 Flatten 参数传递 true。 使用Flatten方法后，表单将无法被检测到。 了解有关 flattening PDFs 的更多信息，以便更好地理解这一过程。

在文章中了解如何以编程方式填写和编辑 PDF 表单："如何填写和编辑 PDF 表单"。

如何生成高质量位图图像？

要在转换为Bitmap时保留图像的原始分辨率，请使用ToBitmap。 ToBitmapHighQuality方法返回从BMP格式解码的图像。

BMP 格式存储原始像素数据，因此图像更清晰，但文件尺寸更大。 JPEG 采用有损压缩，以轻微模糊为代价，大大减小了文件大小。 对于打印和查看 PDF 等大多数使用情况，JPEG 图像质量已经足够。 对于需要高视觉保真度的 PDF，请浏览我们的像素完美的 HTML 格式化指南。

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

我可以导出哪些图像格式？

另一个参数允许您指定输出图像的文件类型。 支持的格式包括 BMP、JPEG、PNG、GIF、TIFF 和 SVG。 每种类型都有一个相应的方法，可以直接从PdfDocument对象调用：

• ToBitmap：将PDF栅格化为单个AnyBitmap对象，每页一个Bitmap。
• ToJpegImages：将PDF页面渲染为JPEG文件并保存到磁盘。
• ToPngImages：将PDF页面渲染为PNG文件并保存到磁盘。
• ToTiffImages：将PDF页面渲染为单页TIFF文件并保存到磁盘。
• ToMultiPageTiffImage：将PDF页面渲染为多页的单个TIFF文件。
• SaveAsSvg：将PDF转换为SVG格式并保存到指定路径。
• ToSvgString：将特定的PDF页面转换为SVG格式并作为字符串返回。

如需使用矢量图形，请浏览我们的在 PDF 生成中使用 SVG 图形的指南，它是对 SVG 导出功能的补充。

:path=/static-assets/pdf/content-code-examples/how-to/rasterize-pdf-to-images-image-type.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", IronPdf.Imaging.ImageType.Png);

如何使用 DPI 设置提高图像清晰度？

默认 DPI 为 96，可能会产生模糊的输出图像。 为提高清晰度，请在光栅化时指定更高的 DPI 值。 DPI（点/英寸）直接影响分辨率和文件大小。DPI 值越高，图像越清晰，但文件尺寸也越大。

常用 DPI 设置：

• 96 DPI：网络显示的标准屏幕分辨率
• 150 DPI：适合查看一般文档
• 300 DPI：高质量，便于打印
• 600 DPI：专业打印质量

: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);

如何将特定页面转换为图像？

您可以指定将 PDF 文档中的哪些页面光栅化为图像。 下面的示例可生成 PDF 第 1-3 页的图像。该功能可用于创建特定页面的缩略图，或在处理大型 PDF 文档时只需将某些页面生成图像。

: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));

有关高级页面操作，请浏览我们的添加、复制和删除页面或分割 PDF 指南。

如何控制输出图像的尺寸？

将 PDF 文档转换为图像时，您可以自定义输出图像的高度和宽度。 指定值代表最大尺寸，同时保留原始文件的长宽比。 对于纵向 PDF 文档，指定的高度值将是精确的，而宽度会进行调整以保持正确的宽高比。

当图片必须符合特定尺寸才能在网络上显示、缩略图或其他要求尺寸一致的应用程序时，该功能就显得至关重要。 保持长宽比，确保内容不会出现拉伸或扭曲。

: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

设置尺寸时纵横比会发生什么变化？

输出图像的尺寸采用宽乘高格式（宽 x 高）。 IronPDF 可智能处理宽高比保留问题，确保图像保持原始比例。

Portrait

Landscape