Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion ocr/arabic/net/ocr-configuration/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,10 @@ weight: 24
استفد من قدرات OCR القوية مع Aspose.OCR for .NET. استخراج النص من الصور بسلاسة.
### [OCROperation مع القائمة في التعرف على الصور باستخدام OCR](./ocr-operation-with-list/)
اكتشف إمكانات Aspose.OCR for .NET. تنفيذ التعرف على الصور باستخدام OCR مع القوائم بسهولة. عزّز الإنتاجية واستخراج البيانات في تطبيقاتك.
### [كيفية استخدام OcrEngine في C# – دليل OCR كامل](./how-to-use-ocrengine-in-c-complete-ocr-guide/)
دليل شامل يشرح كيفية استخدام OcrEngine في C# لإجراء التعرف الضوئي على الأحرف باستخدام Aspose.OCR.
### [إنشاء PDF قابل للبحث من صورة – دليل خطوة بخطوة كامل](./create-searchable-pdf-from-an-image-full-step-by-step-guide/)
دليل شامل لإنشاء ملف PDF قابل للبحث من صورة باستخدام Aspose.OCR خطوة بخطوة.

### حالات الاستخدام الشائعة
- **استخراج نصوص الصور** من الفواتير الممسوحة لأتمتة المحاسبة.
Expand Down Expand Up @@ -102,4 +106,4 @@ weight: 24
{{< /blocks/products/pf/main-container >}}
{{< /blocks/products/pf/main-wrap-class >}}

{{< blocks/products/products-backtop-button >}}
{{< blocks/products/products-backtop-button >}}
Original file line number Diff line number Diff line change
@@ -0,0 +1,244 @@
---
category: general
date: 2026-06-06
description: تعلم كيفية إنشاء ملف PDF قابل للبحث وتحويل الصورة إلى PDF باستخدام OCR.
يتضمن إضافة طبقة، إعدادات الضغط، وكود C# كامل.
draft: false
keywords:
- create searchable pdf
- convert image to pdf
- how to ocr image
- how to add layer
- how to set compression
language: ar
og_description: إنشاء ملف PDF قابل للبحث من صورة باستخدام تقنية OCR. يوضح هذا الدليل
كيفية إضافة طبقة نص مخفية، وضبط الضغط، وتحويل الصورة إلى PDF.
og_title: إنشاء ملف PDF قابل للبحث – دورة شاملة في C#
schemas:
- author: Aspose
dateModified: '2026-06-06'
description: Learn how to create searchable PDF and convert image to PDF with OCR.
Includes layer addition, compression settings, and full C# code.
headline: Create Searchable PDF from an Image – Full Step‑by‑Step Guide
type: TechArticle
- description: Learn how to create searchable PDF and convert image to PDF with OCR.
Includes layer addition, compression settings, and full C# code.
name: Create Searchable PDF from an Image – Full Step‑by‑Step Guide
steps:
- name: Prerequisites
text: '- .NET 6.0 or later (the code also works on .NET Framework 4.7+). - The
Aspose.OCR and Aspose.Pdf NuGet packages (or any equivalent library that offers
`OcrEngine` and `PdfSaveOptions`). - A sample image, e.g., `invoice.png`, placed
in a folder you can reference. - A basic understanding of C# syntax'
- name: Full Working Example
text: 'Putting it all together, here’s the complete, ready‑to‑run program:'
- name: Pro tip
text: If you need to **convert image to PDF** without OCR (just a plain image
PDF), set `AddTextLayer = false`. The same `PdfSaveOptions` still lets you control
compression, which is handy for archiving scanned documents that don’t need
searchability.
type: HowTo
tags:
- OCR
- PDF
- C#
- Aspose
title: إنشاء ملف PDF قابل للبحث من صورة – دليل خطوة بخطوة كامل
url: /ar/net/ocr-configuration/create-searchable-pdf-from-an-image-full-step-by-step-guide/
---

{{< blocks/products/pf/main-wrap-class >}}
{{< blocks/products/pf/main-container >}}
{{< blocks/products/pf/tutorial-page-section >}}

# إنشاء PDF قابل للبحث – دليل C# كامل

هل تساءلت يومًا كيف **create searchable PDF** من فاتورة ممسوحة ضوئيًا دون قضاء ساعات في أداة رسومية؟ لست وحدك. يواجه العديد من المطورين صعوبة عندما يحتاجون إلى تحويل صورة إلى PDF يبدو كالأصل ويسمح للمستخدمين بنسخ النص أو البحث فيه.

في هذا الدرس سنستعرض الخطوات الدقيقة **convert image to PDF**، تشغيل OCR عليها، إضافة طبقة نص مخفية، وحتى تعديل إعدادات الضغط. في النهاية ستحصل على مقتطف C# جاهز يمكنك إدراجه في أي مشروع .NET.

## ما ستتعلمه

