设置为灰度
from ironpdf import *

renderer = ChromePdfRenderer()

# Set Color and Grayscale
renderer.RenderingOptions.GrayScale = True

renderer.RenderHtmlFileAsPdf("my-content.html").SaveAs("my-content.pdf")
pip install ironpdf
设置为灰度

设置为灰度

IronPDF for Python 可以通过设置 RenderingOptions 上的一个属性将 PDF 完全渲染为灰度，将源 HTML 中的所有颜色转换为输出中的灰度。

开始

在调用任何渲染方法之前在一个 ChromePdfRenderer 实例上设置 RenderingOptions.GrayScale = True。 该渲染器生成的所有后续PDF将以灰度渲染。

理解代码

  • GrayScale = True：指示 IronPDF 将渲染输出中的所有颜色转换为灰度。 这适用于文本、背景、边框、图像以及HTML源中的任何其他彩色元素。
  • RenderHtmlFileAsPdf("my-content.html")：使用灰度设置渲染本地 HTML 文件。
  • SaveAs("my-content.pdf")：将灰度 PDF 保存到磁盘。

用例

灰度渲染在以下情况下很有用：

  • 减少文件大小 - 灰度PDF通常比彩色PDF更小。
  • 确保打印一致性 - 用于黑白打印机的文件在屏幕上和打印出来时看起来一样。
  • 满足无障碍要求 - 某些无障碍标准要求当颜色被去除时，文件保持可读性。

要仅以灰度渲染特定页面，可使用 GrayScale = True 分别渲染并使用 PdfDocument.Merge 将结果与全彩页面合并。

准备开始了吗？

版本:2026.11刚刚发布

免费 pip 安装