نحوه چرخش صفحات PDF با استفاده از Rest API در Ruby

نحوه ورق زدن صفحات PDF با استفاده از Rest API در Ruby

اجازه دهید سناریوهای مربوط به چرخش را در اسناد PDF بررسی کنیم. می توانید با استفاده از Ruby در برنامه های خود، تمام صفحات یا صفحات PDF خاص را به صورت برنامه نویسی بچرخانید. ما سناریوهای چرخش صفحات PDF زیر را با کمک مثال‌های ساده از ویژگی‌های چرخش PDF مرور خواهیم کرد. در این مقاله نحوه چرخش صفحات PDF با استفاده از REST API در Ruby را خواهیم آموخت.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

PDF Pages Rotation Rest API و Ruby SDK

با استفاده از GroupDocs.Merger API می توانید صفحات را با تنظیم زوایای چرخش مانند 90، 180 یا 270 درجه بچرخانید. برای چرخاندن فایل‌های PDF، از Ruby SDK of GroupDocs.Merger Cloud API استفاده خواهم کرد. این به شما امکان می دهد یک صفحه یا مجموعه ای از صفحات را از قالب های سند پشتیبانی شده از Word، Excel، PDF، PowerPoint تقسیم، ترکیب، حذف و تنظیم مجدد کنید. ] و HTML و غیره می‌توانید GroupDocs.Merger Cloud SDK را با استفاده از دستور زیر در ترمینال در برنامه Ruby خود نصب کنید:

gem install groupdocs_conversion_cloud

