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

خطوات تحويل DWG إلى PNG في Node.JS

  1. تثبيت SDK: شغّل npm install aspose-html-cloud لإضافة المكتبة إلى مشروعك.
  2. إنشاء عميل: قم بتهيئة فئة HtmlApi باستخدام CLIENT_ID و CLIENT_SECRET. هذا يصدق جميع الاستدعاءات اللاحقة.
  3. توفير مصدر DWG: إما رفع ملف DWG إلى تخزين Aspose أو الإشارة إلى مسار محلي يمكن لـ SDK قراءته.
  4. استدعاء التحويل: استدعِ convertDocument مع تعيين تنسيق الهدف إلى PNG وتمرير أي خيارات صورة مرغوبة. راجع مرجع API للحصول على توقيع الطريقة الكامل.
  5. حفظ PNG: تُعيد API تدفقًا؛ قم بتمريره إلى ملف على القرص أو إرساله مباشرةً إلى العميل في استجابة Express.

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

يوضح المثال التالي مسار Express بسيط يستقبل ملف DWG، يحوله إلى PNG باستخدام Aspose.HTML Cloud SDK، ويعيد الصورة إلى المستدعي.

// Complete working example for DWG to PNG conversion
const express = require('express');
const fileUpload = require('express-fileupload');
const { HtmlApi, ConvertDocumentRequest } = require('aspose-html-cloud');

const app = express();
app.use(fileUpload());

const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const htmlApi = new HtmlApi(clientId, clientSecret);

app.post('/convert', async (req, res) => {
    if (!req.files || !req.files.dwgFile) {
        return res.status(400).send('DWG file is required.');
    }

const dwgBuffer = req.files.dwgFile.data;

// Prepare conversion request
    const convertRequest = new ConvertDocumentRequest({
        inputFile: dwgBuffer,
        inputFormat: 'DWG',
        outputFormat: 'PNG',
        // Optional image options
        options: {
            width: 1920,
            height: 1080,
            backgroundColor: '#FFFFFF',
            compressionLevel: 9
        }
    });

try {
        const result = await htmlApi.convertDocument(convertRequest);
        // result.body contains the PNG binary stream
        res.set('Content-Type', 'image/png');
        res.send(result.body);
    } catch (error) {
        console.error('Conversion error:', error);
        res.status(5

00).send('Failed to convert DWG to PNG.');
    }
});

app.listen(3000, () => console.log('Server listening on port 3000'));

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

تحويل DWG إلى PNG عن بُعد عبر REST API باستخدام cURL

عندما تفضل استدعاءات HTTP المباشرة، يمكن الوصول إلى واجهة برمجة التطبيقات السحابية باستخدام cURL. فيما يلي الخطوات المطلوبة.

  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/v4.0/storage/file/dwgSample.dwg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @dwgSample.dwg

  3. طلب التحويل إلى PNG

    curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"dwgSample.dwg","outputPath":"output.png","options":{"width":1920,"height":1080}}'

  4. تنزيل ملف PNG الناتج

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

للحصول على قائمة كاملة بالمعلمات، راجع وثائق API الرسمية.

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

  1. تثبيت الحزمة 
    npm install aspose-html-cloud
  2. تنزيل ملفات SDK الثنائية (إذا كنت بحاجة إلى موارد محلية) من صفحة التنزيل.
  3. إعداد بيانات الاعتماد - إنشاء حساب Aspose Cloud مجاني، استرجاع CLIENT_ID و CLIENT_SECRET، وتخزينهما بأمان (يوصى باستخدام متغيرات البيئة).
  4. تطبيق ترخيص مؤقت للاختبار باستخدام المفتاح المستلم من صفحة الترخيص المؤقت.

تحويل DWG إلى PNG في Node.JS باستخدام Aspose.HTML

تمكن Aspose.HTML Cloud SDK من عرض ملفات DWG على الخادم وتحويلها إلى صيغ نقطية دون الحاجة إلى أي مكونات CAD أصلية. تقوم المكتبة بتحليل بنية DWG، وتقوم بتحويل كل تخطيط إلى صورة نقطية، وتنتج صور PNG عالية الدقة تحافظ على وزن الخطوط، والألوان، والطبقات. يجعل ذلك منها مثالية للبوابات الويب، وتكاملات GIS، وسلاسل تقارير مؤتمتة.

