تحويل DGN إلى PSD باستخدام GroupDocs.Conversion لـ .NET

مقدمة

إذا كنت بحاجة إلى تحويل رسومات AutoCAD DGN إلى ملفات Photoshop PSD، فإن groupdocs conversion .net هي المكتبة الموثوقة التي تقوم بالعمل الشاق. في هذا الدليل ستكتشف لماذا تُعد هذه API خيارًا مفضلاً للمطورين، وكيفية تثبيتها، والكود الدقيق الذي تحتاجه لتشغيل تحويل DGN إلى PSD بلا أخطاء. في النهاية، ستكون جاهزًا لدمج منطق التحويل في أي تطبيق .NET وتعزيز كفاءة سير العمل الخاص بك.

إجابات سريعة

  • أي مكتبة تتعامل مع تحويل DGN → PSD؟ GroupDocs.Conversion for .NET.
  • هل أحتاج إلى ترخيص للإنتاج؟ نعم – الترخيص الكامل يزيل حدود النسخة التجريبية.
  • هل يمكنني تحويل ملفات DGN متعددة الصفحات؟ يتم حفظ كل صفحة كملف PSD منفصل.
  • ما إصدارات .NET المدعومة؟ .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6+.
  • كم يستغرق التحويل النموذجي؟ تقريبًا 0.5 ثانية لكل صفحة للملفات التي تقل عن 200 صفحة على خادم عادي.

ما هو groupdocs conversion .net؟

GroupDocs.Conversion لـ .NET هي API عالية الأداء تمكّن التحويل البرمجي بين أكثر من 50 تنسيقًا من المستندات والصور وCAD — بما في ذلك DGN إلى PSD — دون الحاجة إلى تطبيقات خارجية. تقوم بمعالجة الملفات في الذاكرة، مما يقلل من عبء I/O ويحسن زمن الاستجابة. كما توفر المكتبة دعمًا مدمجًا للبث، ومعالجة الدُفعات، وتسجيل مفصل، مما يجعلها مناسبة لكل من الأدوات الصغيرة وخطوط الأنابيب المؤسسية على نطاق واسع.

لماذا نستخدم GroupDocs.Conversion لتحويل DGN → PSD؟

توفر GroupDocs.Conversion مجموعة واسعة من الصيغ، بنية قابلة للتوسع، وعرضًا عالي الدقة. يمكنها التعامل مع ملفات DGN التي تحتوي على مئات الصفحات مع الحفاظ على استهلاك الذاكرة أقل من 150 ميغابايت عن طريق بث الصفحات واحدةً تلو الأخرى. يتم الحفاظ على الدقة عند 99.9 %، ويستغرق التحويل النموذجي لملف DGN مكوّن من 150 صفحة أقل من 45 ثانية على معالج 2.4 GHz.

المتطلبات المسبقة

  • GroupDocs.Conversion for .NET (الإصدار 25.3.0 أو أحدث)
  • بيئة تطوير .NET (Visual Studio 2022 أو VS Code)
  • معرفة أساسية بـ C#

كيف أقوم بتثبيت GroupDocs.Conversion لـ .NET؟

يمكنك تثبيت الحزمة عبر NuGet. افتح Package Manager Console في Visual Studio وشغّل:

Install-Package GroupDocs.Conversion

أو، إذا كنت تفضّل .NET CLI، نفّذ:

dotnet add package GroupDocs.Conversion

كلا الأمرين يقومان بتنزيل أحدث الثنائيات المستقرة وإضافة المراجع اللازمة إلى ملف المشروع الخاص بك.

كيف يمكنني الحصول على ترخيص GroupDocs conversion؟

الترخيص الصالح يفتح جميع الميزات ويزيل العلامات المائية. اختر أحد الخيارات التالية:

  • تجربة مجانية: محدودة بـ 5 تحويلات يوميًا.
  • ترخيص مؤقت: مجموعة كاملة من الميزات لمدة 30 يومًا، مثالي للتقييم.
  • ترخيص مدفوع: ترخيص لكل مطور أو ترخيص شامل للموقع للاستخدام في الإنتاج.

قم بزيارة صفحة الشراء الرسمية أو صفحة الترخيص‑المؤقت للحصول على التفاصيل.

كيف أقوم بتهيئة محرك التحويل؟

فئة ConversionConfig تخزن الإعدادات العامة مثل مسارات التخزين ومعلومات الترخيص. قم بتهيئتها مرة واحدة عند بدء تشغيل التطبيق:

var config = new ConversionConfig
{
    LicensePath = @"C:\Licenses\GroupDocs.Conversion.lic",
    StoragePath = @"C:\ConvertedFiles"
};

فئة Converter تقوم بتنفيذ التحويل الفعلي للملف بناءً على التكوين المقدم.

كيفية تحويل ملف DGN إلى PSD خطوة بخطوة

حمّل ملف DGN المصدر، اضبط خيارات PSD، وبث كل صفحة إلى ملف PSD منفصل. العملية مُجسَّدة في ثلاث خطوات مختصرة.

الخطوة 1: إعداد أدلة الإخراج وقالب التسمية

حدد أين سيتم تخزين ملفات PSD الناتجة وكيفية تسميتها:

