PDF یکی از فرمت‌های محبوب برای اشتراک‌گذاری و چاپ اسناد است. ما اغلب نیاز به تبدیل اسناد با فرمت ها و تصاویر مختلف به PDF داریم. توسعه چنین ابزارهایی به زمان و تلاش زیادی نیاز دارد. بنابراین، بهتر است از ابزارهای تخصصی از قبل توسعه یافته استفاده کنید که راه حلی به راحتی قابل نگهداری و انعطاف پذیر برای نیازهای شما ارائه می دهند. برای این منظور، تبدیل تصویر به پی‌دی‌اف REST API و Python SDK امکان تبدیل اسناد فرمت‌های پشتیبانی‌شده به PDF را به‌صورت برنامه‌نویسی در فضای ابری می‌دهند. در این مقاله با نحوه تبدیل تصاویر به PDF با استفاده از REST API در پایتون آشنا خواهیم شد.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- تبدیل تصویر به PDF REST API و Python SDK
- با استفاده از REST API در پایتون JPG را به PDF تبدیل کنید
- تبدیل JPG به PDF با گزینه های پیشرفته
- تبدیل JPG به PDF با واترمارک در پایتون
- تبدیل JPG به PDF و دانلود مستقیم فایل
- تبدیل JPG به PDF بدون استفاده از فضای ذخیره سازی ابری
تبدیل تصویر به PDF REST API و Python SDK
برای تبدیل تصاویر JPG یا PNG به PDF، از Python SDK of GroupDocs.Conversion Cloud API استفاده خواهیم کرد. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:
pip install groupdocs_converison_cloud
لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 6 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
# این مثال کد نحوه تنظیم شناسه مشتری و مخفی را نشان می دهد.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
با استفاده از REST API در پایتون JPG را به PDF تبدیل کنید
با دنبال کردن مراحل ساده زیر می توانیم تصاویر را به اسناد PDF تبدیل کنیم:
- آپلود فایل تصویری JPG در Cloud
- تبدیل JPG به PDF با استفاده از Python
- دانلود فایل PDF تبدیل شده
تصویر را آپلود کنید
ابتدا فایل تصویری JPG را با استفاده از نمونه کد زیر در فضای ابری آپلود می کنیم:
# این مثال کد نحوه آپلود فایل تصویری JPG را در Cloud نشان می دهد.
# نمونه ای از API ایجاد کنید
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# درخواست آپلود فایل
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)
# فایل نمونه را آپلود کنید
response = file_api.upload_file(request)
در نتیجه، فایل آپلود شده در بخش فایل ها داشبورد در فضای ابری در دسترس خواهد بود.
تبدیل JPG به PDF با استفاده از پایتون
با دنبال کردن مراحل زیر می‌توانیم تصاویر JPG را به اسناد PDF به صورت برنامه‌نویسی تبدیل کنیم:
- ابتدا یک نمونه از ConvertApi ایجاد کنید.
- بعد، یک نمونه از ConvertSettings ایجاد کنید.
- سپس مسیر فایل JPG را تنظیم کنید.
- و “pdf” را به فرمت اختصاص دهید.
- همچنین مسیر فایل خروجی را نیز ارائه دهید.
- پس از آن، ConvertDocumentRequest را با ConvertSettings به عنوان آرگومان ایجاد کنید.
- در نهایت، متد ConvertApi.convert\document() را با ConvertDocumentRequest فراخوانی کنید تا فایل تبدیل شده ذخیره شود.
نمونه کد زیر نحوه تبدیل یک تصویر JPG به سند PDF را با استفاده از REST API در پایتون نشان می دهد.
# این مثال کد نحوه تبدیل JPT به PDF را نشان می دهد.
# نمونه های API لازم را ایجاد کنید
تبدیل_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را آماده کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "تبدیلed"
# درخواست تبدیل
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل
result = تبدیل_api.تبدیل_document(request)
# انجام شده
print("Document تبدیلed: " + result[0].path)
با استفاده از REST API در پایتون JPG را به PDF تبدیل کنید.
PDF تبدیل شده را دانلود کنید
نمونه کد بالا سند PDF تبدیل شده را در ابر ذخیره می کند. می توان آن را با استفاده از مثال کد زیر دانلود کرد:
# این مثال کد نحوه دانلود فایل PDF را از Cloud نشان می دهد.
# مقداردهی اولیه API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)
# درخواست دانلود فایل
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)
# دریافت فایل
response = file_api.download_file(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\Conversion\\")
تبدیل JPG به PDF با گزینه های پیشرفته
با انجام مراحل زیر می‌توانیم JPG را با تنظیمات پیشرفته به صورت برنامه‌نویسی به سند PDF تبدیل کنیم:
- ابتدا یک نمونه از ConvertApi ایجاد کنید.
- بعد، یک نمونه از ConvertSettings ایجاد کنید.
- سپس مسیر فایل JPG را تنظیم کنید.
- و “pdf” را به فرمت اختصاص دهید.
- همچنین مسیر فایل خروجی را نیز ارائه دهید.
- بعد، یک نمونه از PdfConvertOptions ایجاد کنید و به ConvertSettings اختصاص دهید.
- سپس، تنظیمات تبدیل مختلف مانند dpi، مقیاس خاکستری، کیفیت تصویر، ارتفاع، حاشیه (بالا، چپ، راست، پایین) و غیره را تنظیم کنید.
- پس از آن، ConvertDocumentRequest را با ConvertSettings به عنوان آرگومان ایجاد کنید.
- در نهایت، متد ConvertApi.convert\document() را با ConvertDocumentRequest فراخوانی کنید تا فایل تبدیل شده ذخیره شود.
مثال کد زیر نحوه تبدیل یک تصویر JPG به یک سند PDF را با گزینه های تبدیل پیشرفته نشان می دهد. لطفاً مراحل ذکر شده قبلی را برای آپلود یک فایل تصویری JPG و دانلود فایل PDF تبدیل شده دنبال کنید.
# این مثال کد نحوه تبدیل JPT به PDF را با گزینه های پیشرفته نشان می دهد.
# نمونه های API لازم را ایجاد کنید
تبدیل_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را آماده کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "تبدیلed_with_options.pdf"
# گزینه های تبدیل PDF
تبدیلOptions = groupdocs_conversion_cloud.PdfConvertOptions()
تبدیلOptions.center_window = True
تبدیلOptions.display_doc_title = True
تبدیلOptions.dpi = 1024.0
تبدیلOptions.fit_window = False
تبدیلOptions.grayscale = True
تبدیلOptions.image_quality = 100
تبدیلOptions.linearize = True
تبدیلOptions.margin_top = 500
تبدیلOptions.margin_left = 500
تبدیلOptions.margin_right = 500
تبدیلOptions.margin_bottom = 500
settings.تبدیل_options = تبدیلOptions
# درخواست تبدیل
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
# تبدیل
result = تبدیل_api.تبدیل_document(request)
# انجام شده
print("Document تبدیلed: " + result[0].path)
تبدیل JPG به PDF با گزینه های پیشرفته.
تبدیل JPG به PDF با واترمارک در پایتون
می‌توانیم JPG را به سند PDF تبدیل کنیم و سپس با دنبال کردن مراحل زیر، واترمارک را به صورت برنامه‌نویسی به PDF تبدیل‌شده اضافه کنیم:
- ابتدا یک نمونه از ConvertApi ایجاد کنید.
- بعد، یک نمونه از ConvertSettings ایجاد کنید.
- سپس، مسیر فایل JPG را تنظیم کنید، “pdf” را به فرمت اختصاص دهید و مسیر فایل خروجی را ارائه دهید.
- بعد، یک نمونه از WatermarkOptions ایجاد کنید.
- سپس متن واترمارک، رنگ، فونت/اندازه، چرخش/زاویه و غیره را تنظیم کنید.
- بعد، یک نمونه از PdfConvertOptions ایجاد کنید و به WatermarkOptions اختصاص دهید.
- سپس، به صورت اختیاری تنظیمات مختلف تبدیل را تنظیم کنید.
- و PdfConvertOptions را به ConvertSettings اختصاص دهید.
- پس از آن، ConvertDocumentRequest را با ConvertSettings به عنوان آرگومان ایجاد کنید.
- در نهایت، متد ConvertApi.convert\document() را با ConvertDocumentRequest فراخوانی کنید تا فایل تبدیل شده ذخیره شود.
مثال کد زیر نحوه تبدیل JPG به سند PDF و اضافه کردن واترمارک به سند PDF تبدیل شده با استفاده از REST API در پایتون را نشان می دهد.
# این مثال کد نحوه تبدیل JPT به PDF و اضافه کردن واترمارک به PDF تبدیل شده را نشان می دهد.
# مقداردهی اولیه Api
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را تعریف کنید
settings = groupdocs_conversion_cloud.تبدیلSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"
# گزینه های واترمارک را تعریف کنید
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Black";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;
# تعریف گزینه های تبدیل PDF
convertOptions = groupdocs_conversion_cloud.PdfتبدیلOptions()
convertOptions.watermark_options = watermark
settings.convert_options = convertOptions
# ایجاد درخواست تبدیل سند
request = groupdocs_conversion_cloud.تبدیلDocumentRequest(settings)
# تبدیل
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
تبدیل JPG به PDF با واترمارک در پایتون.
تبدیل JPG به PDF و دانلود مستقیم فایل
می‌توانیم JPG را به صورت برنامه‌نویسی به PDF تبدیل کرده و فایل PDF تبدیل شده را مستقیماً با انجام مراحل زیر دانلود کنیم:
- ابتدا یک نمونه از ConvertApi ایجاد کنید.
- بعد، یک نمونه از ConvertSettings ایجاد کنید.
- سپس مسیر فایل JPG را تنظیم کنید.
- و “pdf” را به فرمت اختصاص دهید.
- همچنین مسیر فایل خروجی را به صورت None ارائه دهید.
- پس از آن، ConvertDocumentRequest را با ConvertSettings به عنوان آرگومان ایجاد کنید.
- در نهایت، متد ConvertApi.convert\document\download() را با ConvertDocumentRequest فراخوانی کنید تا فایل تبدیل شده روی دیسک محلی ذخیره شود.
نمونه کد زیر نحوه تبدیل یک فایل تصویری JPG به سند PDF و دانلود مستقیم آن را با استفاده از REST API در پایتون نشان می دهد. API باید فایل PDF تبدیل شده را در پاسخ بازگرداند. لطفاً برای آپلود فایل مراحل ذکر شده قبلی را دنبال کنید.
# این مثال کد نحوه پوشاندن و دانلود را نشان می دهد.
# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)
# تنظیمات تبدیل را آماده کنید
settings = groupdocs_conversion_cloud.تبدیلSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = None # leave OutputPath will result the output as document IOStream
# درخواست را آماده کنید
request = groupdocs_conversion_cloud.تبدیلDocumentRequest(settings)
# تبدیل
response = convert_api.convert_document_download(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\Conversion\\")
تبدیل JPG به PDF بدون استفاده از فضای ذخیره سازی ابری
با دنبال کردن مراحل زیر می‌توانیم JPG را بدون استفاده از فضای ذخیره‌سازی ابری به PDF تبدیل کنیم:
- ابتدا یک نمونه از ConvertApi ایجاد کنید
- سپس، ConvertDocumentDirectRequest را با فرمت هدف و مسیر فایل تصویر ورودی به عنوان آرگومان ایجاد کنید.
- سپس، متد convert\document\direct() را با ConvertDocumentDirectRequest به عنوان آرگومان فراخوانی کنید.
- در نهایت با استفاده از روش FileStream.writeFile() فایل PDF خروجی تبدیل شده را در مسیر محلی ذخیره کنید.
نمونه کد زیر نحوه تبدیل JPG به سند PDF را بدون استفاده از فضای ذخیره سازی ابری نشان می دهد. یعنی فایل ورودی را در بدنه درخواست ارسال می کنیم و فایل خروجی را در پاسخ API دریافت می کنیم.
# این مثال کد نحوه تبدیل JPT به PDF را بدون استفاده از فضای ذخیره سازی ابری نشان می دهد.
# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)
# درخواست را آماده کنید
request = groupdocs_conversion_cloud.تبدیلDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")
# تبدیل
result = convert_api.convert_document_direct(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(result, "C:\\Files\\Conversion\\")
آنلاین را امتحان کنید
لطفاً ابزار رایگان تبدیل JPG آنلاین زیر را که با استفاده از API بالا توسعه داده شده است، امتحان کنید. https://products.groupdocs.app/conversion/
نتیجه
در این مقاله یاد گرفتیم که چگونه یک فایل JPG را در فضای ابری به PDF تبدیل کنیم. همچنین نحوه تبدیل JPG به PDF و اضافه کردن واترمارک به اسناد تبدیل شده با استفاده از پایتون را دیده ایم. در این مقاله همچنین نحوه آپلود برنامه‌ای فایل تصویری JPG در فضای ابری و سپس دانلود فایل PDF تبدیل شده از ابر توضیح داده شده است. علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Conversion Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان تماس بگیرید.