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-ში

  1. API კლიენტის შექმნა - ინიციალიზაცია CadApi კლასი თქვენი ავტორიზაციის დეტალებით.
    var api = new Aspose.CAD.Cloud.Sdk.Api.CadApi(clientId, clientSecret);
    
  2. DWG ფაილის ატვირთვა - გამოიყენეთ UploadFile მეთოდი წყაროს ფაილის განთავსებისთვის ღრუბლოვან შენახვაში.
    api.UploadFile("input.dwg", File.ReadAllBytes("local/path/input.dwg"));
    
  3. გადაყვანის პარამეტრების მომზადება - შექმენით JSON ობიექტი სასურველი PNG პარამეტრებით (იხილეთ ცხრილი ზემოთ).
  4. გადაყვანის endpoint-ის გამოძახება - გამოიძახეთ Convert წყაროს ბილიკით, სამიზნე ფორმატით და პარამეტრებით.
    var result = api.Convert("input.dwg", "png", conversionOptions);
    
  5. 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-ს. ეს მიდგომა მაქსიმალურად ზრდის გამტარუნარიანობას და იძლევა მარტივი განხორციელება.

მეტი