Cómo rotar páginas PDF usando Rest API en Ruby

Cómo voltear páginas PDF usando Rest API en Ruby

Exploremos los escenarios relacionados con la rotación en los documentos PDF. Puede rotar todas las páginas o páginas PDF específicas mediante programación usando Ruby en sus aplicaciones. Recorreremos los siguientes escenarios de rotación de páginas PDF con la ayuda de ejemplos simples de funciones de rotación de PDF. En este artículo, aprenderemos cómo rotar páginas PDF usando REST API en Ruby.

En este artículo se tratarán los siguientes temas:

API de descanso de rotación de páginas PDF y SDK de Ruby

Puede rotar páginas configurando ángulos de rotación como 90, 180 o 270 grados usando GroupDocs.Merger API. Para rotar archivos PDF, usaré Ruby SDK of GroupDocs.Merger Cloud API. Le permite dividir, combinar, eliminar y reorganizar una sola página o una colección de páginas de formatos de documentos admitidos de Word, Excel, PDF, PowerPoint y HTML, etc. Puede instalar GroupDocs.Merger Cloud SDK en su aplicación Ruby usando el siguiente comando en la terminal:

gem install groupdocs_conversion_cloud

Por favor, obtenga su ID de cliente y secreto desde el tablero antes de seguir los pasos mencionados a continuación. Una vez que tenga su ID y secreto, agregue lo siguiente en el código como se muestra a continuación:

# Cargue la gema https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby en la aplicación Ruby para http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# Obtenga su client_id y client_secret de https://dashboard.groupdocs.cloud después del registro gratuito.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Una vez que la API se haya configurado correctamente, puede usar la enumeración Rotación para seleccionar un valor adecuado de rotación en el sentido de las agujas del reloj.

Rotar todas las páginas de un documento PDF usando Ruby

Puede rotar páginas PDF en un documento PDF mediante programación en la nube siguiendo los pasos que se indican a continuación. Primero, cargue el archivo PDF a la nube y el archivo PDF cargado estará disponible en la sección de archivos del tablero en la nube. Podría haber muchos casos de uso en los que necesite rotar archivos PDF. Puede rotar todas las páginas de un archivo PDF siguiendo los pasos que se detallan a continuación:

  • En primer lugar, cree una instancia de PagesApi
  • A continuación, cree una instancia de RotateOptions
  • Luego, crea una instancia de FileInfo
  • Proporcione la ruta del documento PDF de entrada y la ruta del archivo de salida
  • A continuación, establezca la rotación de página deseada como Rotate90
  • Después de eso, cree RotateRequest con RotateOptions como argumento
  • Finalmente, llame al método rotate() y guarde el documento PDF de salida

El siguiente fragmento de código muestra cómo rotar todas las páginas de un archivo PDF usando REST API en Ruby:

# Este ejemplo de código demuestra cómo rotar todas las páginas en un documento PDF.
# Crear una nueva instancia de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar opciones de rotación
@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"
# Establezca la rotación de página deseada en 90, 180 o 270 grados.
@options.mode = "Rotate90"

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

Finalmente, el ejemplo de código anterior guardará el archivo PDF actualizado en la nube.

Rotar páginas específicas de un archivo PDF usando Ruby

La rotación en un documento PDF se aplica a nivel de página. Por lo tanto, también puede rotar páginas específicas del archivo PDF según sus requisitos. Solo necesita elegir el número de página en el que desea aplicar la rotación. Los pasos a continuación explican cómo rotar ciertas páginas de un archivo PDF:

  • En primer lugar, cree una instancia de PagesApi
  • A continuación, cree una instancia de RotateOptions
  • Luego, crea una instancia de FileInfo
  • Proporcione la ruta del documento PDF de entrada y la ruta del archivo de salida
  • Asigne los números de página exactos usando la colección de páginas
  • Establezca la rotación de página deseada como Rotate90, Rotate180 o Rotate270
  • Después de eso, cree RotateRequest con RotateOptions como argumento
  • Finalmente, llame al método rotate() y guarde el documento PDF de salida

El siguiente fragmento de código explica cómo rotar páginas específicas o ciertas en un documento PDF usando Ruby:

# Este ejemplo de código demuestra cómo rotar páginas en archivos PDF.
# Inicializar nueva instancia de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar opciones de rotación
@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"
# Proporcione números de página exactos a partir de 1 a través de la colección de páginas
@options.pages = [1, 7]
@options.mode = "Rotate180"

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

Finalmente, el ejemplo de código anterior guardará el archivo PDF de salida en la nube.

Rotar páginas PDF proporcionando el número de página usando Ruby

También puede rotar páginas PDF por número de página. Debe proporcionar el número de la página de inicio y el número de la página final para aplicar la rotación. Los pasos a continuación explican cómo rotar páginas PDF por números de página de un archivo PDF:

  • En primer lugar, cree una instancia de PagesApi
  • A continuación, cree una instancia de RotateOptions
  • Luego, crea una instancia de FileInfo
  • Proporcione la ruta del documento PDF de entrada y la ruta del archivo de salida
  • Establezca los valores de número de página de inicio y número de página final;
  • Establezca la rotación de página deseada como Rotate270
  • Después de eso, cree RotateRequest con RotateOptions como argumento
  • Finalmente, llame al método rotate() y guarde el documento PDF de salida

El fragmento de código a continuación muestra cómo rotar páginas en un documento PDF al proporcionar números de página usando Ruby Rest API:

# Este ejemplo de código demuestra cómo rotar documentos PDF.
# Inicializar nueva instancia de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar opciones de rotación
@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 los números de página inicial y final del rango de páginas
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

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

El ejemplo de código anterior guardará el documento PDF de salida en la nube.

Gire páginas PDF configurando el modo de rango usando Ruby

Puede rotar la imagen en un documento PDF mientras agrega o inserta la imagen en el archivo PDF. Puede ser útil cuando desee actualizar o cambiar la orientación de la imagen. Puede seguir estos pasos para rotar la imagen en una página PDF:

  • En primer lugar, cree una instancia de PagesApi
  • A continuación, cree una instancia de RotateOptions
  • Luego, crea una instancia de FileInfo
  • Proporcione la ruta del documento PDF de entrada y la ruta del archivo de salida
  • Establezca la rotación de página deseada como Rotate180
  • A continuación, establezca los valores de número de página de inicio y número de página final;
  • Ahora, establezca el modo de rango en EvenPages o OddPages o AllPages
  • Después de eso, cree RotateRequest con RotateOptions como argumento
  • Finalmente, llame al método rotate() y guarde el documento PDF de salida

El siguiente código demuestra cómo rotar una imagen o imagen en un documento PDF mediante programación usando Ruby:

# Este ejemplo de código demuestra cómo rotar páginas en un documento PDF.
# Inicializar nueva instancia de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializar opciones de rotación
@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"
# Obtenga solo páginas pares o impares del rango de páginas especificado configurando la propiedad range_mode.
@options.start_page_number = 1
@options.end_page_number = 10
# Establezca el modo de rango en 'Todas las páginas' o 'Páginas impares' o 'Páginas pares'
@options.range_mode = "EvenPages"

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

Finalmente, el fragmento de código anterior guardará el documento PDF de salida en la nube.

Rotar páginas PDF en línea gratis

Pruebe la siguiente herramienta en línea gratuita para rotar páginas de documentos PDF, que se desarrolla utilizando la API anterior.

Resumiendo

En este artículo, has aprendido:

  • cómo rotar todas las páginas de un documento PDF usando Ruby;
  • cómo rotar ciertos PDF usando Ruby;
  • cómo rotar páginas PDF por número de página usando Ruby;
  • cómo rotar páginas PDF por modo de rango usando Ruby;

Además, puede obtener más información sobre GroupDocs.Merge Cloud API utilizando la documentación. También proporcionamos una sección Referencia de API que le permite visualizar e interactuar con nuestras API directamente a través del navegador. Además, groupdocs.cloud está escribiendo nuevas publicaciones de blog sobre otros temas interesantes. Por lo tanto, manténgase en contacto para recibir actualizaciones periódicas.

Hacer una pregunta

Si tiene alguna consulta sobre la rotación de páginas PDF, no dude en consultarnos en Foro de soporte gratuito

Ver también