如何在 Ruby 中使用 Rest API 旋转 PDF 页面

如何在 Ruby 中使用 Rest API 翻转 PDF 页面

让我们探索与 PDF 文档中的旋转相关的场景。您可以在应用程序中使用 Ruby 以编程方式旋转所有页面或特定 PDF 页面。我们将在 PDF 旋转功能的简单示例的帮助下完成以下 PDF 页面旋转场景。在本文中，我们将学习如何在 Ruby 中使用 REST API 旋转 PDF 页面。

本文应涵盖以下主题：

PDF 页面旋转 Rest API 和 Ruby SDK

您可以使用 GroupDocs.Merger API 设置 90、180 或 270 度等旋转角度来旋转页面。对于旋转 PDF 文件，我将使用 GroupDocs.Merger Cloud API 的 Ruby SDK。它允许您从 Word、Excel、PDF、PowerPoint 支持的文档格式中拆分、合并、删除和重新排列单个页面或页面集合] 和 HTML 等。您可以在终端中使用以下命令将 GroupDocs.Merger Cloud SDK 安装到您的 Ruby 应用程序：

gem install groupdocs_conversion_cloud

在执行以下提到的步骤之前，请从仪表板获取您的客户端 ID 和密码。获得 ID 和 Secret 后，在代码中添加以下内容，如下所示：

# 在 Ruby 应用程序中为 http://api.groupdocs.cloud 加载 gem https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby
require 'groupdocs_merger_cloud'

# 免费注册后，从 https://dashboard.groupdocs.cloud 获取您的 client_id 和 client_secret。
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

API 配置成功后，您可以使用 Rotation 枚举选择合适的顺时针旋转值。

使用 Ruby 旋转 PDF 文档的所有页面

您可以按照以下步骤在云端以编程方式旋转 PDF 文档中的 PDF 页面。首先，上传 PDF 文件到云端，上传的 PDF 文件将在云端仪表盘的文件部分 中可用。可能有很多用例需要旋转 PDF 文件。您可以按照以下步骤旋转 PDF 文件的所有页面：

  • 首先，创建 PagesApi 的实例
  • 接下来，创建 RotateOptions 的实例
  • 然后，创建 FileInfo 的实例
  • 提供输入PDF文档路径和输出文件路径
  • 接下来，设置所需的页面旋转，如 Rotate90
  • 之后，使用 RotateOptions 作为参数创建 RotateRequest
  • 最后调用rotate()方法，保存输出的PDF文档

以下代码片段展示了如何在 Ruby 中使用 REST API 旋转 PDF 文件的所有页面：

# 此代码示例演示如何旋转 PDF 文档中的所有页面。
# 创建一个新的 PagesApi 实例
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 初始化旋转选项
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate90-pages.pdf"
# 将所需的页面旋转设置为 90、180 或 270 度。
@options.mode = "Rotate90"

# 旋转 PDF 文件中的页面
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

最后，上面的代码示例会将更新后的 PDF 文件保存在云端。

使用 Ruby 旋转 PDF 文件的特定页面

PDF 文档中的旋转应用于页面级别。因此，您还可以根据需要旋转 PDF 文件的特定页面。您只需要选择要应用旋转的页码。以下步骤解释了如何旋转 PDF 文件的某些页面：

  • 首先，创建一个 PagesApi 实例
  • 接下来，创建 RotateOptions 的实例
  • 然后，创建 FileInfo 的实例
  • 提供输入PDF文档路径和输出文件路径
  • 使用页面集合分配确切的页码
  • 设置所需的页面旋转，如 Rotate90、Rotate180 或 Rotate270
  • 之后，使用 RotateOptions 作为参数创建 RotateRequest
  • 最后调用rotate()方法，保存输出的PDF文档

以下代码片段详细说明了如何使用 Ruby 旋转 PDF 文档中的特定或某些页面：

# 此代码示例演示如何在 PDF 文件中旋转页面。
# 初始化 PagesApi 的新实例
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 初始化旋转选项
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate180-pages.pdf"
# 通过 Pages 集合提供从 1 开始的准确页码
@options.pages = [1, 7]
@options.mode = "Rotate180"

# 旋转 PDF 文件中的页面
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

最后，上面的代码示例会将输出的 PDF 文件保存在云端。

使用 Ruby 通过提供页码来旋转 PDF 页面

您还可以按页码旋转 PDF 页面。您需要提供起始页码和结束页码才能应用轮换。以下步骤说明了如何按 PDF 文件的页码旋转 PDF 页面：

  • 首先，创建一个 PagesApi 实例
  • 接下来，创建 RotateOptions 的实例
  • 然后，创建 FileInfo 的实例
  • 提供输入PDF文档路径和输出文件路径
  • 设置起始页码和结束页码值；
  • 设置所需的页面旋转，如 Rotate270
  • 之后，使用 RotateOptions 作为参数创建 RotateRequest
  • 最后调用rotate()方法，保存输出的PDF文档

下面的代码片段展示了如何使用 Ruby Rest API 提供页码来旋转 PDF 文档中的页面：

# 此代码示例演示如何旋转 PDF 文档。
# 初始化 PagesApi 的新实例
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 初始化旋转选项
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate270-pages.pdf"
# 指定页面范围开始和结束页码
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# 旋转 PDF 文件中的页面
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

上面的代码示例会将输出的 PDF 文档保存在云端。

通过使用 Ruby 设置范围模式来旋转 PDF 页面

在 PDF 文件中添加或插入图像时，您可以旋转 PDF 文档中的图像。当您想要更新或更改图像的方向时，它会很有帮助。您可以按照以下步骤旋转 PDF 页面上的图像：

  • 首先，创建一个 PagesApi 实例
  • 接下来，创建 RotateOptions 的实例
  • 然后，创建 FileInfo 的实例
  • 提供输入PDF文档路径和输出文件路径
  • 设置所需的页面旋转，如 Rotate180
  • 接下来，设置起始页码和结束页码值；
  • 现在，将范围模式设置为 EvenPages 或 OddPages 或 AllPages
  • 之后，使用 RotateOptions 作为参数创建 RotateRequest
  • 最后调用rotate()方法，保存输出的PDF文档

以下代码演示了如何使用 Ruby 以编程方式旋转 PDF 文档中的图像或图片：

# 此代码示例演示如何在 PDF 文档中旋转页面。
# 初始化 PagesApi 的新实例
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 初始化旋转选项
@options = GroupDocsMergerCloud::RotateOptions.new
@options.file_info = GroupDocsMergerCloud::FileInfo.new
@options.file_info.file_path = 'flip_pages/pdf-pages.pdf'
@options.output_path = "flip_pages/rotate180-pages.pdf"
@options.mode = "Rotate180"
# 通过设置 range_mode 属性仅从指定的页面范围获取偶数页或奇数页。
@options.start_page_number = 1
@options.end_page_number = 10
# 将范围模式设置为“AllPages”或“OddPages”或“EvenPages”
@options.range_mode = "EvenPages"

# 在 PDF 文档中旋转页面
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

最后，上面的代码片段会将输出的 PDF 文档保存在云端。

免费在线旋转 PDF 页面

请尝试使用以下免费在线工具旋转PDF文档页面，它是使用上述API开发的。

加起来

在本文中，您已了解：

  • 如何使用 Ruby 旋转 PDF 文档中的所有页面；
  • 如何使用 Ruby 旋转某些 PDF；
  • 如何使用 Ruby 按页码旋转 PDF 页面；
  • 如何使用 Ruby 按范围模式旋转 PDF 页面；

此外，您可以使用 文档 了解有关 GroupDocs.Merge Cloud API 的更多信息。我们还提供了一个 API 参考 部分，让您可以直接通过浏览器可视化我们的 API 并与之交互。此外，groupdocs.cloud 正在撰写有关其他有趣主题的新博文。因此，请保持联系以获取定期更新。

问一个问题

如果您对 pdf 页面轮换有任何疑问，请随时在 免费支持论坛 上询问我们

也可以看看