DWG ფაილების PNG გამოსახულებებად გადაყვანა ხშირად მოთხოვნაა .NET აპლიკაციებისთვის, რომლებიც საჭიროებს ინჟინერიული ნახატების ჩვენებას ვებსაიტზე ან ანგარიშებში. Aspose.CAD Cloud SDK for .NET უზრუნველყოფს ძლიერი API-ს, რომელიც ღრმა მუშაობას ახორციელებს CAD რენდერისთვის ღრუბელში. ეს გიდი გატარებთ სრულ პროცესს, დაწყებული SDK-ის ინსტალაციით, დასრულებული სრულ C# მაგალითის დაწერით, გადაყვანის პარამეტრების კონფიგურაციით, შეცდომების დამუშავებით და cURL-ის გამოყენებით პირდაპირ REST მოთხოვნებისთვის.
დაყენება და კონფიგურაცია .NET-ში
SDK-ს გამოყენება დასაწყებად, თქვენ გჭირდებათ:
- System Requirements: .NET 6.0 ან უფრო ახალი, ინტერნეტის წვდომა ღრუბლოვანი გამოძახებებისთვის.
- Package Installation: თქვენი პროექტის დირექტორიაში გაუშვით შემდეგი ბრძანება:
dotnet add package Aspose.CAD-Cloud
- SDK-ის ჩამოტვირთვა: მიიღეთ უახლესი ბინარები ამ გვერდზე.
- ავთენტიკაცია: შექმენით Aspose Cloud client ID და client secret თქვენი Aspose dashboard-დან. შეინახეთ ისინი უსაფრთხოდ, მაგალითად appsettings.json ან გარემოს ცვლადებში.
var clientId = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_ID");
var clientSecret = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_SECRET");
Aspose.CAD Cloud SDK for .NET-ის ძირითადი ფუნქციები
- ფართო ფორმატების მხარდაჭერა: გადაყვანა DWG, DXF, DWF და სხვა მრავალი CAD ფორმატიდან PNG, JPEG, PDF, და სხვა.
- მაღალი ხარისხის რასტერიზაცია: ხაზის სისქის, ფენების და ფერების შენარჩუნება კონფიგურირებად DPI‑ით.
- ღრუბლზე დაფუძნებული დამუშავება: მძიმე რენდერის გადატანა Aspose სერვერებზე, რაც იშლება ადგილობრივ რესურსებზე დატვირთვა.
- ჯგუფური გადაყვანა: მრავალ ფაილების დამუშავება ერთ API მოთხოვნაში ასინქრონული მოდელებით.
- სრული დოკუმენტაცია: სრულ API მითითებას შეგიძლიათ ნახოთ ოფიციალურ API მითითებაში.
DWG-დან PNG-ში გადაყვანის პარამეტრების კონფიგურაცია
თქვენ შეგიძლიათ აკონტროლიროთ გამოსავალის სურათი მოთხოვნის სხეულში შემდეგი პარამეტრების დაყენებით:
| პარამეტრი | აღწერა |
|---|---|
width |
სამიზნე გამოსახულების სიგანის პიქსელებში. |
height |
სამიზნე გამოსახულების სიმაღლის პიქსელებში. |
dpi |
დოტები თითოეულ დიუმზე (dpi) რასტერიზაციისთვის (ნაგულისხმევია 300). |
backgroundColor |
ჰექსა ფერი ფონისთვის, მაგალითად, #FFFFFF. |
layerVisibility |
ფენის სახელების სია, რომელიც უნდა იყოს შედგენილი ან გამორიცხვული. |
მაგალითი JSON payload:
{
"outputFormat": "png",
"width": 1024,
"height": 768,
"dpi": 300,
"backgroundColor": "#FFFFFF"
}
შესრულების ოპტიმიზაცია და მეხსიერების მოხმარება
- გამოიყენეთ ასინქრონული გამოძახებები: SDK-ს აქვს async მეთოდები, რომლებიც თავისუფლებენ ნაკადს ღრუბელში პასუხის მოლოდინისას.
- DPI-ის რეგულირება: მაღალი DPI აუმჯობესებს ხარისხს, მაგრამ ზრდის გადაცემის ზომას. აირჩიეთ ყველაზე დაბალი DPI, რომელიც აკმაყოფილებს ვიზუალურ მოთხოვნებს.
- HttpClient-ის გადამუშავება: შექმენით ერთი
HttpClientინსტანს ყველა კონვერსიის მოთხოვნისთვის, რათა მიიღოთ კავშირის პულინგის უპირატესობები.
შეცდომების დამუშავება და გადაყვანის პრობლემების გადაჭრა
ქვემოთ მოცემულია სწრაფი მითითება საერთო HTTP სტატუსის კოდებისთვის, რომლებიც დაბრუნდება კონვერსიის საბოლოო წერტილიდან:
| სტატუსის კოდი | მნიშვნელობა | შემოთავაზებული მოქმედება |
|---|---|---|
| 400 | არასწორი მოთხოვნა - არასწორი პარამეტრები | შეამოწმეთ JSON-ის შიგთავსი და ფაილის ფორმატი. |
| 401 | ავტორიზაციის შეცდომა - არასწორი ავტორიზაციის დეტალები | შეამოწმეთ კლიენტის ID/საიდუმლო და ტოკენის გენერაცია. |
| 404 | ფაილი ვერ მოიძებნა - წყარო DWG არ არსებობს | დარწმუნდით, რომ ფაილი ატვირთულია სწორი გზაზე. |
| 500 | შიდა სერვერის შეცდომა | სცადეთ თავიდან მოკლე დაყოვნებით; თუ პრობლემა გაგრძელდება, დაუკავშირდით მხარდაჭერას. |
DWG-ს PNG-ში გადაყვანის ნაბიჯები .NET-ში
- API კლიენტის შექმნა - ინიციალიზაცია
CadApiკლასი თქვენი ავტორიზაციის დეტალებით.var api = new Aspose.CAD.Cloud.Sdk.Api.CadApi(clientId, clientSecret); - DWG ფაილის ატვირთვა - გამოიყენეთ
UploadFileმეთოდი წყაროს ფაილის განთავსებისთვის ღრუბლოვან შენახვაში.api.UploadFile("input.dwg", File.ReadAllBytes("local/path/input.dwg")); - გადაყვანის პარამეტრების მომზადება - შექმენით JSON ობიექტი სასურველი PNG პარამეტრებით (იხილეთ ცხრილი ზემოთ).
- გადაყვანის endpoint-ის გამოძახება - გამოიძახეთ
Convertწყაროს ბილიკით, სამიზნე ფორმატით და პარამეტრებით.var result = api.Convert("input.dwg", "png", conversionOptions); - PNG შედეგის ჩამოტვირთვა - მიიღეთ ბინარული მონაცემები და შეინახეთ ლოკალურად.
File.WriteAllBytes("output.png", result);
თითოეული მეთოდის შესახებ მეტი დეტალებისთვის, იხილეთ API დოკუმენტაცია.
DWG-დან PNG-ზე გადაყვანა - სრული კოდის მაგალითი
შემდეგი პროგრამა აჩვენებს სრულ end‑to‑end გადაყვანას, რომელიც მოიცავს შეცდომების დამუშავებას და რესურსების გასუფთავებას.
შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითად ფუნქციას. თქვენს პროექტში მისი გამოყენებამდე, დარწმუნდით, რომ განაახლეთ ფაილების ბილიკები (
sample.dwg,sample.png, ა.შ.) თქვენი რეალური ფაილების მდებარეობებთან, გადაამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაინსტალირებულია, და სრულად ტესტირეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემას შეხვდებით, გთხოვთ, მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.
ღრუბლოვანი DWG კონვერტირება REST API-ის გამოყენებით cURL
თქვენ შეგიძლიათ მიიღოთ იგივე შედეგი C# კოდის დაწერის გარეშე, Aspose.CAD Cloud REST საბოლოო წერტილებზე პირდაპირ გამოძახებით.
1. მიიღეთ წვდომის ტოკენი
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
2. DWG ფაილის ატვირთვა
curl -X PUT "https://api.aspose.cloud/v3.0/storage/file/inputs/sample.dwg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@sample.dwg"
3. PNG-ზე გადაყვანის მოთხოვნა
curl -X POST "https://api.aspose.cloud/v3.0/cad/convert" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"inputPath": "inputs/sample.dwg",
"outputPath": "outputs/sample.png",
"format": "png",
"options": {
"width": 1024,
"height": 768,
"dpi": 300,
"backgroundColor": "#FFFFFF"
}
}'
4. გადმოწერეთ გადაყვანილი PNG
curl -X GET "https://api.aspose.cloud/v3.0/storage/file/outputs/sample.png" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "sample.png"
პარამეტრების სრულ სიასა და დამატებით მაგალითებისთვის იხილეთ ოფიციალური API დოკუმენტაცია.
დასკვნა
DWG‑ის PNG‑ში გადაყვანა .NET-ში მარტივია, როდესაც იყენებთ Aspose.CAD Cloud SDK for .NET-ის შესაძლებლობას. SDK‑ი მართავს ფაილის ატვირთვას, გადაყვანას და გადმოწერას, ასევე გთავაზობთ დეტალურ კონტროლს გამოსახულების ხარისხის და შესრულების შესახებ. გახსოვდეთ, რომ წარმოებაში გამოყენებისთვის საჭიროა მოქმედ ლიცენზია; დროებით ლიცენზია შეგიძლიათ მიიღოთ დროებით ლიცენზიის გვერდიდან და შეისწავლეთ ფასის არჩევანი Aspose-ის ვებგვერდზე. მოწოდებული კოდის ნიმუშითა და cURL ბრძანებებით, მზად ხართ DWG‑დან PNG‑ში გადაყვანის ინტეგრირებისთვის ნებისმიერი .NET აპლიკაციაში.
ხშირად დასმული კითხვები
Q: შესაძლებელია DWG ფაილის PNG ფორმატში გადაყვანა კოდის გარეშე?
A: დიახ, შეგიძლიათ პირდაპირ გამოიყენოთ REST API ინსტრუმენტებით, როგორიცაა cURL ან Postman. ნაბიჯები აღწერილია “Cloud-Based DWG Conversion via REST API using cURL” განყოფილებაში, ხოლო API-ის დოკუმენტაციაში მოცემულია ყველა საჭირო პარამეტრი.
Q: როგორ უნდა მოვამუშაო დიდი DWG ფაილები, რათა თავიდან ავიცილოთ მეხსიერების პრობლემები?
A: გამოიყენეთ ასინქრონული მეთოდები, რომლებიც წარმოდგენილია კოდის მაგალითში, და დააყენეთ სამართლიანი DPI (მაგ., 150-300). SDK-ი მონაცემებს ნაკადის სახით გადაგზავნის ღრუბელში, რაც მინიმალურ ადგილობრივ მეხსიერებაზე დატვირთვას იწვევს.
Q: რა მოხდება, თუ კონვერტაცია ჩავარდა 400 შეცდომით?
A: 400 შეცდომა ჩვეულებრივ ნიშნავს არასწორ მოთხოვნის payload-ს. დარწმუნდით, რომ თქვენი JSON პარამეტრები ემთხვევა სქემას, რომელიც აღწერილია “Configuring Conversion Options for DWG to PNG” განყოფილებაში, და რომ წყაროს ფაილი არსებობს მითითებულ ღრუბლოვან ბილიკში.
Q: შეიძლება რამდენიმე DWG ფაილის PNG ფორმატში ერთ ბაჩ ოპერაციით გადაყვანა?
A: API ერთ მოთხოვნაზე ერთი ფაილი დამუშავებს, თუმცა შეგიძლიათ სცენარი შექმნათ ციკლში, რომელიც ატვირთავს თითოეულ DWG-ს, ახორციელებს გადაყვანას და ასინქრონულად გადმოწერს PNG-ს. ეს მიდგომა მაქსიმალურად ზრდის გამტარუნარიანობას და იძლევა მარტივი განხორციელება.