ODG ფაილი არის ნახატი, რომელიც შექმნილია Draw-ის მიერ, ვექტორული გრაფიკის რედაქტირების აპლიკაცია, რომელიც ხელმისაწვდომია Apache OpenOffice-ის კომპლექტში. ის შეიცავს ერთ ან მეტ გვერდს, რომელიც შეიძლება შეიცავდეს ხაზებს, ფორმებს, სიმბოლოებს და ტექსტს. ODG ფაილი შენახულია OASIS OpenDocument სპეციფიკაციაში, რომელიც არის XML-ზე დაფუძნებული ფორმატი. იმისათვის, რომ გახსნათ ODG ფაილები ღია კოდის პროგრამებით OpenOffice.org Draw და მისი შტოში LibreOffice Draw. თუმცა, თუ ODG ფაილები გარდაიქმნება PSD-ად, ჩვენ ასევე შეგვიძლია შევინახოთ ფენები, რაც გაადვილებს უკან დაბრუნებას და ფაილის მოგვიანებით რედაქტირებას. ამ სტატიაში ჩვენ განვიხილავთ ODG ფორმატის PSD-ად გარდაქმნას REST API-ის გამოყენებით.
გამოსახულების დამუშავების API
გამოსახულების მრავალფეროვანი ფორმატი ხელმისაწვდომია ბაზარზე და არსებობს API-ების სიმრავლე მათი დასამუშავებლად. თუმცა, ჩვენი REST-ზე დაფუძნებული API უზრუნველყოფს უნიკალურ შესაძლებლობებს გამოსახულების წამყვანი ფორმატების დასამუშავებლად, მათ შორის JPEG, BMP, TIFF, GIF, PNG, PSD, SVG, DjVu, DICOM, DNG და ა.შ. ერთი API-ს გამოყენებით. გარდა ამისა, ჩვენი API-ების ერთ-ერთი გამორჩეული მახასიათებელია მისი შესაძლებლობები, მართოს ყველა ეს ფორმატი მე-3 მხარის დამოკიდებულების გარეშე. შეასრულეთ თქვენი სურათის დამუშავების ყველა დავალება Cloud API-ს გამოყენებით. არ არის საჭირო დამატებითი პროგრამული უზრუნველყოფის ჩამოტვირთვა ან ინსტალაცია. ვინაიდან API-ები შემუშავებულია REST არქიტექტურის მიხედვით, ამიტომ მათზე წვდომა შესაძლებელია ნებისმიერ პლატფორმაზე და აპლიკაციის ნებისმიერ ტიპზე, როგორიცაა Desktop, Mobile, Web, ან Hybrid Apps.
ჩვენი მომხმარებლების შემდგომი გასაადვილებლად, ჩვენ შევქმენით wrapper SDKs 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 მითითება Visual Studio გადაწყვეტის შიგნით:
- გახსენით Solution Explorer.
- გააფართოვეთ პროექტი და დააწკაპუნეთ მარჯვენა ღილაკით Packages საქაღალდეში თქვენს გადაწყვეტაში.
- აირჩიეთ Manage NuGet Packages… ოფცია
- დააწკაპუნეთ ჩანართზე „Browse“ და მოძებნეთ „Aspose.Imaging-Cloud“.
- დააწკაპუნეთ Aspose.Imaging-Cloud პაკეტზე, აირჩიეთ შესაბამისი ვერსია მარჯვენა ჩანართში და დააჭირეთ ღილაკს Add Package
უფასო Cloud გამოწერა
ახლა, მონაცემთა მთლიანობისა და კონფიდენციალურობის შესანარჩუნებლად, ჩვენ დავამატეთ უსაფრთხოების ფენა, რათა სისტემაში წვდომა მხოლოდ ავტორიზებულ პირებს შეეძლოთ. ამიტომ, თქვენ უნდა შექმნათ უფასო სააბონენტო ანგარიში Aspose.Cloud dashboard-ით. არ არის საჭირო საკრედიტო ბარათი ან გადახდის სხვა დეტალები და შეგიძლიათ შეასრულოთ 150-მდე უფასო დოკუმენტის დამუშავების მოთხოვნა.
თქვენ შეგიძლიათ გამოიყენოთ თქვენი GitHub ან Google ანგარიში უბრალოდ რეგისტრაციისთვის ან დააწკაპუნოთ ღილაკზე Create a new Account და მიაწოდოთ საჭირო ინფორმაცია. ახლა შედით საინფორმაციო დაფაზე რწმუნებათა სიგელების გამოყენებით, გააფართოვეთ აპლიკაციების განყოფილება დაფიდან და გადადით ქვემოთ კლიენტის სერთიფიკატების განყოფილებისკენ, რომ ნახოთ კლიენტის ID და კლიენტის საიდუმლო დეტალები.
გადაიყვანეთ ODG PSD-ში C#-ში
გთხოვთ, მიჰყვეთ ქვემოთ მოცემულ ნაბიჯებს კონვერტაციის შესასრულებლად C# .NET-ის გამოყენებით.
- პირველ რიგში, შექმენით ImagingApi ობიექტი არგუმენტად კლიენტის ID და კლიენტის საიდუმლო დეტალების გადაცემისას.
- მეორეც, წაიკითხეთ ODG სურათი ლოკალური დისკიდან და გადაიტანეთ იგი არგუმენტად UploadFileRequest ობიექტზე.
- მესამე, გამოიძახეთ UploadFile(…) მეთოდი ImagingApi, რომ ატვირთოთ ფაილი Cloud საცავში.
- ახლა ჩვენ უნდა შევქმნათ ConvertImageRequest კლასის ინსტანციის შექმნა, რომელიც არგუმენტად იღებს გამოსახულების სახელს და შედეგად გამომავალი ფორმატს.
- შემდეგ გამოიძახეთ ImagingApi კლასის ConvertImage(…) მეთოდი კონვერტაციის ოპერაციის დასაწყებად.
- და ბოლოს, შეინახეთ გამომავალი ნაკადიდან ადგილობრივ დისკზე 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);
// ატვირთეთ სურათი Cloud Storage-ში
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 to 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 ფაილი უკვე ხელმისაწვდომი იქნება Cloud საცავში. ამიტომ, გამოიყენეთ შემდეგი cURL ბრძანება ფაილის Cloud საცავში ატვირთვისთვის.
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 ფაილი Cloud საცავში, გთხოვთ, სცადოთ შემდეგი ბრძანების გამოყენება ფაილის 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-ს გამოყენებისას რაიმე პრობლემას წააწყდებით ან გაქვთ დამატებითი შეკითხვები, გთხოვთ, მოგერიდებათ დაგვიკავშირდეთ [პროდუქტის მხარდაჭერის უფასო ფორუმის] მეშვეობით 25.
დაკავშირებული სტატიები
ჩვენ გირჩევთ ეწვიოთ შემდეგ ბმულებს მეტი ინფორმაციისთვის: