Як обертати PDF-сторінки за допомогою Rest API у Ruby

Як перевертати PDF-сторінки за допомогою Rest API у Ruby

Давайте розглянемо сценарії, пов’язані з ротацією в документах PDF. Ви можете обертати всі сторінки або окремі PDF-сторінки програмним шляхом за допомогою Ruby у своїх програмах. Ми розглянемо наступні сценарії обертання сторінок PDF за допомогою простих прикладів функцій обертання PDF. У цій статті ми дізнаємося, як обертати PDF-сторінки за допомогою REST API в Ruby.

У цій статті будуть розглянуті такі теми:

PDF Pages Rotation Rest API та Ruby SDK

Ви можете повертати сторінки, встановлюючи кути обертання, як-от 90, 180 або 270 градусів, за допомогою API GroupDocs.Merger. Для обертання PDF-файлів я буду використовувати Ruby SDK API GroupDocs.Merger Cloud. Він дозволяє вам розділяти, об’єднувати, видаляти та змінювати порядок однієї сторінки або колекції сторінок із підтримуваних форматів документів Word, Excel, PDF, PowerPoint. ] і HTML тощо. Ви можете інсталювати GroupDocs.Merger Cloud SDK у свою програму Ruby за допомогою такої команди в терміналі:

gem install groupdocs_conversion_cloud

Будь ласка, отримайте свій ідентифікатор клієнта та секретний код на інформаційній панелі, перш ніж виконувати наведені нижче дії. Отримавши ідентифікатор і секрет, додайте наступне в код, як показано нижче:

# Завантажте камінь https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby у програму Ruby для http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# Отримайте свій client_id і client_secret на https://dashboard.groupdocs.cloud після безкоштовної реєстрації.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Після успішного налаштування API ви можете використовувати перелік Rotation, щоб вибрати відповідне значення обертання за годинниковою стрілкою.

Обертайте всі сторінки PDF-документа за допомогою Ruby

Ви можете програмно обертати PDF-сторінки в PDF-документі в хмарі, виконавши наведені нижче дії. Спочатку завантажте PDF-файл у хмару, і завантажений PDF-файл стане доступним у розділі файлів інформаційної панелі в хмарі. Може бути багато випадків використання, коли вам потрібно обертати файли PDF. Ви можете повернути всі сторінки файлу PDF, виконавши наведені нижче дії.

  • По-перше, створіть екземпляр PagesApi
  • Далі створіть екземпляр параметра RotateOptions
  • Потім створіть екземпляр FileInfo
  • Укажіть шлях до вхідного PDF-документа та шлях до вихідного файлу
  • Далі встановіть потрібний поворот сторінки, наприклад Rotate90
  • Після цього створіть RotateRequest з RotateOptions як аргумент
  • Нарешті, викличте метод rotate() і збережіть вихідний PDF-документ

У наступному фрагменті коду показано, як повернути всі сторінки PDF-файлу за допомогою REST API у Ruby:

# Цей приклад коду демонструє, як обертати всі сторінки в документі PDF.
# Створіть новий екземпляр PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Ініціалізація RotateOptions
@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-файл у хмарі.

Обертайте певні сторінки файлу PDF за допомогою Ruby

Обертання в документі PDF застосовується на рівні сторінки. Тому ви також можете обертати певні сторінки файлу PDF відповідно до ваших вимог. Вам потрібно лише вибрати номер сторінки, до якої потрібно застосувати обертання. Наведені нижче дії пояснюють, як обертати певні сторінки файлу PDF.

  • По-перше, створіть екземпляр PagesApi
  • Далі створіть екземпляр параметра RotateOptions
  • Потім створіть екземпляр FileInfo
  • Укажіть шлях до вхідного PDF-документа та шлях до вихідного файлу
  • Призначте точні номери сторінок за допомогою колекції сторінок
  • Встановіть потрібний поворот сторінки, наприклад Rotate90, Rotate180 або Rotate270
  • Після цього створіть RotateRequest з RotateOptions як аргумент
  • Нарешті, викличте метод rotate() і збережіть вихідний PDF-документ

