groupdocs viewer dwg – كيفية عرض رسومات CAD المحددة في Java باستخدام GroupDocs.Viewer

عرض تخطيطات محددة من ملف DWG هو طلب شائع عندما تحتاج إلى التركيز على عرض تصميم واحد، أو إنشاء معاينات HTML خفيفة الوزن، أو تضمين طبقة رسم معينة في صفحة ويب. في هذا البرنامج التعليمي ستكتشف كيف يجعل GroupDocs.Viewer for Java عملية عرض تخطيط مختار سهلة، وتحويل CAD إلى HTML، واستخراج تخطيط DWG ببضع أسطر من الشيفرة فقط.

عرض رسومات CAD المحددة باستخدام GroupDocs.Viewer for Java

إجابات سريعة

  • أي مكتبة تقوم بتحويل DWG إلى HTML؟ GroupDocs.Viewer for Java.
  • هل يمكنني عرض تخطيط واحد فقط من DWG؟ نعم – حدد اسم التخطيط في HtmlViewOptions.
  • هل أحتاج إلى ترخيص للتطوير؟ نسخة تجريبية مجانية تعمل للاختبار؛ يلزم ترخيص دائم للإنتاج.
  • ما إصدار Java المطلوب؟ JDK 8 أو أحدث.
  • هل استهلاك الذاكرة يمثل مشكلة مع ملفات CAD الكبيرة؟ استخدم خيارات البث وأغلق كائن Viewer فورًا.

ما هو groupdocs viewer dwg؟

GroupDocs.Viewer هي مكتبة Java تقوم بتحويل أكثر من 50 تنسيق مستند وCAD — بما في ذلك DWG — إلى تمثيلات صديقة للويب مثل HTML، PNG، أو JPEG. تقوم بمعالجة الملفات دون الحاجة إلى برنامج CAD أصلي، وتوفر عرضًا ثابتًا عبر المنصات.

لماذا تستخدم GroupDocs.Viewer لعرض DWG؟

يدعم GroupDocs.Viewer أكثر من 50 تنسيق CAD ويمكنه عرض رسومات مئات الصفحات مع الحفاظ على استهلاك الذاكرة أقل من 200 ميغابايت عن طريق بث الصفحات عند الطلب. يتيح استخراج التخطيط المدمج عزل عرض واحد، مما يقلل زمن تحميل الصفحة بنسبة تصل إلى 70 % مقارنةً بعرض الرسم بالكامل.

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

  • GroupDocs.Viewer for Java ≥ 25.2.
  • Maven لإدارة التبعيات.
  • JDK 8+ مثبت محليًا.
  • إلمام أساسي ببنية ملف DWG (التخطيطات، مساحة النموذج، مساحة الورق).

كيفية عرض تخطيط محدد من ملف DWG؟

قم بتحميل ملف DWG المطلوب، اضبط خيارات عرض HTML، وحدد التخطيط الذي تريد إخراجه. من خلال تعيين اسم التخطيط في HtmlViewOptions، يقوم العارض باستخراج ذلك العرض فقط وتوليد ملفات HTML المقابلة. يبسط هذا النهج إنشاء المعاينات ويقلل من زمن المعالجة، ويتكون سير العمل بالكامل من ثلاث خطوات مختصرة.

الخطوة 1: تحديد دليل الإخراج

أنشئ مجلدًا حيث سيتم حفظ ملفات HTML المولدة.

المساعد Utils ينشئ مجلد إخراج مستقل عن النظام للملفات المعروضة.

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

شرح: Utils.getOutputDirectoryPath يبني مسارًا مستقلًا عن النظام وينشئ المجلد إذا لم يكن موجودًا.

الخطوة 2: إعداد تسمية للصفحات المعروضة

حدد نمط تسمية يتضمن عنصرًا نائبًا لرقم الصفحة.

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

شرح: يتم استبدال {0} برقم الفهرس للصفحة، مما يتيح لك عرض تخطيطات متعددة دون تصادم أسماء الملفات.

الخطوة 3: تكوين HtmlViewOptions

أخبر العارض بدمج الموارد واستهداف تخطيط واحد.

HtmlViewOptions يحدد كيفية توليد ملف HTML الناتج، بما في ذلك دمج الموارد واختيار التخطيط.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

شرح: forEmbeddedResources يدمج الصور وCSS مباشرةً داخل HTML، منتجًا ملفًا محمولًا واحدًا لكل تخطيط.

الخطوة 4: اختيار التخطيط الذي تريد عرضه

قدّم اسم التخطيط الدقيق كما يظهر داخل ملف DWG.

خاصية layoutName تحدد أي تخطيط رسم يجب على العارض عرضه.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

