دليل تحويل DWG إلى PNG في .NET

تحويل ملفات DWG إلى صور PNG هو طلب شائع لتطبيقات .NET التي تحتاج إلى عرض الرسومات الهندسية على الويب أو في التقارير. يوفر Aspose.CAD Cloud SDK for .NET واجهة برمجة تطبيقات قوية تتعامل مع عملية التصيير الثقيلة لـ CAD في السحابة. يشرح هذا الدليل العملية بالكامل بدءًا من تثبيت SDK وحتى كتابة مثال كامل بلغة C#، وتكوين خيارات التحويل، ومعالجة الأخطاء، واستخدام cURL لإجراء مكالمات REST مباشرة.

التثبيت والإعداد في .NET

لبدء استخدام SDK تحتاج إلى:

• System Requirements: .NET 6.0 أو أحدث، اتصال بالإنترنت لاستدعاءات السحابة.
• Package Installation: شغّل الأمر التالي في دليل مشروعك:

dotnet add package Aspose.CAD-Cloud

• تنزيل SDK: احصل على أحدث الملفات الثنائية من هذه الصفحة.
• المصادقة: أنشئ معرف عميل Aspose Cloud ومفتاح سري للعميل من لوحة تحكم Aspose الخاصة بك. احفظهما بأمان، على سبيل المثال في 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

يمكنك التحكم في صورة الإخراج عن طريق ضبط الخيارات التالية في جسم الطلب:

مثال على حمولة JSON:

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

تحسين الأداء واستخدام الذاكرة

• استخدام المكالمات غير المتزامنة: يدعم SDK طرقًا غير متزامنة تحرّر الخيط أثناء انتظار استجابة السحابة.
• ضبط DPI: DPI أعلى يحسن الجودة لكنه يزيد حجم الحمولة. اختر أقل DPI يلبي المتطلبات البصرية.
• إعادة استخدام HttpClient: أنشئ نسخة واحدة من HttpClient لجميع طلبات التحويل للاستفادة من تجميع الاتصالات.

معالجة الأخطاء واستكشاف مشكلات التحويل

فيما يلي مرجع سريع لأكواد حالة HTTP الشائعة التي تُرجعها نقطة النهاية للتحويل:

خطوات تحويل 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. استدعاء نقطة النهاية للتحويل - استدعِ Convert مع مسار المصدر، الصيغة المستهدفة، والخيارات.

   var result = api.Convert("input.dwg", "png", conversionOptions);
   

5. تنزيل نتيجة PNG - استرجع البيانات الثنائية واحفظها محليًا.

   File.WriteAllBytes("output.png", result);
   

لمزيد من التفاصيل حول كل طريقة، راجع مرجع API.

تحويل DWG إلى PNG - مثال كامل للكود

البرنامج التالي يوضح تحويلًا كاملاً من البداية إلى النهاية، بما في ذلك معالجة الأخطاء وتنظيف الموارد.

ملاحظة: هذا المثال البرمجي يوضح الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (sample.dwg, sample.png, إلخ) لتطابق مواقع ملفاتك الفعلية، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحويل DWG عبر السحابة باستخدام REST API وcURL

يمكنك تحقيق النتيجة نفسها دون كتابة كود C# عن طريق استدعاء نقاط النهاية REST السحابية لـ Aspose.CAD مباشرةً.

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.

الأسئلة المتكررة

س: هل من الممكن تحويل ملف DWG إلى PNG دون كتابة أي كود؟
ج: نعم، يمكنك استخدام REST API مباشرةً مع أدوات مثل cURL أو Postman. تم توضيح الخطوات في قسم “تحويل DWG عبر السحابة باستخدام REST API وcURL”، وتوفر مرجع API جميع المعلمات المطلوبة.

س: كيف يمكنني التعامل مع ملفات DWG الكبيرة لتجنب مشاكل الذاكرة؟
ج: استخدم الأساليب غير المتزامنة الموضحة في مثال الشيفرة وحدد قيمة DPI معقولة (مثال: 150-300). يقوم SDK ببث البيانات إلى السحابة، مما يقلل من استهلاك الذاكرة المحلي.

س: ماذا لو فشل التحويل مع خطأ 400؟
ج: عادةً ما يشير خطأ 400 إلى حمولة طلب غير صالحة. تحقق من أن خيارات JSON الخاصة بك تتطابق مع المخطط الموضح في قسم “Configuring Conversion Options for DWG to PNG” وأن ملف المصدر موجود في مسار السحابة المحدد.

س: هل يمكنني تحويل ملفات DWG متعددة إلى PNG في عملية دفعة واحدة؟
ج: بينما تقوم الواجهة البرمجية (API) بمعالجة ملف واحد لكل طلب، يمكنك كتابة حلقة برمجية تقوم بتحميل كل ملف DWG، استدعاء التحويل، وتنزيل PNG بشكل غير متزامن. يتيح هذا النهج أقصى قدر من الإنتاجية ويحافظ على بساطة التنفيذ.

اقرأ المزيد

• تحويل DWG إلى PDF | حفظ DWG كـ JPG | تحويل DWG إلى PNG باستخدام C#
• STL إلى BMP - تحويل STL إلى BMP في C#
• REST API لتحويل ملفات AutoCAD DWG DXF DWF (قلب أو تدوير)