Come ruotare le pagine PDF usando Rest API in Ruby

Come capovolgere le pagine PDF usando Rest API in Ruby

Esploriamo gli scenari relativi alla rotazione nei documenti PDF. Puoi ruotare tutte le pagine o pagine PDF specifiche in modo programmatico utilizzando Ruby nelle tue applicazioni. Esamineremo i seguenti scenari di rotazione delle pagine PDF con l’aiuto di semplici esempi di funzionalità di rotazione PDF. In questo articolo impareremo come ruotare le pagine PDF utilizzando l’API REST in Ruby.

In questo articolo saranno trattati i seguenti argomenti:

API di rotazione delle pagine PDF e Ruby SDK

Puoi ruotare le pagine impostando angoli di rotazione come 90, 180 o 270 gradi utilizzando l’API GroupDocs.Merger. Per ruotare i file PDF, userò Ruby SDK di GroupDocs.Merger Cloud API. Ti consente di dividere, unire, rimuovere e riorganizzare una singola pagina o una raccolta di pagine dai formati di documenti supportati di Word, Excel, PDF, PowerPoint e HTML ecc. Puoi installare GroupDocs.Merger Cloud SDK nella tua applicazione Ruby usando il seguente comando nel terminale:

gem install groupdocs_conversion_cloud

Si prega di ottenere l’ID cliente e il segreto dalla dashboard prima di seguire i passaggi indicati di seguito. Una volta che hai il tuo ID e segreto, aggiungi quanto segue nel codice come mostrato di seguito:

# Carica la gemma https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby nell'applicazione Ruby per http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# Ottieni il tuo client_id e client_secret da https://dashboard.groupdocs.cloud dopo la registrazione gratuita.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Una volta che l’API è stata configurata correttamente, puoi usare l’enumerazione Rotation per selezionare un valore di rotazione adatto in senso orario.

Ruota tutte le pagine di un documento PDF usando Ruby

È possibile ruotare le pagine PDF in un documento PDF in modo programmatico sul cloud seguendo i passaggi indicati di seguito. Innanzitutto, carica il file PDF nel cloud e il file PDF caricato sarà disponibile nella sezione file della dashboard nel cloud. Potrebbero esserci molti casi d’uso in cui è necessario ruotare i file PDF. Puoi ruotare tutte le pagine di un file PDF seguendo i passaggi indicati di seguito:

  • Innanzitutto, crea un’istanza di PagesApi
  • Successivamente, crea un’istanza di RotateOptions
  • Quindi, crea un’istanza di FileInfo
  • Fornire il percorso del documento PDF di input e il percorso del file di output
  • Successivamente, imposta la rotazione della pagina desiderata come Rotate90
  • Successivamente, crea RotateRequest con RotateOptions come argomento
  • Infine, chiama il metodo rotate() e salva il documento PDF di output

Il seguente frammento di codice mostra come ruotare tutte le pagine di un file PDF utilizzando l’API REST in Ruby:

# Questo esempio di codice mostra come ruotare tutte le pagine in un documento PDF.
# Crea una nuova istanza di PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inizializza 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"
# Impostare la rotazione della pagina desiderata a 90, 180 o 270 gradi.
@options.mode = "Rotate90"

# Ruota le pagine nel file PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

Infine, l’esempio di codice precedente salverà il file PDF aggiornato nel cloud.

Ruota pagine specifiche del file PDF utilizzando Ruby

La rotazione in un documento PDF viene applicata a livello di pagina. Pertanto, puoi anche ruotare pagine specifiche del file PDF in base alle tue esigenze. Devi solo scegliere il numero di pagina su cui vuoi applicare la rotazione. I passaggi seguenti spiegano come ruotare determinate pagine del file PDF:

  • Innanzitutto, crea un’istanza di PagesApi
  • Successivamente, crea un’istanza di RotateOptions
  • Quindi, crea un’istanza di FileInfo
  • Fornire il percorso del documento PDF di input e il percorso del file di output
  • Assegna i numeri di pagina esatti utilizzando la raccolta di pagine
  • Imposta la rotazione della pagina desiderata come Rotate90, Rotate180 o Rotate270
  • Successivamente, crea RotateRequest con RotateOptions come argomento
  • Infine, chiama il metodo rotate() e salva il documento PDF di output

Il seguente frammento di codice elabora come ruotare pagine specifiche o determinate in un documento PDF utilizzando Ruby:

# Questo esempio di codice mostra come ruotare le pagine nei file PDF.
# Inizializza la nuova istanza di PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inizializza 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"
# Fornisci i numeri di pagina esatti a partire da 1 tramite la raccolta Pagine
@options.pages = [1, 7]
@options.mode = "Rotate180"

# Ruota le pagine nel file PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

Infine, l’esempio di codice precedente salverà il file PDF di output nel cloud.

Ruota le pagine PDF fornendo il numero di pagina utilizzando Ruby

Puoi anche ruotare le pagine PDF in base al numero di pagina. È necessario fornire il numero della pagina iniziale e il numero della pagina finale per applicare la rotazione. I passaggi seguenti spiegano come ruotare le pagine PDF in base ai numeri di pagina di un file PDF:

  • Innanzitutto, crea un’istanza di PagesApi
  • Successivamente, crea un’istanza di RotateOptions
  • Quindi, crea un’istanza di FileInfo
  • Fornire il percorso del documento PDF di input e il percorso del file di output
  • Impostare i valori del numero di pagina iniziale e del numero di pagina finale;
  • Imposta la rotazione della pagina desiderata come Rotate270
  • Successivamente, crea RotateRequest con RotateOptions come argomento
  • Infine, chiama il metodo rotate() e salva il documento PDF di output

Lo snippet di codice seguente mostra come ruotare le pagine nel documento PDF fornendo i numeri di pagina utilizzando l’API Ruby Rest:

# Questo esempio di codice mostra come ruotare i documenti PDF.
# Inizializza la nuova istanza di PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inizializza 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"
# Specifica i numeri di pagina iniziale e finale dell'intervallo di pagine
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# Ruota le pagine nel file PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

L’esempio di codice precedente salverà il documento PDF di output sul cloud.

Ruota le pagine PDF impostando la modalità intervallo utilizzando Ruby

È possibile ruotare l’immagine in un documento PDF durante l’aggiunta o l’inserimento dell’immagine nel file PDF. Può essere utile quando si desidera aggiornare o modificare l’orientamento dell’immagine. Puoi seguire questi passaggi per ruotare l’immagine su una pagina PDF:

  • Innanzitutto, crea un’istanza di PagesApi
  • Successivamente, crea un’istanza di RotateOptions
  • Quindi, crea un’istanza di FileInfo
  • Fornire il percorso del documento PDF di input e il percorso del file di output
  • Imposta la rotazione della pagina desiderata come Rotate180
  • Successivamente, imposta i valori del numero di pagina iniziale e del numero di pagina finale;
  • Ora, imposta la modalità intervallo su Pagine pari o Pagine dispari o Tutte le pagine
  • Successivamente, crea RotateRequest con RotateOptions come argomento
  • Infine, chiama il metodo rotate() e salva il documento PDF di output

Il codice seguente mostra come ruotare un’immagine o un’immagine in un documento PDF in modo programmatico utilizzando Ruby:

# Questo esempio di codice mostra come ruotare le pagine nel documento PDF.
# Inizializza la nuova istanza di PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inizializza 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"
# Ottieni solo pagine pari o dispari dall'intervallo di pagine specificato impostando la proprietà range_mode.
@options.start_page_number = 1
@options.end_page_number = 10
# Imposta la modalità intervallo su "Tutte le pagine" o "Pagine dispari" o "Pagine pari"
@options.range_mode = "EvenPages"

# Ruota le pagine nel documento PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

Infine, lo snippet di codice precedente salverà il documento PDF di output sul cloud.

Ruota pagine PDF online gratuitamente

Prova il seguente strumento online gratuito per ruotare le pagine del documento PDF, sviluppato utilizzando l’API di cui sopra.

Riassumendo

In questo articolo hai imparato:

  • come ruotare tutte le pagine in un documento PDF usando Ruby;
  • come ruotare determinati PDF usando Ruby;
  • come ruotare le pagine PDF per numero di pagina usando Ruby;
  • come ruotare le pagine PDF in modalità intervallo usando Ruby;

Inoltre, puoi saperne di più su GroupDocs.Merge Cloud API utilizzando la documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. Inoltre, groupdocs.cloud sta scrivendo nuovi post sul blog su altri argomenti interessanti. Pertanto, si prega di rimanere in contatto per aggiornamenti regolari.

Fai una domanda

Se hai domande sulla rotazione delle pagine pdf, non esitare a contattarci al Forum di supporto gratuito

Guarda anche