Como girar páginas PDF usando Rest API em Ruby

Como virar páginas PDF usando Rest API em Ruby

Vamos explorar os cenários relacionados à rotação em documentos PDF. Você pode girar todas as páginas ou páginas PDF específicas programaticamente usando Ruby em seus aplicativos. Iremos percorrer os seguintes cenários de rotação de páginas PDF com a ajuda de exemplos simples de recursos de rotação de PDF. Neste artigo, aprenderemos como girar páginas PDF usando a API REST em Ruby.

Os seguintes tópicos serão abordados neste artigo:

API de descanso de rotação de páginas PDF e Ruby SDK

Você pode girar as páginas definindo ângulos de rotação como 90, 180 ou 270 graus usando a API GroupDocs.Merger. Para rotacionar arquivos PDF, usarei o Ruby SDK of GroupDocs.Merger Cloud API. Ele permite que você divida, combine, remova e reorganize uma única página ou uma coleção de páginas de formatos de documento suportados de Word, Excel, PDF, PowerPoint e HTML etc. Você pode instalar GroupDocs.Merger Cloud SDK em seu aplicativo Ruby usando o seguinte comando no terminal:

gem install groupdocs_conversion_cloud

Por favor, obtenha seu ID e Segredo do Cliente no painel antes de seguir as etapas abaixo mencionadas. Depois de ter seu ID e segredo, adicione o seguinte no código, conforme mostrado abaixo:

# Carregue a gem https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby no aplicativo Ruby para http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# Obtenha seu client_id e client_secret em https://dashboard.groupdocs.cloud após o registro gratuito.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Depois que a API for configurada com sucesso, você poderá usar a enumeração Rotation para selecionar um valor adequado de rotação no sentido horário.

Girar todas as páginas de um documento PDF usando Ruby

Você pode girar páginas PDF em um documento PDF programaticamente na nuvem seguindo as etapas abaixo. Primeiro, carregue o arquivo PDF para a nuvem e o arquivo PDF carregado estará disponível na seção de arquivos do painel na nuvem. Pode haver muitos casos de uso em que você precisa girar arquivos PDF. Você pode girar todas as páginas de um arquivo PDF seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do PagesApi
  • Em seguida, crie uma instância do RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Em seguida, defina a rotação de página desejada como Rotate90
  • Depois disso, crie o RotateRequest com RotateOptions como argumento
  • Por fim, chame o método rotate() e salve o documento PDF de saída

O trecho de código a seguir mostra como girar todas as páginas de um arquivo PDF usando a API REST em Ruby:

# Este exemplo de código demonstra como girar todas as páginas em um documento PDF.
# Crie uma nova instância de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar 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"
# Defina a rotação da página desejada para 90, 180 ou 270 graus.
@options.mode = "Rotate90"

# Girar páginas em arquivo PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

Por fim, o exemplo de código acima salvará o arquivo PDF atualizado na nuvem.

Girar páginas específicas do arquivo PDF usando Ruby

A rotação em um documento PDF é aplicada no nível da página. Portanto, você também pode girar páginas específicas do arquivo PDF de acordo com seus requisitos. Você só precisa escolher o número da página em que deseja aplicar a rotação. As etapas abaixo explicam como girar determinadas páginas do arquivo PDF:

  • Primeiro, crie uma instância da PagesApi
  • Em seguida, crie uma instância do RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Atribua os números de página exatos usando a coleção de páginas
  • Defina a rotação de página desejada como Rotate90, Rotate180 ou Rotate270
  • Depois disso, crie o RotateRequest com RotateOptions como argumento
  • Por fim, chame o método rotate() e salve o documento PDF de saída

O trecho de código a seguir detalha como girar páginas específicas ou determinadas em um documento PDF usando Ruby:

# Este exemplo de código demonstra como girar páginas em arquivos PDF.
# Inicializar nova instância de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar 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"
# Forneça números de página exatos a partir de 1 por meio da coleção de páginas
@options.pages = [1, 7]
@options.mode = "Rotate180"

# Girar páginas em arquivo PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

Por fim, o exemplo de código acima salvará o arquivo PDF de saída na nuvem.

Gire as páginas do PDF fornecendo o número da página usando Ruby

Você também pode girar páginas PDF por número de página. Você precisa fornecer o número da página inicial e o número da página final para aplicar a rotação. As etapas abaixo explicam como girar páginas PDF por números de página de um arquivo PDF:

  • Primeiro, crie uma instância da PagesApi
  • Em seguida, crie uma instância do RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Defina os valores do número da página inicial e do número da página final;
  • Defina a rotação de página desejada como Rotate270
  • Depois disso, crie o RotateRequest com RotateOptions como argumento
  • Por fim, chame o método rotate() e salve o documento PDF de saída

O trecho de código abaixo mostra como girar páginas em um documento PDF fornecendo números de página usando a API Ruby Rest:

# Este exemplo de código demonstra como girar documentos PDF.
# Inicializar nova instância de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar 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"
# Especifique os números da página inicial e final do intervalo de páginas
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# Girar páginas em arquivo PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

O exemplo de código acima salvará o documento PDF de saída na nuvem.

Girar páginas PDF definindo o modo de intervalo usando Ruby

Você pode girar a imagem em um documento PDF ao adicionar ou inserir a imagem no arquivo PDF. Pode ser útil quando você deseja atualizar ou alterar a orientação da imagem. Você pode seguir estas etapas para girar a imagem em uma página PDF:

  • Primeiro, crie uma instância da PagesApi
  • Em seguida, crie uma instância do RotateOptions
  • Em seguida, crie uma instância do FileInfo
  • Forneça o caminho do documento PDF de entrada e o caminho do arquivo de saída
  • Defina a rotação de página desejada como Rotate180
  • Em seguida, defina os valores do número da página inicial e do número da página final;
  • Agora, defina o modo de intervalo para EvenPages ou OddPages ou AllPages
  • Depois disso, crie o RotateRequest com RotateOptions como argumento
  • Por fim, chame o método rotate() e salve o documento PDF de saída

O código a seguir demonstra como girar uma imagem ou figura em um documento PDF programaticamente usando Ruby:

# Este exemplo de código demonstra como girar páginas em um documento PDF.
# Inicializar nova instância de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar 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"
# Obtenha apenas páginas pares ou ímpares do intervalo de páginas especificado definindo a propriedade range_mode.
@options.start_page_number = 1
@options.end_page_number = 10
# Defina o modo de intervalo como 'AllPages' ou 'OddPages' ou 'EvenPages'
@options.range_mode = "EvenPages"

# Girar páginas em documento PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

Por fim, o trecho de código acima salvará o documento PDF de saída na nuvem.

Girar páginas PDF on-line gratuitamente

Tente a seguinte ferramenta on-line gratuita para girar as páginas do documento PDF, que é desenvolvido usando a API acima.

Resumindo

Neste artigo, você aprendeu:

  • como girar todas as páginas em um documento PDF usando Ruby;
  • como girar determinado PDF usando Ruby;
  • como girar páginas PDF por número de página usando Ruby;
  • como girar páginas PDF por modo de intervalo usando Ruby;

Além disso, você pode aprender mais sobre GroupDocs.Merge Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Além disso, groupdocs.cloud está escrevendo novas postagens de blog sobre outros tópicos interessantes. Portanto, por favor, fique em contato para atualizações regulares.

Faça uma pergunta

Se você tiver alguma dúvida sobre a rotação de páginas PDF, sinta-se à vontade para nos perguntar no Fórum de suporte gratuito

Veja também