Skip to content

_index.md

Latest commit

 

History

History
146 lines (116 loc) · 9.57 KB

_index.md

File metadata and controls

146 lines (116 loc) · 9.57 KB
date 2026-01-10
description تعلم كيفية تحويل ملفات Word إلى صورة مع طبقة نصية في Java باستخدام GroupDocs.Viewer، واستخراج طبقة النص للحصول على صور مستندات قابلة للبحث وعالية الوضوح.
keywords
convert word to image
extract text overlay
render pdf with text
improve document image clarity
configure view options
generate searchable images
title تحويل ملف Word إلى صورة مع طبقة نصية في Java
type docs
url /ar/java/advanced-rendering/render-documents-to-images-with-text-layer-java/
weight 1

تحويل Word إلى صورة مع طبقة نص في Java باستخدام GroupDocs.Viewer

هل تحتاج إلى convert Word to image مع الحفاظ على إمكانية اختيار النص والبحث فيه؟ عادةً ما يؤدي تحويل DOCX إلى صورة إلى فقدان النص الأساسي، مما يجعل البحث والنسخ‑اللصق مستحيلين. في هذا البرنامج التعليمي سنوضح لك كيفية تحويل مستند Word إلى صور PNG مع طبقة نص مرفقة باستخدام GroupDocs.Viewer for Java. لا يقتصر هذا النهج على تحسين وضوح صورة المستند فحسب، بل ينتج صورًا قابلة للبحث تعمل بشكل مثالي في بوابات الويب وحلول CMS.

عرض المستندات كصور مع طبقة نص باستخدام GroupDocs.Viewer for Java

إجابات سريعة

  • ماذا يعني “convert Word to image”؟ إنه ينشئ صورة نقطية (PNG) لكل صفحة مع الحفاظ على النص الأصلي في طبقة مخفية.
  • لماذا إضافة طبقة نص؟ تجعل الطبقة المرفقة الصورة قابلة للبحث والاختيار، مما يعزز إمكانية الوصول وتحسين محركات البحث.
  • أي مكتبة تتعامل مع هذا؟ GroupDocs.Viewer for Java توفر دعمًا مدمجًا لاستخراج النص وعرض الصور.
  • هل أحتاج إلى ترخيص؟ الإصدار التجريبي المجاني يعمل للتطوير؛ يتطلب الترخيص المدفوع للإنتاج.
  • هل يمكنني استخدام نفس الكود لملفات PDF؟ نعم – تنطبق نفس خيارات العرض على PDF و DOCX والعديد من الصيغ الأخرى.

ما هو “convert Word to image” مع طبقة نص؟

تحويل ملف Word إلى صورة ينتج عادةً صورة نقطية تحتوي فقط على بكسلات. من خلال تمكين extract text overlay، يضيف GroupDocs.Viewer طبقة نص غير مرئية فوق كل صورة، مما يسمح للمتصفحات ومحركات البحث بقراءة المحتوى.

لماذا نستخدم GroupDocs.Viewer لهذه المهمة؟

  • إخراج PNG عالي الجودة الذي يحافظ على التخطيط الأصلي.
  • استخراج طبقة النص تلقائيًا، بحيث تحصل على صور قابلة للبحث دون معالجة إضافية.
  • API بسيط – بضع أسطر من كود Java تدير كامل العملية.
  • دعم صيغ واسع – يعمل نفس النهج مع PDFs و PPTX والمزيد.

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

  • Java Development Kit (JDK) مثبت ومُكوَّن.
  • Maven لإدارة التبعيات.
  • إلمام أساسي بمعالجة ملفات Java ومشاريع Maven.

إعداد GroupDocs.Viewer للـ Java

معلومات التثبيت

Add GroupDocs.Viewer to your Maven project by inserting the repository and dependency into your pom.xml:

<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>

الحصول على الترخيص

ابدأ بتجربة مجانية عن طريق تنزيل GroupDocs.Viewer من صفحة التحميل. للاستخدام في الإنتاج، اشترِ ترخيصًا أو احصل على مفتاح مؤقت من صفحة الترخيص المؤقت.

