Давайте рассмотрим сценарии, связанные с ротацией, в документах PDF. Вы можете поворачивать все страницы или определенные страницы PDF программно, используя Ruby в своих приложениях. Мы рассмотрим следующие сценарии поворота страниц PDF с помощью простых примеров функций поворота PDF. В этой статье мы узнаем, как поворачивать страницы PDF с помощью REST API в Ruby.
В этой статье должны быть раскрыты следующие темы:
- PDF-страницы Rotation Rest API и Ruby SDK
- Повернуть все страницы PDF-документа с помощью Ruby
- Повернуть определенные страницы файла PDF с помощью Ruby
- Поверните страницы PDF, указав номер страницы с помощью Ruby
- Поверните страницы PDF, установив режим диапазона с помощью Ruby
- Онлайн поворот страниц PDF бесплатно
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, задайте их нам на Форуме бесплатной поддержки.