ميزات Aspose.HTML التي تهم هذه المهمة

  • دعم DWG الأصلي - لا حاجة إلى محولات خارجية.
  • خيارات الراستر القابلة للتكوين - العرض، الارتفاع، الخلفية، والضغط.
  • إخراج تدفقي - معالجة الملفات الكبيرة دون تحميل الصورة بالكامل في الذاكرة.
  • تكامل التخزين السحابي - القراءة من وت الكتابة إلى تخزين Aspose Cloud مباشرة.

تكوين جودة الإخراج وخيارات الصورة

عند تحويل DWG إلى PNG، يمكنك ضبط النتيجة بدقة:

options: {
    width: 2560,               // Desired pixel width
    height: 1440,              // Desired pixel height
    backgroundColor: '#FFFFFF',
    compressionLevel: 8        // PNG compression (0‑9)
}

تشمل المعلمات القابلة للتعديل الأخرى colorDepth و antiAliasing و preserveAspectRatio. راجع مرجع API للحصول على القائمة الكاملة.

تحسين الأداء لملفات DWG الكبيرة

  • استخدام البث - تُعيد SDK تدفقًا قابلًا للقراءة؛ قم بتمريره مباشرةً إلى ملف أو استجابة HTTP لتجنب ارتفاع الذاكرة.
  • تحديد الدقة - اضبط العرض/الارتفاع إلى الحد الأدنى المطلوب لحالتك.
  • المعالجة الدفعية - عالج الملفات بشكل متسلسل أو مع تحكم في التوازي للحفاظ على استقرار استهلاك المعالج.
  • تمكين ضغط gzip على طبقة HTTP إذا كنت تقدم PNGs عبر الويب.

أفضل الممارسات لتحويل DWG إلى PNG

  • تحقق من سلامة ملف DWG قبل التحويل لاكتشاف الملفات التالفة مبكرًا.
  • احفظ ملفات PNG الوسيطة في ذاكرة التخزين المؤقت عندما يُطلب نفس الرسم بشكل متكرر.
  • سجّل مدة التحويل وتابع القيم الشاذة لتحديد عنق الزجاجة في الأداء.
  • استخدم الترخيص المؤقت للتطوير وقم بالتحويل إلى ترخيص مدفوع قبل النشر في بيئة الإنتاج.

الخلاصة

من خلال الاستفادة من Aspose.HTML Cloud SDK for Node.js، يمكن للمطورين تنفيذ تحويل موثوق من DWG إلى PNG ببضع أسطر من الشيفرة فقط. يتولى الـ SDK التعامل مع عمليات عرض CAD الثقيلة، بينما توفر واجهة برمجة التطبيقات السحابية معالجة قابلة للتوسع حسب الطلب. تذكر أنه يجب الحصول على ترخيص مناسب للاستخدام في الإنتاج؛ تفاصيل التسعير متاحة على صفحة المنتج، ويمكن الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت. دمج مقتطفات الشيفرة أعلاه، وضبط الخيارات وفقًا لاحتياجاتك، وستكون جاهزًا لتقديم معاينات PNG عالية الجودة لأي رسم DWG.

الأسئلة الشائعة

  • كيف يمكنني التعامل مع المصادقة عند استخدام Aspose.HTML Cloud SDK for Node.js؟
    قم بإنشاء مثيل HtmlApi باستخدام CLIENT_ID و CLIENT_SECRET الخاصين بك. يقوم SDK تلقائيًا بطلب وتجديد رمز الوصول. راجع الوثائق الرسمية للحصول على التفاصيل.

  • ما هي صيغ الصور التي يمكنني تصديرها بخلاف PNG؟
    يدعم SDK صيغ JPEG، BMP، GIF، وTIFF بالإضافة إلى PNG. اختر الصيغة المطلوبة عن طريق ضبط معامل outputFormat في طلب التحويل.

  • هل من الممكن تحويل ملفات DWG المخزنة في Azure Blob Storage؟
    نعم. قدم عنوان URL الكامل لـ Azure Blob كـ inputPath وتأكد من أن الـ blob متاح للجمهور أو قدم رمز SAS المطلوب. عملية التحويل تعمل بنفس الطريقة كما هو الحال مع الملفات المحلية.

  • هل أحتاج إلى ترخيص مدفوع للتحويلات على نطاق واسع؟
    لأعباء العمل الإنتاجية يجب عليك شراء ترخيص كامل. الترخيص المؤقت يكفي للتطوير والاختبار، ويمكن الحصول عليه من صفحة الترخيص المؤقت.

اقرأ المزيد