Comment faire pivoter des pages PDF à l'aide de l'API Rest dans Ruby

Comment retourner des pages PDF à l’aide de l’API Rest dans Ruby

Explorons les scénarios liés à la rotation dans les documents PDF. Vous pouvez faire pivoter toutes les pages ou des pages PDF spécifiques par programmation à l’aide de Ruby dans vos applications. Nous allons parcourir les scénarios de rotation de pages PDF suivants à l’aide d’exemples simples de fonctionnalités de rotation PDF. Dans cet article, nous allons apprendre à faire pivoter des pages PDF à l’aide de l’API REST dans Ruby.

Les sujets suivants seront traités dans cet article :

API de repos de rotation des pages PDF et SDK Ruby

Vous pouvez faire pivoter les pages en définissant des angles de rotation tels que 90, 180 ou 270 degrés à l’aide de l’API GroupDocs.Merger. Pour la rotation des fichiers PDF, j’utiliserai le Ruby SDK of GroupDocs.Merger Cloud API. Il vous permet de diviser, combiner, supprimer et réorganiser une seule page ou une collection de pages à partir des formats de document pris en charge de Word, Excel, PDF, PowerPoint, et HTML etc. Vous pouvez installer GroupDocs.Merger Cloud SDK sur votre application Ruby à l’aide de la commande suivante dans le terminal :

gem install groupdocs_conversion_cloud

Veuillez obtenir votre ID client et votre secret à partir du tableau de bord avant de suivre les étapes mentionnées ci-dessous. Une fois que vous avez votre identifiant et votre secret, ajoutez ce qui suit dans le code comme indiqué ci-dessous :

# Chargez la gemme https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby dans l'application Ruby pour http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# Obtenez votre client_id et client_secret sur https://dashboard.groupdocs.cloud après une inscription gratuite.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Une fois l’API configurée avec succès, vous pouvez utiliser l’énumération Rotation pour sélectionner une valeur de rotation appropriée dans le sens des aiguilles d’une montre.

Faire pivoter toutes les pages d’un document PDF à l’aide de Ruby

Vous pouvez faire pivoter des pages PDF dans un document PDF par programmation sur le cloud en suivant les étapes ci-dessous. Tout d’abord, téléchargez le fichier PDF dans le cloud et le fichier PDF téléchargé sera disponible dans la section fichiers du tableau de bord sur le cloud. Il peut y avoir de nombreux cas d’utilisation où vous devez faire pivoter des fichiers PDF. Vous pouvez faire pivoter toutes les pages d’un fichier PDF en suivant les étapes ci-dessous :

  • Tout d’abord, créez une instance de PagesApi
  • Ensuite, créez une instance de RotateOptions
  • Ensuite, créez une instance de FileInfo
  • Fournissez le chemin du document PDF d’entrée et le chemin du fichier de sortie
  • Ensuite, définissez la rotation de page souhaitée comme Rotate90
  • Après cela, créez le RotateRequest avec RotateOptions comme argument
  • Enfin, appelez la méthode rotate() et enregistrez le document PDF de sortie

L’extrait de code suivant montre comment faire pivoter toutes les pages d’un fichier PDF à l’aide de l’API REST dans Ruby :

# Cet exemple de code montre comment faire pivoter toutes les pages d'un document PDF.
# Créer une nouvelle instance de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Initialiser 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"
# Réglez la rotation de page souhaitée sur 90, 180 ou 270 degrés.
@options.mode = "Rotate90"

# Faire pivoter les pages d'un fichier PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

Enfin, l’exemple de code ci-dessus enregistrera le fichier PDF mis à jour sur le cloud.

Faire pivoter des pages spécifiques d’un fichier PDF à l’aide de Ruby

La rotation dans un document PDF est appliquée au niveau de la page. Par conséquent, vous pouvez également faire pivoter des pages spécifiques du fichier PDF selon vos besoins. Il vous suffit de choisir le numéro de page sur lequel vous souhaitez appliquer la rotation. Les étapes ci-dessous expliquent comment faire pivoter certaines pages d’un fichier PDF :

  • Tout d’abord, créez une instance de PagesApi
  • Ensuite, créez une instance de RotateOptions
  • Ensuite, créez une instance de FileInfo
  • Fournissez le chemin du document PDF d’entrée et le chemin du fichier de sortie
  • Attribuez les numéros de page exacts à l’aide de la collection de pages
  • Définissez la rotation de page souhaitée comme Rotate90, Rotate180 ou Rotate270
  • Après cela, créez le RotateRequest avec RotateOptions comme argument
  • Enfin, appelez la méthode rotate() et enregistrez le document PDF de sortie

L’extrait de code suivant explique comment faire pivoter des pages spécifiques ou certaines pages d’un document PDF à l’aide de Ruby :