- إعداد محرك OCR وفهم **how to OCR image** للملفات.
- استخدام خيارات **how to add layer** لإدراج طبقة نص قابلة للبحث.
- تطبيق **how to set compression** للحصول على ملفات PDF مضغوطة.
- تحويل صورة عادية إلى سير عمل **create searchable pdf** يمكنك أتمتته.
- الأخطاء الشائعة ونصائح احترافية للحفاظ على جودة وسرعة ملفات PDF.

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

- .NET 6.0 أو أحدث (الكود يعمل أيضًا على .NET Framework 4.7+).
- حزم NuGet Aspose.OCR و Aspose.Pdf (أو أي مكتبة مكافئة توفر `OcrEngine` و `PdfSaveOptions`).
- صورة نموذجية، مثل `invoice.png`، موجودة في مجلد يمكنك الإشارة إليه.
- فهم أساسي لصياغة C#—ليس هناك حاجة لمعرفة عميقة بـ OCR.

> **نصيحة احترافية:** إذا كنت تستخدم Visual Studio، قم بتثبيت الحزم عبر Package Manager Console:
> `Install-Package Aspose.OCR`
> `Install-Package Aspose.Pdf`

---

![Create searchable PDF example showing an invoice image turned into a PDF with hidden text layer](/images/create-searchable-pdf.png)

## الخطوة 1: تهيئة محرك OCR – **how to ocr image**

أولاً نحتاج إلى محرك OCR يستطيع قراءة النص الإنجليزي من صورتنا. فئة `OcrEngine` هي نقطة الدخول؛ ببساطة تحدد اللغة ثم تُمرّر لها الصورة لاحقًا.

```csharp
using Aspose.OCR;
using Aspose.Pdf;

// Create and configure the OCR engine
OcrEngine engine = new OcrEngine
{
Language = OcrLanguage.English
};
```

*لماذا هذا مهم:* تهيئة المحرك باللغة الصحيحة تحسن الدقة بشكل كبير. إذا تخطيت هذه الخطوة، قد تحصل على أحرف مشوشة.

## الخطوة 2: تحميل الصورة – **convert image to pdf**

الآن نوجه المحرك إلى الملف الذي نريد معالجته. `ImageStream.FromFile` يقرأ البايتات ويجهزها لـ OCR.

```csharp
// Load the image you want to turn into a searchable PDF
engine.Image = ImageStream.FromFile(@"C:\Docs\invoice.png");
```

يمكنك أيضًا التحميل من `MemoryStream` إذا كانت الصورة تأتي من طلب ويب أو قاعدة بيانات.

## الخطوة 3: تشغيل التعرف الضوئي – **how to ocr image**

مع تحميل الصورة، يتم تنفيذ العملية الثقيلة في نداء واحد. طريقة `Recognize` تُعيد كائن `OcrResult` يحتوي على النص المستخرج والبيتماب الأصلي.

```csharp
// Perform OCR on the loaded image
OcrResult ocrResult = engine.Recognize();
```

*خلف الكواليس:* المحرك يحلل كل بكسل، يكتشف الأحرف، ويُنشئ سلسلة Unicode. كما يحتفظ ببيانات الموقع اللازمة لإنشاء طبقة النص المخفية لاحقًا.

## الخطوة 4: ضبط خيارات حفظ PDF – **how to add layer** & **how to set compression**

هنا يحدث سحر PDF القابل للبحث. ننشئ كائن `PdfSaveOptions` يخبر Aspose.Pdf كيف يدمج الصورة الأصلية، يضيف طبقة نص مخفية، ويضغط الملف النهائي.

```csharp
// Set up PDF options for a searchable PDF
PdfSaveOptions pdfOptions = new PdfSaveOptions
{
IncludeImage = true, // Keep the original image in the PDF
AddTextLayer = true, // Add a hidden text layer with OCR results
Compression = PdfCompression.Zip // Use ZIP compression for smaller size
};
```

- **IncludeImage** يضمن الحفاظ على المظهر البصري للمسح الأصلي.
- **AddTextLayer** ينشئ طبقة غير مرئية يمكن للمتصفحات وقارئات PDF فهرستها للبحث.
- **Compression** يقلل حجم الملف دون التضحية بالجودة؛ ZIP هو الإعداد الافتراضي المناسب لمعظم المستندات.

## الخطوة 5: حفظ النتيجة – **create searchable pdf**

أخيرًا، نكتب نتيجة OCR إلى القرص باستخدام الخيارات التي عرّفناها. طريقة `Save` تستقبل مسار الهدف وكائن `PdfSaveOptions`.

```csharp
// Save the OCR result as a searchable PDF
ocrResult.Save(@"C:\Docs\invoice_searchable.pdf", pdfOptions);
```

عند فتح `invoice_searchable.pdf` في Adobe Reader أو أي عارض حديث، ستظهر الصورة الأصلية، لكن الآن يمكنك تحديد النص، نسخه، والبحث فيه كما لو كان PDF أصليًا.

### مثال كامل يعمل

نجمع كل ما سبق في البرنامج الكامل الجاهز للتنفيذ:

```csharp
using System;
using Aspose.OCR;
using Aspose.Pdf;

namespace SearchablePdfDemo
{
class Program
{
static void Main(string[] args)
{
// 1️⃣ Initialize OCR engine
OcrEngine engine = new OcrEngine
{
Language = OcrLanguage.English
};

// 2️⃣ Load the source image
string imagePath = @"C:\Docs\invoice.png";
engine.Image = ImageStream.FromFile(imagePath);

// 3️⃣ Perform OCR
OcrResult result = engine.Recognize();

// 4️⃣ Configure PDF options (layer + compression)
PdfSaveOptions pdfOptions = new PdfSaveOptions
{
IncludeImage = true,
AddTextLayer = true,
Compression = PdfCompression.Zip
};

// 5️⃣ Save as searchable PDF
string pdfPath = @"C:\Docs\invoice_searchable.pdf";
result.Save(pdfPath, pdfOptions);

Console.WriteLine($"Searchable PDF created at: {pdfPath}");
}
}
}
```

**الناتج المتوقع** (في وحدة التحكم):
`Searchable PDF created at: C:\Docs\invoice_searchable.pdf`

افتح الملف الناتج، اضغط **Ctrl F**، اكتب كلمة موجودة في الفاتورة، وستلاحظ القفز الفوري إلى الموضع. هذا هو جوهر **create searchable pdf** عمليًا.

## الأخطاء الشائعة وكيفية تجنّبها

| المشكلة | السبب | الحل |
|-------|----------------|-----|
| النص غير قابل للبحث | `AddTextLayer` مُعطَّل أو استخدام نسخة قديمة من Aspose | تأكد من `AddTextLayer = true` وحدث إلى أحدث حزمة NuGet |
| حجم PDF كبير (ميغابايت) | الضغط مضبوط على `PdfCompression.None` | غيّر إلى `PdfCompression.Zip` أو `PdfCompression.Jpeg` للصور |
| أحرف مشوشة | لغة خاطئة أو صورة منخفضة الدقة | اضبط `engine.Language` بشكل مناسب وقدم صورًا بدقة لا تقل عن 300 dpi |
| الطبقة المخفية غير مرئية في بعض العارضات | تم إنشاء PDF بإصدار غير قياسي | استخدم `PdfSaveOptions.PdfVersion = PdfVersion.PDF_1_7` (الإعداد الافتراضي) أو حدّث العارض |

### نصيحة احترافية

إذا كنت تحتاج فقط **convert image to PDF** بدون OCR (PDF صورة فقط)، عيّن `AddTextLayer = false`. لا يزال بإمكانك التحكم في الضغط عبر `PdfSaveOptions`، وهو مفيد لأرشفة المستندات الممسوحة التي لا تحتاج إلى قابلية البحث.

## توسيع الحل

- **صفحات متعددة**: كرّر عبر قائمة ملفات الصور، عيّن `engine.Image = ...` في كل مرة، واجمع النتائج في PDF واحد باستخدام تجميع `PdfDocument`.
- **لغات مختلفة**: غيّر `engine.Language = OcrLanguage.Spanish` (أو أي لغة مدعومة) لمعالجة فواتير متعددة اللغات.
- **ضغط مخصص**: للصور الغنية بالألوان، استخدم `PdfCompression.Jpeg` مع ضبط الجودة (`pdfOptions.JpegQuality = 80`) لتقليل الحجم أكثر.

## الخلاصة

غطّينا كل ما تحتاجه لإنشاء ملفات **create searchable PDF** من الصور باستخدام C#. من تهيئة محرك OCR، تحميل الصورة، تنفيذ التعرف، ضبط طبقة النص المخفية، إلى ضبط الضغط—كل خطوة تلعب دورًا أساسيًا في تقديم مستند سريع وقابل للبحث.

الآن يمكنك أتمتة معالجة الفواتير، أرشفة العقود، أو بناء أداة مسح جماعية تحول أكوام الورق إلى PDFs قابلة للبحث فورًا.

هل أنت مستعد للتحدي التالي؟ جرّب إضافة علامات مائية، دمج عدة PDFs قابلة للبحث، أو إتاحة هذه المنطق عبر Web API حتى يتمكن فريقك من رفع الصور والحصول على PDFs قابلة للبحث مباشرة.

---

*إذا وجدت هذا الدليل مفيدًا، أعطه ⭐، شاركه مع زملائك، أو اترك تعليقًا بتعديلاتك الخاصة. برمجة سعيدة!*

## ماذا تتعلم بعد ذلك؟

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

- [How to OCR PDF in .NET with Aspose.OCR](/ocr/english/net/text-recognition/recognize-pdf/)
- [Convert Images to PDF C# – Save Multipage OCR Result](/ocr/english/net/ocr-optimization/save-multipage-result-as-document/)
- [How to OCR Image – Perform OCR on Image in OCR Image Recognition](/ocr/english/net/image-and-drawing-recognition/perform-ocr-on-image/)

{{< /blocks/products/pf/tutorial-page-section >}}
{{< /blocks/products/pf/main-container >}}
{{< /blocks/products/pf/main-wrap-class >}}
{{< blocks/products/products-backtop-button >}}
Loading