فایل ODG طرحی است که توسط Draw، یک برنامه ویرایش گرافیکی برداری که در مجموعه آپاچی اوپن آفیس موجود است، ایجاد شده است. این شامل یک یا چند صفحه است که ممکن است شامل خطوط، اشکال، نمادها و متن باشد. فایل ODG در مشخصات OASIS OpenDocument که یک فرمت مبتنی بر XML است، ذخیره میشود. به منظور باز کردن فایلهای ODG با برنامههای منبع باز OpenOffice.org Draw و شاخه آن LibreOffice Draw. با این حال، اگر فایلهای ODG به PSD تبدیل شوند، میتوانیم لایهها را نیز ذخیره کنیم، که بازگشت به عقب و ویرایش فایل را بعدا آسان میکند. در این مقاله قصد داریم در مورد تبدیل فرمت ODG به PSD با استفاده از REST API بحث کنیم.
API پردازش تصویر
طیف گسترده ای از فرمت های تصویر در بازار موجود است و تعداد زیادی API برای پردازش آنها وجود دارد. با این حال، API مبتنی بر REST ما قابلیتهای منحصربهفردی را برای پردازش فرمتهای تصویر پیشرو از جمله JPEG، BMP، TIFF، GIF، [PNG][ ارائه میکند. 12]، PSD، SVG، DjVu، DICOM، DNG و غیره با استفاده از یک API واحد. علاوه بر این، یکی از ویژگیهای برجسته APIهای ما، قابلیتهای آن برای مدیریت تمام این قالبها بدون وابستگی به شخص ثالث است. تمام وظایف پردازش تصویر خود را با استفاده از Cloud API انجام دهید. نیازی به دانلود یا نصب نرم افزار اضافی نیست. از آنجایی که APIها بر اساس معماری REST توسعه یافته اند، بنابراین می توان به آنها در هر پلتفرم و هر نوع برنامه ای مانند دسکتاپ، موبایل، وب یا برنامه های ترکیبی دسترسی داشت.
برای تسهیل بیشتر مشتریان خود، SDKs wrapper را پیرامون Cloud API ایجاد کردهایم تا همه ویژگیها و قابلیتها را به زبان دلخواه خود دریافت کنید. در این مقاله قصد داریم به قابلیت های Aspose.Imaging Cloud SDK برای .NET بپردازیم.
نصب و راه اندازی
اولین گام در استفاده از SDK برنامه نویسی نصب آن است و برای دانلود در NuGet و GitHub در دسترس است. بنابراین برای نصب SDK از طریق NuGet، لطفاً دستور زیر را در پنجره ترمینال اجرا کنید:
nuget install Aspose.Imaging-Cloud
یا ممکن است دستور زیر را در مدیریت بسته NuGet اجرا کنید:
PM> Install-Package Aspose.Imaging-Cloud
نصب ویژوال استودیو
همچنین میتوانیم مرجع Cloud SDK را مستقیماً در راهحل ویژوال استودیو اضافه کنیم:
- Solution Explorer را باز کنید.
- پروژه را گسترش دهید و روی پوشه Packages در راه حل خود کلیک راست کنید.
- گزینه Manage NuGet Packages… را انتخاب کنید
- روی تب Browse کلیک کنید و “Aspose.Imaging-Cloud” را جستجو کنید.
- روی بسته Aspose.Imaging-Cloud کلیک کنید، نسخه مناسب را در برگه سمت راست انتخاب کنید و روی دکمه Add Package کلیک کنید.
اشتراک رایگان Cloud
اکنون برای حفظ یکپارچگی و حفظ حریم خصوصی داده ها، یک لایه امنیتی اضافه کرده ایم تا فقط افراد مجاز بتوانند به سیستم دسترسی داشته باشند. بنابراین، باید با مراجعه به Aspose.Cloud dashboard یک حساب اشتراک رایگان ایجاد کنید. هیچ کارت اعتباری یا سایر جزئیات پرداخت مورد نیاز نیست و می توانید حداکثر 150 درخواست پردازش سند رایگان را انجام دهید.
میتوانید از حساب GitHub یا Google خود برای ثبتنام استفاده کنید یا روی دکمه ایجاد یک حساب جدید کلیک کنید و اطلاعات مورد نیاز را ارائه دهید. اکنون با استفاده از اعتبارنامه وارد داشبورد شوید، بخش Applications را از داشبورد گسترش دهید و به سمت پایین به سمت قسمت Client Credentials حرکت کنید تا Client ID و Client Secret جزئیات را ببینید.
تبدیل ODG به PSD در C#
لطفاً مراحل زیر را برای انجام تبدیل با استفاده از C#.NET دنبال کنید.
- ابتدا، شی ImagingApi را ایجاد کنید و جزئیات Client ID و Client Secret را به عنوان آرگومان ارسال کنید.
- در مرحله دوم، تصویر ODG را از درایو محلی بخوانید و آن را به عنوان آرگومان به شی UploadFileRequest ارسال کنید.
- سوم، روش UploadFile(…) ImagingApi را برای آپلود فایل در فضای ذخیره سازی ابری فراخوانی کنید.
- اکنون باید یک نمونه از کلاس ConvertImageRequest ایجاد کنیم که نام تصویر و فرمت خروجی حاصل را به عنوان آرگومان می گیرد.
- سپس متد ConvertImage(…) از کلاس ImagingApi را برای شروع عملیات تبدیل فراخوانی کنید.
- در نهایت، خروجی را از استریم در درایو محلی با استفاده از File.Create ذخیره کنید (روش سفارشی در زیر به اشتراک گذاشته شده است).
// ClientID را از https://dashboard.aspose.cloud/ دریافت کنید
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";
// نمونه ImagingApi را ایجاد کنید
ImagingApi imagingApi= new ImagingApi( clientSecret,clientID,"https://api.aspose.cloud/");
// مسیر تصویر ODG ورودی
string imageFile = "file-example_PDF.odg";
// فرمت فایل خروجی
string format = "PSD";
// نام فایل حاصل
string resultantFile = "Converted.psd";
try
{
// فایل را از درایو محلی بارگیری کنید
using (var file = System.IO.File.OpenRead(@"C:\Users\shahbnay\Desktop\" + imageFile))
{
// نمونه FileUploadRequest را ایجاد کنید
var uploadFileRequest = new UploadFileRequest(imageFile, file);
// تصویر را در فضای ذخیرهسازی ابری آپلود کنید
imagingApi.UploadFile(uploadFileRequest);
}
// ConvertImageRequest را ایجاد کنید
var response = new ConvertImageRequest(imageFile, format, null, null);
// عملیات تبدیل را آغاز کنید
Stream updatedImage = imagingApi.ConvertImage(response);
// پیام موفقیت چاپ در صورت موفقیت آمیز بودن تبدیل
if (response != null && response.Equals("OK"))
{
Console.WriteLine("ODG successfully converted to PSD !");
Console.ReadKey();
}
// روش سفارشی برای ذخیره فایل حاصل در درایو سیستم محلی
saveToDisk(updatedImage, @"C:\Users\shahbnay\Desktop\" + resultantFile);
}catch (Exception ex)
{
Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
// روش سفارشی برای ذخیره جریان به عنوان نمونه فایل
static void saveToDisk(Stream responseStream, String resultantFile)
{
var fileStream = File.Create(resultantFile);
responseStream.Seek(0, SeekOrigin.Begin);
responseStream.CopyTo(fileStream);
fileStream.Close();
}
ODG به PSD با استفاده از دستور cURL
همانطور که قبلا ذکر شد، Cloud API ها بر اساس معماری REST توسعه یافته اند، بنابراین می توان با استفاده از دستورات cURL نیز به آنها دسترسی داشت. با این حال، قبل از انجام عملیات تبدیل فایل، لطفاً سعی کنید یک نشانه دسترسی JWT بر اساس اعتبار مشتری خود ایجاد کنید. لطفاً دستور cURL زیر را برای تولید رمز دسترسی JWT اجرا کنید.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=4db2f826-bf9c-42e7-8b2a-8cbca2d15553&client_secret=d757548a9f2558c39c2feebdf85b4c44" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
از آنجایی که ما قصد داریم از API استفاده کنیم، انتظار دارد فایل ODG ورودی از قبل در فضای ذخیره سازی ابری موجود باشد. بنابراین از دستور cURL زیر برای آپلود فایل در فضای ذخیره سازی ابری استفاده کنید.
curl -X PUT "https://api.aspose.cloud/v3.0/imaging/storage/file/file-example_PDF.odg" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: multipart/form-data" \
-d {"File":{}}
اکنون که فایل ODG را در فضای ذخیرهسازی ابری آپلود کردهایم، لطفاً از دستور زیر برای تبدیل فایل به فرمت PSD استفاده کنید.
curl -v -X GET "https://api.aspose.cloud/v3.0/imaging/file-example_PDF.odg/convert?format=PSD" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-o Converted.psd
برای اهداف آزمایشی، نمونه فایل ODG مورد استفاده در مثال بالا را می توان از file-examplePDF.odg دانلود کرد.
نتیجه گیری
در این مقاله به ویژگی های Aspose.Imaging Cloud برای فرمت های تصویری محبوب پرداخته ایم. علاوه بر این، ما به طور خاص در مورد جزئیات نحوه تبدیل فایل های تصویری ODG به فرمت PSD با استفاده از یک قطعه کد C#.NET بحث کرده ایم. در بخش بعدی، ما در مورد جزئیات نحوه انجام همان تبدیل با استفاده از دستورات cURL بحث کرده ایم. همچنین، لطفاً توجه داشته باشید که Cloud SDK تحت مجوز MIT توسعه یافته است، بنابراین کد منبع کامل در GitHub موجود است.
اگر هنگام استفاده از API با مشکلی مواجه شدید یا سؤالات دیگری دارید، لطفاً از طریق [تالار گفتمان پشتیبانی رایگان محصول] با ما تماس بگیرید.
مقالات مرتبط
توصیه می کنیم برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید:
- [PNG به PDF – تبدیل PNG به PDF در سی شارپ26