string outputFolder = Path.Combine(config.StoragePath, "DgnToPsd");
Directory.CreateDirectory(outputFolder);
string fileTemplate = Path.Combine(outputFolder, "Page_{0}.psd");

الخطوة 2: إنشاء معالج تدفق لكل صفحة

طريقة المساعدة SavePage تكتب مصفوفة البايتات الخاصة بكل صفحة إلى تدفق ملف، مع ضمان الإغلاق السليم:

void SavePage(Stream pageStream, int pageNumber)
{
    string filePath = string.Format(fileTemplate, pageNumber);
    using (var file = new FileStream(filePath, FileMode.Create, FileAccess.Write))
    {
        pageStream.CopyTo(file);
    }
}

الخطوة 3: تحميل ملف DGN وتنفيذ التحويل

أنشئ كائن Converter، اضبط خيارات PSD، وتكرّر عبر الصفحات:

using (var converter = new Converter("sample.dgn", config))
{
    var options = new PsdConvertOptions();
    var pages = converter.GetPages();

    int pageIndex = 1;
    foreach (var page in pages)
    {
        using (var stream = new MemoryStream())
        {
            converter.Convert(page, stream, options);
            SavePage(stream, pageIndex++);
        }
    }
}

الكود أعلاه يقرأ كل صفحة من DGN، يحولها إلى تدفق PSD، ويحفظها باستخدام المساعد SavePage.

كيف أتعامل مع ملفات DGN الكبيرة بكفاءة؟

عند التعامل مع ملفات أكبر من 200 ميغابايت، فعّل وضع البث لتجنب تحميل المستند بالكامل في الذاكرة. هذه العلامة تخبر المحرك بمعالجة الصفحات واحدةً تلو الأخرى، مما يحافظ على انخفاض استهلاك الذاكرة القصوى:

var config = new ConversionConfig { EnableStreaming = true };

المشكلات الشائعة والحلول

  • مسار الملف غير موجود: استخدم مسارات مطلقة أو Path.Combine مع AppDomain.CurrentDomain.BaseDirectory.
  • الاعتمادات مفقودة: تحقق من أن إصدار حزمة NuGet يطابق بيئة التشغيل (.NET Framework مقابل .NET Core).
  • أخطاء الترخيص: تأكد من أن ملف .lic قابل للوصول والمسار مضبوط بشكل صحيح في ConversionConfig.

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

س: هل يمكنني تحويل ملف DGN محمي بكلمة مرور؟
ج: نعم. مرّر كلمة المرور إلى مُنشئ Converter: new Converter("file.dgn", config, "password").

س: هل يحافظ التحويل على معلومات الطبقات؟
ج: تحتفظ GroupDocs.Conversion بطبقات المتجهات كمجموعات PSD منفصلة، مما يسمح بالمعالجة اللاحقة في Photoshop.

س: هل يمكن تحويل عدة ملفات DGN دفعة واحدة؟
ج: بالتأكيد. قم بالتكرار عبر دليل، أنشئ Converter لكل ملف، وأعد استخدام نفس ConversionConfig.

س: ما هي متطلبات النظام للأداء المثالي؟
ج: يُنصح بمعالج CPU ≥ 2.4 GHz، 8 GB RAM، وتخزين SSD للملفات التي تقل عن 500 صفحة.

س: كيف أسجل أخطاء التحويل للمراقبة؟
ج: اشترك في حدث Converter.OnError واكتب التفاصيل إلى إطار التسجيل المفضل لديك.

الخاتمة

أنت الآن تمتلك حلاً كاملاً وجاهزًا للإنتاج لتحويل رسومات DGN إلى ملفات PSD باستخدام groupdocs conversion .net. دعم الصيغ الواسع للـ API، الدقة العالية، وإمكانيات البث تجعلها مثالية لكل من الأدوات الصغيرة وخطوط الأنابيب المؤسسية على نطاق واسع. استكشف صيغًا إضافية، عدّل خيارات التحويل، ودمج هذا سير العمل في خدمات .NET الحالية لديك لفتح إمكانيات جديدة.

آخر تحديث: 2026-06-10
تم الاختبار مع: GroupDocs.Conversion 25.3.0 for .NET
المؤلف: GroupDocs

الموارد

Install-Package GroupDocs.Conversion -Version 25.3.0

dotnet add package GroupDocs.Conversion --version 25.3.0

using System;
using GroupDocs.Conversion;

namespace DgnToPsdConversion
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize the Converter object with your source file path
            using (Converter converter = new Converter("path_to_your_dgn_file.dgn"))
            {
                // Conversion logic will be implemented here
            }
        }
    }
}

string outputFolder = @"YOUR_OUTPUT_DIRECTORY/";
string outputFileTemplate = Path.Combine(outputFolder, "converted-page-{0}.psd");

Func<SavePageContext, Stream> getPageStream = savePageContext => 
    new FileStream(string.Format(outputFileTemplate, savePageContext.Page), FileMode.Create);

using (Converter converter = new Converter(@"YOUR_DOCUMENT_DIRECTORY\sample.dgn"))
{
    // Set up conversion options for PSD format
    ImageConvertOptions options = new ImageConvertOptions { Format = GroupDocs.Conversion.FileTypes.ImageFileType.Psd };
    
    // Perform the conversion using the defined stream handler
    converter.Convert(getPageStream, options);
}

دروس ذات صلة