لطفاً [شناسه مشتری و راز9 خود را از داشبورد قبل از انجام مراحل ذکر شده در زیر دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، موارد زیر را مانند شکل زیر به کد اضافه کنید:

# جواهر https://github.com/groupdocs-merger-cloud/groupdocs-merger-cloud-ruby را در برنامه Ruby برای http://api.groupdocs.cloud بارگیری کنید
require 'groupdocs_merger_cloud'

# پس از ثبت نام رایگان، client_id و client_secret خود را از https://dashboard.groupdocs.cloud دریافت کنید.
@app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

هنگامی که API با موفقیت پیکربندی شد، می توانید از شمارش Rotation برای انتخاب مقدار مناسب چرخش در جهت عقربه های ساعت استفاده کنید.

تمام صفحات یک سند PDF را با استفاده از Ruby بچرخانید

با دنبال کردن مراحل زیر می‌توانید صفحات PDF را در یک سند PDF به صورت برنامه‌نویسی در فضای ابری بچرخانید. ابتدا، آپلود فایل PDF در ابر و فایل پی‌دی‌اف آپلود شده در بخش فایل‌ها داشبورد در فضای ابری در دسترس خواهد بود. ممکن است موارد استفاده زیادی وجود داشته باشد که شما نیاز به چرخاندن فایل های PDF داشته باشید. با دنبال کردن مراحل زیر می توانید تمام صفحات یک فایل PDF را بچرخانید:

  • ابتدا یک نمونه از PagesApi ایجاد کنید.
  • بعد، یک نمونه از RotateOptions ایجاد کنید
  • سپس، یک نمونه از FileInfo ایجاد کنید
  • مسیر سند PDF ورودی و مسیر فایل خروجی را ارائه دهید
  • سپس چرخش صفحه مورد نظر را مانند Rotate90 تنظیم کنید
  • پس از آن، RotateRequest را با RotateOptions به عنوان آرگومان ایجاد کنید
  • در نهایت، متد rotate() را فراخوانی کرده و سند PDF خروجی را ذخیره کنید

قطعه کد زیر نحوه چرخش تمام صفحات یک فایل PDF را با استفاده از REST API در Ruby نشان می دهد:

# این مثال کد نحوه چرخش تمام صفحات در یک سند PDF را نشان می دهد.
# یک نمونه جدید از PagesApi ایجاد کنید
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 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"
# چرخش صفحه مورد نظر را روی 90، 180 یا 270 درجه تنظیم کنید.
@options.mode = "Rotate90"

# چرخاندن صفحات در فایل PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated all pages in PDF file using Rest API.")

در نهایت، نمونه کد بالا فایل PDF به روز شده را در فضای ابری ذخیره می کند.

صفحات خاصی از فایل PDF را با استفاده از Ruby بچرخانید

چرخش در یک سند PDF در سطح صفحه اعمال می شود. بنابراین، شما همچنین می توانید صفحات خاصی از فایل PDF را بر اساس نیاز خود بچرخانید. فقط باید شماره صفحه ای را که می خواهید چرخش روی آن اعمال شود، انتخاب کنید. مراحل زیر نحوه چرخاندن صفحات خاصی از فایل PDF را توضیح می دهد:

  • ابتدا یک نمونه از PagesApi ایجاد کنید.
  • بعد، یک نمونه از RotateOptions ایجاد کنید
  • سپس، یک نمونه از FileInfo ایجاد کنید
  • مسیر سند PDF ورودی و مسیر فایل خروجی را ارائه دهید
  • با استفاده از مجموعه صفحات، شماره صفحات دقیق را اختصاص دهید
  • چرخش صفحه مورد نظر را مانند Rotate90، Rotate180 یا Rotate270 تنظیم کنید.
  • پس از آن، RotateRequest را با RotateOptions به عنوان آرگومان ایجاد کنید
  • در نهایت، متد rotate() را فراخوانی کرده و سند PDF خروجی را ذخیره کنید

قطعه کد زیر نحوه چرخش صفحات خاص یا خاص در یک سند PDF را با استفاده از Ruby شرح می دهد:

# این مثال کد نحوه چرخش صفحات در فایل های PDF را نشان می دهد.
# نمونه جدیدی از PagesApi را راه اندازی کنید
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 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"
# از طریق مجموعه صفحات، اعداد دقیق صفحه را با شروع از 1 ارائه دهید
@options.pages = [1, 7]
@options.mode = "Rotate180"

# چرخاندن صفحات در فایل PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated PDF specific pages using Rest API.")

در نهایت، نمونه کد بالا فایل PDF خروجی را در فضای ابری ذخیره می کند.

با ارائه شماره صفحه با استفاده از Ruby، صفحات PDF را بچرخانید

همچنین می توانید صفحات PDF را بر اساس شماره صفحه بچرخانید. برای اعمال چرخش باید شماره صفحه شروع و شماره صفحه پایان را ارائه دهید. مراحل زیر نحوه چرخاندن صفحات PDF بر اساس شماره صفحات یک فایل PDF را توضیح می دهد:

  • ابتدا یک نمونه از PagesApi ایجاد کنید.
  • بعد، یک نمونه از RotateOptions ایجاد کنید
  • سپس، یک نمونه از FileInfo ایجاد کنید
  • مسیر سند PDF ورودی و مسیر فایل خروجی را ارائه دهید
  • مقادیر شماره صفحه شروع و شماره صفحه پایان را تنظیم کنید.
  • چرخش صفحه مورد نظر را مانند Rotate270 تنظیم کنید
  • پس از آن، RotateRequest را با RotateOptions به عنوان آرگومان ایجاد کنید
  • در نهایت، متد rotate() را فراخوانی کرده و سند PDF خروجی را ذخیره کنید

قطعه کد زیر نحوه چرخش صفحات در سند PDF را با ارائه شماره صفحات با استفاده از Ruby Rest API نشان می دهد:

# این مثال کد نحوه چرخش اسناد PDF را نشان می دهد.
# نمونه جدیدی از PagesApi را راه اندازی کنید
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 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"
# شماره صفحه شروع و پایان محدوده صفحات را مشخص کنید
@options.start_page_number = 1
@options.end_page_number = 5
@options.mode = "Rotate270"

# چرخاندن صفحات در فایل PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated 270 degree PDF document using Rest API.")

مثال کد بالا، سند PDF خروجی را در فضای ابری ذخیره می کند.

صفحات PDF را با تنظیم حالت محدوده با استفاده از Ruby بچرخانید

هنگام افزودن یا درج تصویر در فایل PDF می توانید تصویر را در یک سند PDF بچرخانید. زمانی که می خواهید جهت تصویر را به روز کنید یا تغییر دهید، می تواند مفید باشد. برای چرخاندن تصویر در صفحه PDF می توانید این مراحل را دنبال کنید:

  • ابتدا یک نمونه از PagesApi ایجاد کنید.
  • بعد، یک نمونه از RotateOptions ایجاد کنید
  • سپس، یک نمونه از FileInfo ایجاد کنید
  • مسیر سند PDF ورودی و مسیر فایل خروجی را ارائه دهید
  • چرخش صفحه مورد نظر را مانند Rotate180 تنظیم کنید
  • سپس، مقادیر شماره صفحه شروع و شماره صفحه پایان را تنظیم کنید.
  • اکنون، حالت محدوده را روی EvenPages یا OddPages یا AllPages تنظیم کنید
  • پس از آن، RotateRequest را با RotateOptions به عنوان آرگومان ایجاد کنید
  • در نهایت، متد rotate() را فراخوانی کرده و سند PDF خروجی را ذخیره کنید

کد زیر نحوه چرخش تصویر یا تصویر در یک سند PDF را با استفاده از Ruby به صورت برنامه‌نویسی نشان می‌دهد:

# این مثال کد نحوه چرخش صفحات در سند PDF را نشان می دهد.
# نمونه جدیدی از PagesApi را راه اندازی کنید
@pages_api = GroupDocsMergerCloud::PagesApi.from_keys(@app_sid, @app_key)

# 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"
# با تنظیم ویژگی range_mode فقط صفحات زوج یا فرد را از محدوده صفحه مشخص شده دریافت کنید.
@options.start_page_number = 1
@options.end_page_number = 10
# حالت محدوده را بر روی "AllPages" یا "OddPages" یا "EvenPages" تنظیم کنید
@options.range_mode = "EvenPages"

# چرخاندن صفحات در سند PDF
@result = @pages_api.rotate(GroupDocsMergerCloud::RotateRequest.new(@options))
puts("Successfully rotated Even PDF pages using Rest API.")

در نهایت، قطعه کد بالا، سند PDF خروجی را در فضای ابری ذخیره می کند.

چرخش آنلاین صفحات PDF به صورت رایگان

لطفاً [ابزار آنلاین رایگان] زیر را برای چرخاندن صفحات سند PDF، که با استفاده از API بالا ایجاد شده است، امتحان کنید.

جمع بندی

در این مقاله یاد گرفتید:

  • نحوه چرخش تمام صفحات در یک سند PDF با استفاده از Ruby.
  • نحوه چرخش PDF خاص با استفاده از روبی.
  • نحوه چرخش صفحات PDF بر اساس شماره صفحه با استفاده از Ruby.
  • نحوه چرخش صفحات PDF بر اساس حالت محدوده با استفاده از Ruby.

علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Merge Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می کنیم که به شما امکان می دهد API های ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. علاوه بر این، groupdocs.cloud در حال نوشتن پست های وبلاگ جدید در مورد موضوعات جالب دیگر است. بنابراین، لطفا برای به روز رسانی های منظم در تماس باشید.

سوال بپرس

اگر در مورد چرخش صفحات pdf سؤالی دارید، لطفاً از ما در تالار گفتمان پشتیبانی رایگان بپرسید.

همچنین ببینید