التهيئة الأساسية والإعداد

بعد مزامنة Maven، يمكنك إنشاء كائن Viewer – هذا الكائن سيتولى عملية العرض.

دليل خطوة بخطوة لتحويل Word إلى صورة

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

أولاً، أخبر الـ Viewer أين يخزن ملفات PNG المُولدة. الكود أدناه ينشئ (أو يعيد استخدام) مجلدًا يُسمى YOUR_OUTPUT_DIRECTORY.

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");

نصيحة احترافية: استخدم Files.createDirectories(outputDirectory); إذا كنت تريد إنشاء المجلد تلقائيًا.

الخطوة 2: تكوين خيارات العرض (Configure View Options)

بعد ذلك، قم بإعداد خيارات العرض. باستخدام PngViewOptions وتفعيل setExtractText(true)، تُخبر GroupDocs.Viewer بـ extract text overlay وتضمينه في كل صورة.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.png");
PngViewOptions viewOptions = new PngViewOptions(pageFilePathFormat);
viewOptions.setExtractText(true);  // Enable extracting text over the image

الخطوة 3: عرض المستند (Convert Word to Image)

أخيرًا، افتح ملف DOCX المصدر واستدعِ viewer.view(viewOptions). يضمن كتلة try‑with‑resources إغلاق كائن Viewer بشكل صحيح.

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    viewer.view(viewOptions);  // Perform rendering operation
}

عند انتهاء الكود، يظهر كل صفحة من مستند Word كصورة PNG عالية الدقة مع طبقة نص غير مرئية، جاهزة للفهرسة والبحث.

نصائح استكشاف الأخطاء وإصلاحها

  • File Not Found: تحقق مرة أخرى من المسار إلى SAMPLE_DOCX. استخدم مسارات مطلقة للتأكد.
  • Permission Issues: تأكد من أن عملية Java يمكنها الكتابة إلى YOUR_OUTPUT_DIRECTORY.
  • Version Mismatch: تحقق من أن الإصدار في pom.xml يطابق المكتبة التي قمت بتنزيلها.

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

  1. Web Portals: عرض معاينات المستندات التي يمكن للمستخدمين البحث فيها دون تنزيل الملف الأصلي.
  2. Content Management Systems: تخزين لقطات صور قابلة للبحث لأغراض الأرشفة.
  3. Document Archiving: الاحتفاظ بإصدار صورة خفيف الوزن مع تمكين البحث النصي الكامل.

اعتبارات الأداء

  • تخلص من كائنات Viewer بسرعة (كما هو موضح باستخدام try‑with‑resources).
  • اختر PNG للجودة؛ انتقل إلى JPEG إذا كان عرض النطاق الترددي مصدر قلق.
  • قم بتخزين الصفحات المعروضة مؤقتًا عندما يُطلب نفس المستند بشكل متكرر.

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

س: كيف يمكنني التعامل مع المستندات الكبيرة؟
ج: قم بعرض الصفحات تدريجيًا وأطلق سراح كل كائن Viewer بعد معالجة دفعة للحفاظ على انخفاض استهلاك الذاكرة.

س: هل يمكنني عرض ملفات PDF بنفس النهج؟
ج: نعم، يدعم GroupDocs.Viewer ملفات PDF وعلمية setExtractText(true) نفسها ستولد صور PDF قابلة للبحث.

س: ماذا لو لم تكن طبقة النص مرئية في النتيجة؟
ج: تأكد من ضبط viewOptions.setExtractText(true) وأن مجلد الإخراج لديه أذونات كتابة.

س: هل تدعم صيغ صور أخرى؟
ج: بجانب PNG، يمكنك استخدام JpgViewOptions أو BmpViewOptions عن طريق استبدال فئة خيار العرض.

س: أين يمكنني العثور على توثيق API أكثر تفصيلاً؟
ج: الوثائق الرسمية تقدم أمثلة شاملة وتفاصيل التكوين.

الموارد

آخر تحديث: 2026-01-10
تم الاختبار مع: GroupDocs.Viewer 25.2 للـ Java
المؤلف: GroupDocs