Jak obracać strony PDF za pomocą Rest API w Ruby

Jak odwracać strony PDF za pomocą Rest API w Ruby

Przyjrzyjmy się scenariuszom związanym z rotacją w dokumentach PDF. Możesz programowo obracać wszystkie strony lub określone strony PDF, używając Ruby w swoich aplikacjach. Omówimy następujące scenariusze rotacji stron PDF za pomocą prostych przykładów funkcji rotacji PDF. W tym artykule dowiemy się, jak obracać strony PDF za pomocą REST API w Ruby.

W tym artykule zostaną omówione następujące tematy:

PDF Pages Rotation Rest API i Ruby SDK

Możesz obracać strony, ustawiając kąty obrotu, takie jak 90, 180 lub 270 stopni, za pomocą GroupDocs.Merger API. Do obracania plików PDF będę używać Ruby SDK of GroupDocs.Merger Cloud API. Pozwala dzielić, łączyć, usuwać i zmieniać kolejność pojedynczej strony lub zbioru stron z obsługiwanych formatów dokumentów Word, Excel, PDF, PowerPoint ] i HTML itp. Możesz zainstalować GroupDocs.Merger Cloud SDK w swojej aplikacji Ruby, używając następującego polecenia w terminalu:

gem install groupdocs_conversion_cloud

Proszę uzyskaj swój identyfikator klienta i klucz tajny z pulpitu nawigacyjnego przed wykonaniem poniższych kroków. Gdy masz już swój identyfikator i sekret, dodaj następujący kod w kodzie, jak pokazano poniżej:

# Załaduj klejnot https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby w aplikacji Ruby dla http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# Uzyskaj identyfikator klienta i klucz klienta z https://dashboard.groupdocs.cloud po bezpłatnej rejestracji.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Po pomyślnym skonfigurowaniu interfejsu API można użyć wyliczenia Rotation, aby wybrać odpowiednią wartość obrotu w kierunku zgodnym z ruchem wskazówek zegara.

Obróć wszystkie strony dokumentu PDF za pomocą języka Ruby

Możesz programowo obracać strony PDF w dokumencie PDF w chmurze, wykonując czynności podane poniżej. Najpierw prześlij plik PDF do chmury, a przesłany plik PDF będzie dostępny w sekcji plików pulpitu nawigacyjnego w chmurze. Może istnieć wiele przypadków użycia, w których trzeba obrócić pliki PDF. Możesz obrócić wszystkie strony pliku PDF, wykonując poniższe czynności:

  • Najpierw utwórz instancję PagesApi
  • Następnie utwórz instancję RotateOptions
  • Następnie utwórz instancję klasy FileInfo
  • Podaj ścieżkę wejściowego dokumentu PDF i ścieżkę pliku wyjściowego
  • Następnie ustaw żądany obrót strony, na przykład Rotate90
  • Następnie utwórz RotateRequest z RotateOptions jako argumentem
  • Na koniec wywołaj metodę rotate() i zapisz wynikowy dokument PDF

Poniższy fragment kodu pokazuje, jak obrócić wszystkie strony pliku PDF za pomocą REST API w Ruby:

# Ten przykład kodu pokazuje, jak obrócić wszystkie strony w dokumencie PDF.
# Utwórz nową instancję PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Zainicjuj 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"
# Ustaw żądany obrót strony na 90, 180 lub 270 stopni.
@options.mode = "Rotate90"

# Obracaj strony w pliku PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

Na koniec powyższy przykładowy kod zapisze zaktualizowany plik PDF w chmurze.

Obracaj określone strony pliku PDF za pomocą języka Ruby

Obrót w dokumencie PDF jest stosowany na poziomie strony. Dlatego możesz także obracać określone strony pliku PDF zgodnie z własnymi wymaganiami. Musisz tylko wybrać numer strony, na której chcesz zastosować obrót. Poniższe kroki wyjaśniają, jak obracać niektóre strony pliku PDF:

  • Najpierw utwórz instancję PagesApi
  • Następnie utwórz instancję RotateOptions
  • Następnie utwórz instancję klasy FileInfo
  • Podaj ścieżkę wejściowego dokumentu PDF i ścieżkę pliku wyjściowego
  • Przypisz dokładne numery stron za pomocą kolekcji stron
  • Ustaw żądany obrót strony, na przykład Rotate90, Rotate180 lub Rotate270
  • Następnie utwórz RotateRequest z RotateOptions jako argumentem
  • Na koniec wywołaj metodę rotate() i zapisz wynikowy dokument PDF

Poniższy fragment kodu wyjaśnia, jak obracać określone lub określone strony w dokumencie PDF za pomocą języka Ruby:

# Ten przykład kodu pokazuje, jak obracać strony w plikach PDF.
# Zainicjuj nowe wystąpienie PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Zainicjuj 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"
# Podaj dokładne numery stron, zaczynając od 1, za pośrednictwem kolekcji Pages
@options.pages = [1, 7]
@options.mode = "Rotate180"

# Obracaj strony w pliku PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

Na koniec powyższy przykładowy kod zapisze wyjściowy plik PDF w chmurze.

Obracaj strony PDF, podając numer strony za pomocą Ruby

Możesz także obracać strony PDF według numeru strony. Musisz podać numer strony początkowej i numer strony końcowej, aby zastosować rotację. Poniższe kroki wyjaśniają, jak obracać strony PDF według numerów stron pliku PDF:

  • Najpierw utwórz instancję PagesApi
  • Następnie utwórz instancję RotateOptions
  • Następnie utwórz instancję klasy FileInfo
  • Podaj ścieżkę wejściowego dokumentu PDF i ścieżkę pliku wyjściowego
  • Ustaw numer strony początkowej i numer strony końcowej;
  • Ustaw żądany obrót strony, np. Rotate270
  • Następnie utwórz RotateRequest z RotateOptions jako argumentem
  • Na koniec wywołaj metodę rotate() i zapisz wynikowy dokument PDF

Poniższy fragment kodu pokazuje, jak obracać strony w dokumencie PDF, podając numery stron za pomocą Ruby Rest API:

# Ten przykład kodu pokazuje, jak obracać dokumenty PDF.
# Zainicjuj nowe wystąpienie PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Zainicjuj 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"
# Określ początkowe i końcowe numery stron zakresu stron
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# Obracaj strony w pliku PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

Powyższy przykład kodu zapisze wyjściowy dokument PDF w chmurze.

Obracaj strony PDF, ustawiając tryb zakresu za pomocą języka Ruby

Możesz obracać obraz w dokumencie PDF podczas dodawania lub wstawiania obrazu do pliku PDF. Może to być pomocne, gdy chcesz zaktualizować lub zmienić orientację obrazu. Możesz wykonać następujące kroki, aby obrócić obraz na stronie PDF:

  • Najpierw utwórz instancję PagesApi
  • Następnie utwórz instancję RotateOptions
  • Następnie utwórz instancję klasy FileInfo
  • Podaj ścieżkę wejściowego dokumentu PDF i ścieżkę pliku wyjściowego
  • Ustaw żądany obrót strony, np. Rotate180
  • Następnie ustaw numer strony początkowej i numer strony końcowej;
  • Teraz ustaw tryb zakresu na EvenPages, OddPages lub AllPages
  • Następnie utwórz RotateRequest z RotateOptions jako argumentem
  • Na koniec wywołaj metodę rotate() i zapisz wynikowy dokument PDF

Poniższy kod ilustruje programowe obracanie obrazu lub obrazu w dokumencie PDF za pomocą języka Ruby:

# Ten przykład kodu pokazuje, jak obracać strony w dokumencie PDF.
# Zainicjuj nowe wystąpienie PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Zainicjuj 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"
# Pobierz tylko parzyste lub nieparzyste strony z określonego zakresu stron, ustawiając właściwość range_mode.
@options.start_page_number = 1
@options.end_page_number = 10
# Ustaw tryb zakresu na „Wszystkie strony” lub „OddPages” lub „EvenPages”
@options.range_mode = "EvenPages"

# Obracaj strony w dokumencie PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

Na koniec powyższy fragment kodu zapisze wyjściowy dokument PDF w chmurze.

Internetowe obracanie stron PDF za darmo

Wypróbuj następujące bezpłatne narzędzie online do obracania stron dokumentów PDF, które zostało opracowane przy użyciu powyższego interfejsu API.

Podsumowując

Z tego artykułu dowiedziałeś się:

  • jak obrócić wszystkie strony w dokumencie PDF za pomocą Ruby;
  • jak obrócić określony plik PDF za pomocą Ruby;
  • jak obracać strony PDF według numeru strony za pomocą Ruby;
  • jak obracać strony PDF według trybu zakresu za pomocą Ruby;

Dodatkowo możesz dowiedzieć się więcej o GroupDocs.Merge Cloud API korzystając z dokumentacji. Udostępniamy również sekcję Informacje o interfejsach API, która umożliwia wizualizację naszych interfejsów API i interakcję z nimi bezpośrednio w przeglądarce. Ponadto groupdocs.cloud pisze nowe posty na blogu na inne interesujące tematy. Dlatego prosimy o regularne aktualizacje.

Zadać pytanie

Jeśli masz jakiekolwiek pytania dotyczące rotacji stron pdf, możesz je zadać na Bezpłatne forum wsparcia

Zobacz też