DWG dosyalarını PNG görüntülerine dönüştürmek, web’de veya raporlarda mühendislik çizimlerini görüntülemesi gereken .NET uygulamaları için sık bir gereksinimdir. Aspose.CAD Cloud SDK for .NET bulutta CAD renderlemesi için ağır işleri halleden sağlam bir API sağlar. Bu kılavuz, SDK’yı kurmaktan tam bir C# örneği yazmaya, dönüşüm seçeneklerini yapılandırmaya, hataları ele almaya ve doğrudan REST çağrıları için cURL kullanmaya kadar tüm süreci adım adım gösterir.

Kurulum ve Ayarlar .NET’te

SDK’yı kullanmaya başlamak için şunlara ihtiyacınız var:

  • Sistem Gereksinimleri: .NET 6.0 veya daha yeni, bulut çağrıları için internet erişimi.
  • Paket Kurulumu: Proje dizininizde aşağıdaki komutu çalıştırın:
dotnet add package Aspose.CAD-Cloud
  • SDK’yı indirin: En son ikili dosyaları bu sayfadan alın.
  • Kimlik doğrulama: Aspose Cloud istemci kimliği ve istemci gizli anahtarını Aspose kontrol panelinizden oluşturun. Bunları güvenli bir şekilde saklayın, örneğin appsettings.json dosyasında veya ortam değişkenlerinde.
var clientId = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_ID");
var clientSecret = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_SECRET");

Aspose.CAD Cloud SDK for .NET’in Ana Özellikleri

  • Geniş Format Desteği: DWG, DXF, DWF ve birçok diğer CAD formatını PNG, JPEG, PDF ve daha fazlasına dönüştürün.
  • Yüksek Kaliteli Rasterleştirme: Çizgi kalınlıklarını, katmanları ve renkleri yapılandırılabilir DPI ile koruyun.
  • Bulut Tabanlı İşleme: Ağır render işlemlerini Aspose sunucularına aktararak yerel kaynak tüketimini azaltın.
  • Toplu Dönüştürme: Asenkron desenler kullanarak tek bir API çağrısında birden fazla dosyayı işleyin.
  • Kapsamlı Dokümantasyon: Tam API referansı resmi API referansı adresinde mevcuttur.

DWG’den PNG’ye Dönüşüm Seçeneklerini Yapılandırma

İstek gövdesinde aşağıdaki seçenekleri ayarlayarak çıktı görüntüsünü kontrol edebilirsiniz:

Seçenek Açıklama
width Hedef görüntü genişliği piksel cinsinden.
height Hedef görüntü yüksekliği piksel cinsinden.
dpi Rasterleştirme için inç başına nokta sayısı (varsayılan 300).
backgroundColor Arka plan için onaltılık renk, örnek: #FFFFFF.
layerVisibility Dahil edilecek veya hariç tutulacak katman adlarının listesi.

Örnek JSON yük:

{
  "outputFormat": "png",
  "width": 1024,
  "height": 768,
  "dpi": 300,
  "backgroundColor": "#FFFFFF"
}

Performans ve Bellek Kullanımını Optimize Etme

  • Asenkron Çağrıları Kullanın: SDK, bulut yanıtını beklerken iş parçacığını serbest bırakan async yöntemleri destekler.
  • DPI’yı Ayarlayın: Daha yüksek DPI kaliteyi artırır ancak yük boyutunu büyütür. Görsel gereksinimleri karşılayan en düşük DPI’yı seçin.
  • HttpClient’ı Yeniden Kullanın: Bağlantı havuzlamasından yararlanmak için tüm dönüşüm istekleri için tek bir HttpClient örneği oluşturun.

Hataları Ele Alma ve Dönüştürme Sorunlarını Giderme

Aşağıda, dönüşüm uç noktasından dönen yaygın HTTP durum kodları için hızlı bir referans bulunmaktadır:

Durum Kodu Anlam Önerilen Eylem
400 Geçersiz istek - hatalı parametreler JSON yükünü ve dosya formatını doğrulayın.
401 Yetkisiz - geçersiz kimlik bilgileri İstemci kimliği/gizli anahtarını ve token oluşturulmasını kontrol edin.
404 Dosya bulunamadı - kaynak DWG eksik Dosyanın doğru yola yüklendiğinden emin olun.
500 Sunucu iç hatası Kısa bir gecikmeden sonra yeniden deneyin; sorun devam ederse destek ile iletişime geçin.

DWG’yi .NET’te PNG’ye Dönüştürme Adımları

  1. API istemcisini oluşturun - Kimlik bilgilerinizle CadApi sınıfını başlatın.
    var api = new Aspose.CAD.Cloud.Sdk.Api.CadApi(clientId, clientSecret);
    
  2. DWG dosyasını yükleyin - Kaynak dosyayı bulut depolamaya yerleştirmek için UploadFile metodunu kullanın.
    api.UploadFile("input.dwg", File.ReadAllBytes("local/path/input.dwg"));
    
  3. Dönüşüm seçeneklerini hazırlayın - İstenen PNG ayarlarıyla bir JSON nesnesi oluşturun (yukarıdaki tabloya bakın).
  4. Dönüşüm uç noktasını çağırın - Convert metodunu kaynak yol, hedef format ve seçeneklerle çağırın.
    var result = api.Convert("input.dwg", "png", conversionOptions);
    
  5. PNG sonucunu indirin - İkili veriyi alın ve yerel olarak kaydedin.
    File.WriteAllBytes("output.png", result);
    

Her yöntemin daha fazla ayrıntısı için, API referansına bakın.

DWG’den PNG’ye Dönüştürme - Tam Kod Örneği

Aşağıdaki program, hata işleme ve kaynak temizleme dahil olmak üzere tam uçtan uca bir dönüşümü gösterir.

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce, dosya yollarını (sample.dwg, sample.png vb.) gerçek dosya konumlarınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL kullanarak REST API üzerinden Bulut Tabanlı DWG Dönüştürme

C# kodu yazmadan aynı sonucu, Aspose.CAD Cloud REST uç noktalarını doğrudan çağırarak elde edebilirsiniz.

1. Erişim belirteci alın

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 dosyasını yükleyin

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’ye Dönüştürme İsteği

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. Dönüştürülmüş PNG’yi indirin

curl -X GET "https://api.aspose.cloud/v3.0/storage/file/outputs/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "sample.png"

Tam parametre listesi ve ek örnekler için, resmi API belgeleri adresine bakın.

Sonuç

DWG’yi PNG’ye .NET içinde dönüştürmek, Aspose.CAD Cloud SDK for .NET gücünden yararlandığınızda oldukça basittir. SDK, dosya yükleme, dönüşüm ve indirme işlemlerini yönetirken, görüntü kalitesi ve performans üzerinde ayrıntılı kontrol sağlar. Üretim ortamı için geçerli bir lisans almayı unutmayın; geçici bir lisansı geçici lisans sayfasından edinebilir ve Aspose web sitesinde fiyatlandırma seçeneklerini inceleyebilirsiniz. Sağlanan kod örneği ve cURL komutlarıyla, DWG‑to‑PNG dönüşümünü herhangi bir .NET uygulamasına entegre etmeye hazırsınız.

SSS

S: DWG dosyasını kod yazmadan PNG’ye dönüştürmek mümkün mü?
C: Evet, cURL veya Postman gibi araçlarla REST API’yi doğrudan kullanabilirsiniz. Adımlar, “cURL kullanarak REST API ile Bulut Tabanlı DWG Dönüştürme” bölümünde açıklanmıştır ve API referansı gerekli tüm parametreleri sağlar.

S: Büyük DWG dosyalarını bellek sorunlarından kaçınmak için nasıl yönetebilirim?
C: Kod örneğinde gösterilen asenkron yöntemleri kullanın ve makul bir DPI ayarlayın (ör. 150-300). SDK, verileri buluta akıtarak yerel bellek tüketimini en aza indirir.

S: Dönüştürme 400 hatasıyla başarısız olursa ne olur?
C: 400 hatası genellikle geçersiz bir istek yükü olduğunu gösterir. JSON seçeneklerinizin “Configuring Conversion Options for DWG to PNG” bölümünde açıklanan şema ile eşleştiğini ve kaynak dosyanın belirtilen bulut yolunda mevcut olduğunu doğrulayın.

S: Birden fazla DWG dosyasını tek bir toplu işlemde PNG’ye dönüştürebilir miyim?
C: API her istek için bir dosya işlediğinden, her DWG’yi yükleyen, dönüşümü tetikleyen ve PNG’yi asenkron olarak indiren bir döngü betiği yazabilirsiniz. Bu yaklaşım verimliliği maksimize eder ve uygulamayı basit tutar.

Read More