# Cet exemple de code montre comment faire pivoter des pages dans des fichiers PDF.
# Initialiser la nouvelle instance de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Initialiser 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"
# Fournissez des numéros de page exacts à partir de 1 via la collection Pages
@options.pages = [1, 7]
@options.mode = "Rotate180"

# Faire pivoter les pages d'un fichier PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

Enfin, l’exemple de code ci-dessus enregistrera le fichier PDF de sortie sur le cloud.

Faire pivoter les pages PDF en fournissant un numéro de page à l’aide de Ruby

Vous pouvez également faire pivoter les pages PDF par numéro de page. Vous devez fournir le numéro de page de début et le numéro de page de fin pour appliquer la rotation. Les étapes ci-dessous expliquent comment faire pivoter les pages PDF par numéros de page d’un fichier PDF :

  • Tout d’abord, créez une instance de PagesApi
  • Ensuite, créez une instance de RotateOptions
  • Ensuite, créez une instance de FileInfo
  • Fournissez le chemin du document PDF d’entrée et le chemin du fichier de sortie
  • Définissez les valeurs du numéro de page de début et du numéro de page de fin ;
  • Définissez la rotation de page souhaitée comme Rotate270
  • Après cela, créez le RotateRequest avec RotateOptions comme argument
  • Enfin, appelez la méthode rotate() et enregistrez le document PDF de sortie

L’extrait de code ci-dessous montre comment faire pivoter des pages dans un document PDF en fournissant des numéros de page à l’aide de l’API Ruby Rest :

# Cet exemple de code montre comment faire pivoter des documents PDF.
# Initialiser la nouvelle instance de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Initialiser 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"
# Spécifiez les numéros de page de début et de fin de la plage de pages
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# Faire pivoter les pages d'un fichier PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

L’exemple de code ci-dessus enregistrera le document PDF de sortie sur le cloud.

Faire pivoter les pages PDF en définissant le mode de plage à l’aide de Ruby

Vous pouvez faire pivoter l’image dans un document PDF lors de l’ajout ou de l’insertion de l’image dans le fichier PDF. Cela peut être utile lorsque vous souhaitez mettre à jour ou modifier l’orientation de l’image. Vous pouvez suivre ces étapes pour faire pivoter l’image sur une page PDF :

  • Tout d’abord, créez une instance de PagesApi
  • Ensuite, créez une instance de RotateOptions
  • Ensuite, créez une instance de FileInfo
  • Fournissez le chemin du document PDF d’entrée et le chemin du fichier de sortie
  • Définissez la rotation de page souhaitée comme Rotate180
  • Ensuite, définissez les valeurs du numéro de page de début et du numéro de page de fin ;
  • Maintenant, définissez le mode de plage sur EvenPages ou OddPages ou AllPages
  • Après cela, créez le RotateRequest avec RotateOptions comme argument
  • Enfin, appelez la méthode rotate() et enregistrez le document PDF de sortie

Le code suivant montre comment faire pivoter une image ou une image dans un document PDF par programmation à l’aide de Ruby :

# Cet exemple de code montre comment faire pivoter des pages dans un document PDF.
# Initialiser la nouvelle instance de PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Initialiser 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"
# Obtenez uniquement les pages paires ou impaires de la plage de pages spécifiée en définissant la propriété range_mode.
@options.start_page_number = 1
@options.end_page_number = 10
# Définissez le mode de plage sur 'AllPages' ou 'OddPages' ou 'EvenPages'
@options.range_mode = "EvenPages"

# Faire pivoter les pages d'un document PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

Enfin, l’extrait de code ci-dessus enregistrera le document PDF de sortie sur le cloud.

Faire pivoter les pages PDF en ligne gratuitement

Veuillez essayer l’outil en ligne gratuit suivant pour faire pivoter les pages d’un document PDF, qui est développé à l’aide de l’API ci-dessus.

Résumé

Dans cet article, vous avez appris :

  • comment faire pivoter toutes les pages d’un document PDF à l’aide de Ruby ;
  • comment faire pivoter certains PDF en utilisant Ruby ;
  • comment faire pivoter les pages PDF par numéro de page à l’aide de Ruby ;
  • comment faire pivoter les pages PDF en mode plage à l’aide de Ruby ;

De plus, vous pouvez en savoir plus sur l’API GroupDocs.Merge Cloud à l’aide de la documentation. Nous fournissons également une section API Reference qui vous permet de visualiser et d’interagir avec nos API directement via le navigateur. De plus, groupdocs.cloud écrit de nouveaux articles de blog sur d’autres sujets intéressants. Par conséquent, veuillez rester en contact pour des mises à jour régulières.

poser une question

Si vous avez des questions concernant la rotation des pages pdf, n’hésitez pas à nous les poser sur Free Support Forum

Voir également