Jak otočit stránky PDF pomocí Rest API v Ruby

Jak převrátit stránky PDF pomocí Rest API v Ruby

Pojďme prozkoumat scénáře související s rotací v dokumentech PDF. Pomocí Ruby ve svých aplikacích můžete programově otáčet všechny stránky nebo konkrétní stránky PDF. Projdeme si následující scénáře rotace stránek PDF s pomocí jednoduchých příkladů funkcí rotace PDF. V tomto článku se naučíme, jak otáčet stránky PDF pomocí REST API v Ruby.

V tomto článku se budou zabývat následujícími tématy:

PDF Pages Rotation Rest API a Ruby SDK

Stránky můžete otáčet nastavením úhlů otočení jako 90, 180 nebo 270 stupňů pomocí GroupDocs.Merger API. Pro rotaci souborů PDF budu používat Ruby SDK of GroupDocs.Merger Cloud API. Umožňuje rozdělit, kombinovat, odstraňovat a přeskupovat jednu stránku nebo kolekci stránek z podporovaných formátů dokumentů Word, Excel, PDF, PowerPoint a HTML atd. GroupDocs.Merger Cloud SDK můžete nainstalovat do své aplikace Ruby pomocí následujícího příkazu v terminálu:

gem install groupdocs_conversion_cloud

Před provedením níže uvedených kroků prosím získejte své ID klienta a tajný klíč z řídicího panelu. Jakmile budete mít své ID a tajemství, přidejte do kódu následující:

# Načtěte drahokam https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby v aplikaci Ruby pro http://api.groupdocs.cloud
require 'groupdocs_merger_cloud'

# Získejte své client_id a client_secret z https://dashboard.groupdocs.cloud po bezplatné registraci.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Jakmile je API úspěšně nakonfigurováno, můžete pomocí výčtu Rotation vybrat vhodnou hodnotu rotace ve směru hodinových ručiček.

Otočte všechny stránky dokumentu PDF pomocí Ruby

Stránky PDF v dokumentu PDF můžete otáčet programově v cloudu podle níže uvedených kroků. Nejprve nahrajte soubor PDF do cloudu a nahraný soubor PDF bude dostupný v sekci souborů na řídicím panelu v cloudu. Může existovat mnoho případů použití, kdy potřebujete otočit soubory PDF. Všechny stránky souboru PDF můžete otočit podle následujících kroků:

  • Nejprve vytvořte instanci PagesApi
  • Dále vytvořte instanci RotateOptions
  • Poté vytvořte instanci souboru FileInfo
  • Zadejte cestu vstupního dokumentu PDF a cestu k výstupnímu souboru
  • Dále nastavte požadované otočení stránky jako Rotate90
  • Poté vytvořte RotateRequest s RotateOptions jako argument
  • Nakonec zavolejte metodu rotate() a uložte výstupní dokument PDF

Následující fragment kódu ukazuje, jak otočit všechny stránky souboru PDF pomocí REST API v Ruby:

# Tento příklad kódu ukazuje, jak otočit všechny stránky v dokumentu PDF.
# Vytvořte novou instanci PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializujte 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"
# Nastavte požadované otočení stránky na 90, 180 nebo 270 stupňů.
@options.mode = "Rotate90"

# Otočte stránky v souboru PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

Nakonec výše uvedený ukázkový kód uloží aktualizovaný soubor PDF do cloudu.

Otočte konkrétní stránky souboru PDF pomocí Ruby

Otočení v dokumentu PDF se použije na úrovni stránky. Proto můžete také otáčet konkrétní stránky souboru PDF podle svých požadavků. Stačí si vybrat číslo stránky, na kterou chcete otočení použít. Následující kroky vysvětlují, jak otočit určité stránky souboru PDF:

  • Nejprve vytvořte instanci PagesApi
  • Dále vytvořte instanci RotateOptions
  • Poté vytvořte instanci souboru FileInfo
  • Zadejte cestu vstupního dokumentu PDF a cestu k výstupnímu souboru
  • Přiřaďte přesná čísla stránek pomocí kolekce stránek
  • Nastavte požadované otočení stránky jako Rotate90, Rotate180 nebo Rotate270
  • Poté vytvořte RotateRequest s RotateOptions jako argument
  • Nakonec zavolejte metodu rotate() a uložte výstupní dokument PDF

Následující fragment kódu vysvětluje, jak otočit konkrétní nebo určité stránky v dokumentu PDF pomocí Ruby:

# Tento příklad kódu ukazuje, jak otáčet stránky v souborech PDF.
# Inicializujte novou instanci PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializujte 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"
# Uveďte přesná čísla stránek počínaje 1 prostřednictvím kolekce stránek
@options.pages = [1, 7]
@options.mode = "Rotate180"

# Otočte stránky v souboru PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

Nakonec výše uvedená ukázka kódu uloží výstupní soubor PDF do cloudu.

Otočte stránky PDF zadáním čísla stránky pomocí Ruby

Stránky PDF můžete také otáčet podle čísla stránky. Chcete-li použít otočení, musíte zadat číslo počáteční a koncové stránky. Následující kroky vysvětlují, jak otočit stránky PDF podle čísel stránek souboru PDF:

  • Nejprve vytvořte instanci PagesApi
  • Dále vytvořte instanci RotateOptions
  • Poté vytvořte instanci souboru FileInfo
  • Zadejte cestu vstupního dokumentu PDF a cestu k výstupnímu souboru
  • Nastavte hodnoty počáteční a koncové stránky;
  • Nastavte požadované otočení stránky jako Rotate270
  • Poté vytvořte RotateRequest s RotateOptions jako argument
  • Nakonec zavolejte metodu rotate() a uložte výstupní dokument PDF

Fragment kódu níže ukazuje, jak otočit stránky v dokumentu PDF poskytnutím čísel stránek pomocí rozhraní Ruby Rest API:

# Tento příklad kódu ukazuje, jak otočit dokumenty PDF.
# Inicializujte novou instanci PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializujte 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"
# Zadejte čísla začátku a konce rozsahu stránek
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# Otočte stránky v souboru PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

Výše uvedený příklad kódu uloží výstupní dokument PDF do cloudu.

Otočte stránky PDF nastavením režimu rozsahu pomocí Ruby

Při přidávání nebo vkládání obrázku do souboru PDF můžete obrázek v dokumentu PDF otočit. Může být užitečné, když chcete aktualizovat nebo změnit orientaci obrázku. Chcete-li otočit obrázek na stránce PDF, postupujte takto:

  • Nejprve vytvořte instanci PagesApi
  • Dále vytvořte instanci RotateOptions
  • Poté vytvořte instanci souboru FileInfo
  • Zadejte cestu vstupního dokumentu PDF a cestu k výstupnímu souboru
  • Nastavte požadované otočení stránky jako Rotate180
  • Dále nastavte číslo počáteční a koncové stránky;
  • Nyní nastavte režim rozsahu na EvenPages nebo OddPages nebo AllPages
  • Poté vytvořte RotateRequest s RotateOptions jako argument
  • Nakonec zavolejte metodu rotate() a uložte výstupní dokument PDF

Následující kód ukazuje, jak otočit obrázek nebo obrázek v dokumentu PDF programově pomocí Ruby:

# Tento příklad kódu ukazuje, jak otáčet stránky v dokumentu PDF.
# Inicializujte novou instanci PagesApi
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# Inicializujte 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"
# Získejte pouze sudé nebo liché stránky ze zadaného rozsahu stránek nastavením vlastnosti range_mode.
@options.start_page_number = 1
@options.end_page_number = 10
# Nastavte režim rozsahu na „AllPages“ nebo „OddPages“ nebo „EvenPages“
@options.range_mode = "EvenPages"

# Otočte stránky v dokumentu PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

Nakonec výše uvedený fragment kódu uloží výstupní dokument PDF do cloudu.

Online otáčení stránek PDF zdarma

Vyzkoušejte prosím následující bezplatný online nástroj k otočení stránek dokumentu PDF, který je vyvinut pomocí výše uvedeného API.

Shrnutí

V tomto článku jste se dozvěděli:

  • jak otočit všechny stránky v dokumentu PDF pomocí Ruby;
  • jak otočit určité PDF pomocí Ruby;
  • jak otočit stránky PDF podle čísla stránky pomocí Ruby;
  • jak otočit stránky PDF podle režimu rozsahu pomocí Ruby;

Kromě toho se můžete dozvědět více o GroupDocs.Merge Cloud API pomocí dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat naše API a pracovat s nimi přímo prostřednictvím prohlížeče. Kromě toho groupdocs.cloud píše nové blogové příspěvky na další zajímavá témata. Zůstaňte proto v kontaktu pro pravidelné aktualizace.

Položit otázku

Máte-li jakékoli dotazy týkající se rotace stránek pdf, neváhejte se nás zeptat na Free Support Forum

Viz také