شرح: تعيين layoutName إلى "Model" (أو أي تخطيط مخصص) يوجه GroupDocs.Viewer لتجاهل جميع العروض الأخرى.

الخطوة 5: عرض التخطيط وتنظيف الموارد

افتح العارض داخل كتلة try‑with‑resources، استدعِ view، ودع Java يغلق الكائن تلقائيًا.

الفئة Viewer هي نقطة الدخول الرئيسية لعرض المستندات باستخدام GroupDocs.Viewer.

viewOptions.getCadOptions().setLayoutName("Model");

شرح: استدعاء view يبث التخطيط المحدد إلى ملفات HTML في مجلد الإخراج؛ يتم التخلص من العارض فورًا بعد العرض.

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

  • التخطيط غير موجود – تحقق من اسم التخطيط بفتح DWG في محرر CAD؛ يجب أن يتطابق الإملاء والحالة تمامًا.
  • أخطاء نفاد الذاكرة – فعّل Viewer.setMemoryLimit أو عالج الملف على أجزاء أصغر.
  • الصور مفقودة – تأكد من ضبط forEmbeddedResources؛ وإلا قد تُولد ملفات صور خارجية بشكل منفصل.

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

س: ما هو GroupDocs.Viewer for Java؟
ج: هي مكتبة من جانب الخادم تقوم بتحويل أكثر من 50 تنسيق مستند وCAD — بما في ذلك DWG — إلى HTML أو PNG أو JPEG دون الحاجة إلى تثبيت Office أو برنامج CAD.

س: كيف أحصل على ترخيص مؤقت لـ GroupDocs.Viewer؟
ج: زر صفحة شراء GroupDocs واطلب ترخيصًا مؤقتًا مجانيًا للتطوير والاختبار.

س: هل يمكن لـ GroupDocs.Viewer معالجة ملفات DWG الكبيرة جدًا بكفاءة؟
ج: نعم، يبث الصفحات ويمكنه عرض رسومات مئات الصفحات مع الحفاظ على استهلاك الذاكرة أقل من 200 ميغابايت، بشرط إغلاق كائن Viewer بعد كل عملية.

س: هل يمكن تحويل تخطيط DWG مباشرة إلى PDF بدلاً من HTML؟
ج: بالتأكيد – استبدل HtmlViewOptions بـ PdfViewOptions وحدد نفس اسم التخطيط للحصول على مخرجات PDF.

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

التطبيقات العملية

  1. العروض المعمارية – عرض تخطيط المخطط الأرضي فقط المطلوب لاجتماع العميل.
  2. مراجعات التصنيع – عزل عرض مكوّن لمناقشة التحملات دون تحميل التجميع الكامل.
  3. وحدات التعلم الإلكتروني – تضمين عرض CAD واحد في درس ويب لتوضيح التعليم.
  4. تكامل إدارة المستندات – استخراج معاينات خاصة بالتخطيط تلقائيًا عند رفع ملفات DWG إلى مستودع المحتوى.
  5. تقارير مخصصة – توليد تقارير HTML تركز على عرض رسم واحد، مما يقلل حجم الملف وزمن التحميل.

نصائح الأداء

  • إعادة استخدام كائن Viewer لعدة ملفات عندما يكون ذلك ممكنًا؛ فهو يخزن الموارد الداخلية في الذاكرة ويسرّع عمليات العرض اللاحقة.
  • تمكين البث عن طريق استدعاء Viewer.setRenderMode(RenderMode.Stream) للحفاظ على استهلاك الذاكرة منخفضًا.
  • ضغط HTML الناتج باستخدام gzip على خادم الويب لتحسين أوقات التحميل من جانب العميل.

الخلاصة

أصبح لديك الآن نهج كامل وجاهز للإنتاج لعرض تخطيط محدد من ملف DWG باستخدام GroupDocs.Viewer for Java. من خلال استهداف تخطيط واحد، تقلل زمن العرض، وتخفض استهلاك الذاكرة، وتنتج HTML نظيف يمكن تضمينه في أي مكان — من بوابات الويب إلى لوحات التحكم الداخلية.

الخطوات التالية

  • جرّب عرض أسماء تخطيطات مختلفة مثل "Top View" أو "Section A" لترى كيف يتغير الناتج.
  • استكشف PdfViewOptions إذا كنت بحاجة إلى نسخة PDF من نفس التخطيط.
  • دمج هذه التقنية مع GroupDocs.Annotation لإضافة علامات مائية أو تعليقات إلى HTML المعروض.

آخر تحديث: 2026-06-20
تم الاختبار مع: GroupDocs.Viewer for Java 25.2
المؤلف: GroupDocs

الموارد

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_DWG_WITH_LAYOUTS_AND_LAYERS)) {
    viewer.view(viewOptions);
}

الدروس ذات الصلة