Как повернуть страницы PDF с помощью Rest API в Ruby

Как перевернуть страницы PDF с помощью Rest API в Ruby

Давайте рассмотрим сценарии, связанные с ротацией, в документах PDF. Вы можете поворачивать все страницы или определенные страницы PDF программно, используя Ruby в своих приложениях. Мы рассмотрим следующие сценарии поворота страниц PDF с помощью простых примеров функций поворота PDF. В этой статье мы узнаем, как поворачивать страницы PDF с помощью REST API в Ruby.

В этой статье должны быть раскрыты следующие темы:

PDF-страницы Rotation Rest API и Ruby SDK

Вы можете поворачивать страницы, устанавливая углы поворота, такие как 90, 180 или 270 градусов, используя GroupDocs.Merger API. Для поворота PDF-файлов я буду использовать Ruby SDK GroupDocs.Merger Cloud API. Это позволяет вам разделять, объединять, удалять и переупорядочивать одну страницу или набор страниц из поддерживаемых форматов документов 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
# Установите режим диапазона «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.

Подведение итогов

В этой статье вы узнали:

  • как повернуть все страницы в PDF-документе с помощью Ruby;
  • как повернуть определенный PDF с помощью Ruby;
  • как повернуть страницы PDF по номеру страницы с помощью Ruby;
  • как повернуть страницы PDF в режиме диапазона с помощью Ruby;

Кроме того, вы можете узнать больше о GroupDocs.Merge Cloud API, используя документацию. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер. Кроме того, groupdocs.cloud пишет новые сообщения в блоге на другие интересные темы. Поэтому, пожалуйста, оставайтесь на связи для регулярных обновлений.

Задайте вопрос

Если у вас есть какие-либо вопросы относительно ротации страниц в формате PDF, задайте их нам на Форуме бесплатной поддержки.

Смотрите также