קובץ ODG הוא ציור שנוצר על ידי Draw, אפליקציה לעריכת גרפיקה וקטורית הזמינה בחבילת Apache OpenOffice. הוא מכיל עמוד אחד או יותר שעשויים לכלול קווים, צורות, סמלים וטקסט. הקובץ 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, PSD, SVG, DjVu, DICOM, DNG וכו’ באמצעות API יחיד. יתר על כן, אחד המאפיינים הבולטים של ממשקי ה-API שלנו הוא היכולות שלו לטפל בכל הפורמטים הללו ללא תלות של צד שלישי. בצע את כל משימות עיבוד התמונה שלך באמצעות Cloud API. אין צורך בהורדה או התקנה של תוכנה נוספת. מכיוון שממשקי ה-API מפותחים לפי ארכיטקטורת REST, כך שניתן לגשת אליהם בכל פלטפורמה ובכל סוג יישום כגון שולחן עבודה, נייד, אינטרנט או אפליקציות היברידיות.
כדי להקל על הלקוחות שלנו, יצרנו ערכת SDK סביב ממשקי Cloud API כך שתקבל את כל התכונות והיכולות בשפה שתבחר. במאמר זה, אנו הולכים לדון ביכולות של Aspose.Imaging Cloud SDK עבור .NET.
הַתקָנָה
השלב הראשון בשימוש ב-SDK התכנות הוא ההתקנה שלו, והוא זמין להורדה ב-NuGet ו-GitHub. אז כדי להתקין את ה-SDK דרך NuGet, אנא בצע את הפקודה הבאה בחלון מסוף:
nuget install Aspose.Imaging-Cloud
או שתשקול לבצע את הפקודה הבאה במנהל החבילות של NuGet:
PM> Install-Package Aspose.Imaging-Cloud
התקנת Visual Studio
אנחנו יכולים גם להוסיף ישירות את ההפניה לענן SDK בתוך פתרון Visual Studio:
- פתח את סייר הפתרונות.
- הרחב את הפרויקט ולחץ לחיצה ימנית על תיקיית החבילות בתוך הפתרון שלך.
- בחר באפשרות ניהול חבילות NuGet…
- לחץ על הכרטיסייה עיון וחפש “Aspose.Imaging-Cloud”.
- לחץ על חבילת Aspose.Imaging-Cloud, בחר את הגרסה המתאימה בכרטיסייה הימנית ולחץ על כפתור הוסף חבילה
מנוי חינם לענן
כעת, על מנת לשמור על שלמות הנתונים והפרטיות, הוספנו שכבת אבטחה, כך שרק אנשים מורשים יוכלו לגשת למערכת. לכן, עליך ליצור חשבון מנוי בחינם על ידי ביקור במרכז השליטה של Aspose.Cloud. אין צורך בכרטיס אשראי או פרטי תשלום אחרים, ותוכל לבצע עד 150 בקשות לעיבוד מסמכים בחינם.
אתה יכול להשתמש בחשבון GitHub או Google כדי פשוט להירשם או, לחץ על הלחצן צור חשבון חדש וספק את המידע הנדרש. כעת היכנס ללוח המחוונים באמצעות אישורים, הרחב את הקטע יישומים מלוח המחוונים וגלול מטה אל הקטע אישורי לקוח כדי לראות את פרטי זיהוי הלקוח ופרטי סוד הלקוח.
המר ODG ל-PSD ב-C#
אנא בצע את השלבים המפורטים להלן כדי לבצע את ההמרה באמצעות C# .NET.
- ראשית, צור אובייקט ImagingApi תוך העברת פרטי Client ID ופרטי Client Secret כארגומנטים.
- שנית, קרא את תמונת ODG מהכונן המקומי והעביר אותה כארגומנט לאובייקט UploadFileRequest.
- שלישית, קרא לשיטת UploadFile(…) של ImagingApi כדי להעלות את הקובץ לאחסון בענן.
- כעת עלינו ליצור מופע של מחלקה ConvertImageRequest אשר לוקח את שם התמונה ופורמט הפלט המתקבל כארגומנטים.
- לאחר מכן קרא לשיטת ConvertImage(…) של מחלקה ImagingApi כדי להתחיל את פעולת ההמרה.
- לבסוף, שמור את הפלט מהזרם לכונן המקומי באמצעות File.Create (השיטה המותאמת אישית משותפת למטה).
// קבל זיהוי לקוח מ-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 ל-PSD באמצעות פקודת cURL
כפי שצוין קודם לכן, ממשקי ה-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 SDKs מפותחים תחת רישיון MIT, כך שקוד המקור המלא זמין ב-GitHub.
במקרה שנתקלת בבעיות כלשהן במהלך השימוש בממשק ה-API או שיש לך שאלות נוספות, אל תהסס לפנות אלינו דרך פורום תמיכת מוצרים בחינם.
מאמרים קשורים
אנו ממליצים לבקר בקישורים הבאים כדי ללמוד עוד על: