如何在 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 頁面輪換有任何疑問，請隨時在 免費支持論壇 上詢問我們

也可以看看