Python使用Spire.PDF轻松实现PDF页面旋转功能_Python

当我们在处理pdf文档时，经常会遇到页面方向不正确的问题——可能是扫描件倒置，或是生成的报告页面方向不统一，导致阅读体验极差，甚至影响打印效果。手动逐页调整不仅耗时费力，效率也极其低下。别担心！本文将为您揭示一个高效的解决方案：使用 python 旋转 pdf 页面。我们将重点介绍 spire.pdf 库，通过它，您将能够轻松实现旋转 pdf 页面的自动化操作，彻底告别繁琐的手动调整。

为什么选择 spire.pdf for python

spire.pdf 是一个功能强大且易于使用的pdf处理库，它允许开发者在python应用程序中创建、读取、编辑、转换和打印pdf文档。相较于其他一些库，spire.pdf python 旋转 功能的api设计直观，性能卓越，尤其适用于企业级应用和需要高效处理大量pdf文件的场景。其主要优势包括：

全面的pdf处理能力: 除了页面旋转，还支持文本提取、图片插入、水印添加、合并、拆分等多种操作。
兼容性与稳定性: 能够稳定处理各种复杂pdf文档，兼容性良好。
易用性: 提供了清晰的api接口和丰富的示例，降低了开发难度。

在开始之前，请确保您已经安装了 spire.pdf 库。如果尚未安装，可以通过以下命令轻松完成：

pip install spire.pdf

基础操作：旋转单个pdf页面

本节将详细讲解如何使用 spire.pdf 来旋转pdf文档中的特定页面。

导入库与加载pdf文档

首先，我们需要导入必要的库，并加载待处理的pdf文档。

from spire.pdf.common import *
from spire.pdf import *

# 创建一个pdfdocument对象
doc = pdfdocument()
# 加载现有的pdf文档
doc.loadfromfile("input.pdf")

请将 "input.pdf" 替换为您实际的pdf文件路径。

定义旋转角度与应用旋转

spire.pdf 提供了 pdfpagerotateangle 枚举类型来定义页面的旋转角度，包括 rotate_0 (不旋转), rotate_90 (顺时针旋转90度), rotate_180 (顺时针旋转180度), rotate_270 (顺时针旋转270度)。

我们可以通过访问 doc.pages[index] 来获取特定页面对象，然后设置其 rotation 属性。

以下代码示例将把pdf文档的第一页顺时针旋转90度：

# 获取pdf文档的第一页（索引从0开始）
page = doc.pages[0]

# 设置页面的旋转角度为顺时针90度
# 可以根据需要选择 pdfpagerotateangle.rotate_90, pdfpagerotateangle.rotate_180, pdfpagerotateangle.rotate_270
page.rotation = pdfpagerotateangle.rotate_90

# 如果需要基于当前旋转角度进行增量旋转，可以这样做：
# current_rotation = int(page.rotation.value)
# new_rotation = (current_rotation + int(pdfpagerotateangle.rotate_90.value)) % 360
# page.rotation = pdfpagerotateangle(new_rotation)

保存旋转后的pdf

完成页面旋转操作后，我们需要将修改后的pdf文档保存为新文件。

# 保存修改后的pdf文档
doc.savetofile("output_rotated_single_page.pdf")
doc.close()

这将把旋转后的pdf保存为 "output_rotated_single_page.pdf"。

进阶操作：批量旋转pdf页面

如果需要对pdf文档中的所有页面进行统一旋转，我们可以通过循环遍历所有页面来实现。

遍历所有页面并旋转

以下代码演示了如何遍历pdf文档的所有页面，并将它们全部顺时针旋转180度：

from spire.pdf.common import *
from spire.pdf import *

doc = pdfdocument()
doc.loadfromfile("input.pdf")

# 获取pdf文档的页面数量
page_count = doc.pages.count

# 遍历所有页面并进行旋转
for i in range(page_count):
    page = doc.pages[i]
    # 将每个页面顺时针旋转180度
    page.rotation = pdfpagerotateangle.rotate_180

# 保存修改后的pdf文档
doc.savetofile("output_rotated_all_pages.pdf")
doc.close()

根据条件选择性旋转

在某些场景下，您可能希望根据特定条件（例如，只有横向页面才旋转，或只旋转奇数页）进行选择性旋转。spire.pdf 允许您在循环中添加条件判断逻辑。

例如，只旋转奇数页：

# ... (加载pdf文档的代码) ...

for i in range(doc.pages.count):
    if (i + 1) % 2 != 0:  # 判断是否为奇数页
        page = doc.pages[i]
        page.rotation = pdfpagerotateangle.rotate_90

# ... (保存pdf文档的代码) ...

完整代码示例

为了方便您快速测试，以下是一个包含加载、旋转和保存的完整示例，您可以直接复制粘贴并运行：

from spire.pdf.common import *
from spire.pdf import *
import os

# 定义输入和输出文件路径
input_file = "input.pdf"
output_file_single = "output_rotated_single_page.pdf"
output_file_all = "output_rotated_all_pages.pdf"

# 确保输入文件存在
if not os.path.exists(input_file):
    print(f"错误：文件 '{input_file}' 不存在。请确保文件路径正确。")
else:
    # --- 示例1：旋转单个页面 ---
    print(f"正在处理：旋转 '{input_file}' 的第一页...")
    doc_single = pdfdocument()
    doc_single.loadfromfile(input_file)
    
    # 旋转第一页90度
    page_single = doc_single.pages[0]
    page_single.rotation = pdfpagerotateangle.rotate_90
    
    doc_single.savetofile(output_file_single)
    doc_single.close()
    print(f"第一页已旋转并保存为 '{output_file_single}'")

    # --- 示例2：旋转所有页面 ---
    print(f"正在处理：旋转 '{input_file}' 的所有页面...")
    doc_all = pdfdocument()
    doc_all.loadfromfile(input_file)
    
    # 遍历所有页面并旋转180度
    for i in range(doc_all.pages.count):
        page_all = doc_all.pages[i]
        page_all.rotation = pdfpagerotateangle.rotate_180
    
    doc_all.savetofile(output_file_all)
    doc_all.close()
    print(f"所有页面已旋转并保存为 '{output_file_all}'")

    print("\n所有操作完成！")