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ı
- API istemcisini oluşturun - Kimlik bilgilerinizle
CadApisınıfını başlatın.var api = new Aspose.CAD.Cloud.Sdk.Api.CadApi(clientId, clientSecret); - DWG dosyasını yükleyin - Kaynak dosyayı bulut depolamaya yerleştirmek için
UploadFilemetodunu kullanın.api.UploadFile("input.dwg", File.ReadAllBytes("local/path/input.dwg")); - Dönüşüm seçeneklerini hazırlayın - İstenen PNG ayarlarıyla bir JSON nesnesi oluşturun (yukarıdaki tabloya bakın).
- Dönüşüm uç noktasını çağırın -
Convertmetodunu kaynak yol, hedef format ve seçeneklerle çağırın.var result = api.Convert("input.dwg", "png", conversionOptions); - 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.pngvb.) 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.