У наведеному нижче фрагменті коду пояснюється, як обертати певні чи певні сторінки в документі PDF за допомогою Ruby:

# Цей приклад коду демонструє, як обертати сторінки у файлах PDF.
# Ініціалізуйте новий екземпляр PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Ініціалізація RotateOptions
@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"
# Укажіть точні номери сторінок, починаючи з 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-файл у хмарі.

Обертайте сторінки PDF, вказуючи номер сторінки за допомогою Ruby

Ви також можете обертати сторінки PDF за номером сторінки. Щоб застосувати ротацію, потрібно вказати номер початкової та кінцевої сторінок. Наведені нижче кроки пояснюють, як обертати сторінки PDF за номерами сторінок у файлі PDF.

  • По-перше, створіть екземпляр PagesApi
  • Далі створіть екземпляр параметра RotateOptions
  • Потім створіть екземпляр FileInfo
  • Укажіть шлях до вхідного PDF-документа та шлях до вихідного файлу
  • Встановіть значення номера початкової та кінцевої сторінок;
  • Встановіть потрібний поворот сторінки, наприклад Rotate270
  • Після цього створіть RotateRequest з RotateOptions як аргумент
  • Нарешті, викличте метод rotate() і збережіть вихідний PDF-документ

Наведений нижче фрагмент коду показує, як обертати сторінки в документі PDF, надаючи номери сторінок за допомогою Ruby Rest API:

# Цей приклад коду демонструє, як обертати документи PDF.
# Ініціалізуйте новий екземпляр PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Ініціалізація RotateOptions
@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-документ у хмарі.

Обертайте сторінки PDF, установивши режим діапазону за допомогою Ruby

Ви можете обертати зображення в PDF-документі під час додавання або вставлення зображення в PDF-файл. Це може бути корисно, коли ви хочете оновити або змінити орієнтацію зображення. Щоб повернути зображення на сторінці PDF, виконайте наведені нижче дії.

  • По-перше, створіть екземпляр PagesApi
  • Далі створіть екземпляр параметра RotateOptions
  • Потім створіть екземпляр FileInfo
  • Укажіть шлях до вхідного PDF-документа та шлях до вихідного файлу
  • Встановіть потрібний поворот сторінки, наприклад Rotate180
  • Далі встановіть значення номера початкової та кінцевої сторінок;
  • Тепер установіть режим діапазону на EvenPages, OddPages або AllPages
  • Після цього створіть RotateRequest з RotateOptions як аргумент
  • Нарешті, викличте метод rotate() і збережіть вихідний PDF-документ

У наведеному нижче коді показано, як програмно обертати зображення або картинку в документі PDF за допомогою Ruby:

# Цей приклад коду демонструє, як обертати сторінки в документі PDF.
# Ініціалізуйте новий екземпляр PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Ініціалізація RotateOptions
@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
# Установіть режим діапазону на «Усі сторінки», «Непарні сторінки» або «Парні сторінки»
@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.

Підводячи підсумки

У цій статті ви дізналися:

  • як обертати всі сторінки в документі PDF за допомогою Ruby;
  • як обертати певний PDF за допомогою Ruby;
  • як обертати сторінки PDF за номером сторінки за допомогою Ruby;
  • як обертати сторінки PDF за режимом діапазону за допомогою Ruby;

Крім того, ви можете дізнатися більше про GroupDocs.Merge Cloud API за допомогою документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. Крім того, groupdocs.cloud пише нові публікації в блозі на інші цікаві теми. Тому, будь ласка, залишайтеся на зв’язку для регулярних оновлень.

Задайте питання

Якщо у вас є будь-які запитання щодо ротації сторінок PDF, будь ласка, не соромтеся запитати нас на безкоштовному форумі підтримки

Дивись також