معلومات الصورة في ملف PDF

مقدمة

أصبحت ملفات PDF موجودة في كل مكان هذه الأيام، حيث تجد كل وثيقة مهنية وشخصية تقريبًا طريقها إلى هذا التنسيق في مرحلة ما. سواء كان تقريرًا أو كتيبًا أو كتابًا إلكترونيًا، فإن فهم كيفية التعامل مع هذه الملفات برمجيًا يوفر عددًا لا يحصى من الاحتمالات. أحد المتطلبات الشائعة هو استخراج معلومات الصور من ملفات PDF. في هذا الدليل، سنتعمق في كيفية استخدام مكتبة Aspose.PDF لـ .NET لاستخراج تفاصيل مهمة حول الصور المضمنة في مستند PDF.

المتطلبات الأساسية

قبل أن ننتقل إلى التفاصيل الدقيقة للترميز، هناك بعض المتطلبات الأساسية التي ستحتاج إلى توافرها:

  1. بيئة التطوير: ستحتاج إلى إعداد بيئة تطوير .NET. قد تكون هذه البيئة عبارة عن Visual Studio أو أي بيئة تطوير متكاملة أخرى متوافقة مع .NET.
  2. مكتبة Aspose.PDF: تأكد من أن لديك إمكانية الوصول إلى مكتبة Aspose.PDF. يمكنك تنزيلها منموقع اسبوس.
  3. المعرفة الأساسية بلغة C#: ستساعدك المعرفة بلغة C# ومفاهيم البرمجة الموجهة للكائنات على متابعة البرنامج التعليمي بسهولة.
  4. مستند PDF: احتفظ بمستند PDF نموذجي في متناول يدك يحتوي على صور لاختبار الكود الخاص بك.

استيراد الحزم

للبدء في استخدام مكتبة Aspose.PDF، ستحتاج إلى استيراد المساحات الأساسية اللازمة إلى ملف C# الخاص بك. فيما يلي شرح سريع:

using System.IO;
using Aspose.Pdf;
using System;

ستوفر لك هذه المساحات الاسمية إمكانية الوصول إلى الفئات والطرق المطلوبة للتعامل مع ملفات PDF واستخراج بيانات الصور.

الآن بعد أن قمت بإعداد كل شيء، حان الوقت لتقسيم ذلك إلى خطوات يمكن إدارتها. سنكتب برنامجًا بلغة C# يقوم بتحميل مستند PDF، ويفحص كل صفحة، ويستخرج أبعاد ودقة كل صورة في المستند.

الخطوة 1: تهيئة المستند

في هذه الخطوة، سنقوم بتهيئة مستند PDF باستخدام المسار إلى ملف PDF الخاص بك. يجب استبدال"YOUR DOCUMENT DIRECTORY" مع المسار الفعلي الذي يقع فيه ملف PDF الخاص بك.

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";
// تحميل ملف PDF المصدر
Document doc = new Document(dataDir + "ImageInformation.pdf");

نحن ننشئDocument الكائن الذي يقوم بتحميل ملف PDF من الدليل المحدد. سيسمح لنا هذا بالعمل مع محتويات الملف.

الخطوة 2: تعيين الدقة الافتراضية وتهيئة هياكل البيانات

بعد ذلك، نقوم بتعيين دقة افتراضية للصور، وهو أمر مفيد للحسابات. وسنقوم أيضًا بإعداد مصفوفة لحمل أسماء الصور ومكدس لإدارة الحالات الرسومية.

// تحديد الدقة الافتراضية للصورة
int defaultResolution = 72;
System.Collections.Stack graphicsState = new System.Collections.Stack();
// قم بتعريف كائن قائمة المصفوفة الذي سيحمل أسماء الصور
System.Collections.ArrayList imageNames = new System.Collections.ArrayList(doc.Pages[1].Resources.Images.Names);

الdefaultResolution يساعدنا المتغير في حساب دقة الصور بشكل صحيح.graphicsStateتُستخدم المكدس كوسيلة لتخزين الحالة الرسومية الحالية للمستند عندما نواجه مشغلي التحويل.

الخطوة 3: معالجة كل عامل على الصفحة

نقوم الآن بتكرار جميع العمليات في الصفحة الأولى من المستند. وهنا يحدث الجزء الأصعب.

foreach (Operator op in doc.Pages[1].Contents)
{
    // مشغلي العملية...
}

كل مشغل في ملف PDF هو أمر يخبر المعالج بكيفية إدارة العناصر الرسومية، بما في ذلك الصور.

الخطوة 4: التعامل مع مشغلي GSave/GRestore

داخل الحلقة، سوف نقوم بالتعامل مع أوامر حفظ الرسومات واستعادتها لتتبع التغييرات التي تم إجراؤها على الحالة الرسومية.

if (opSaveState != null) 
{
    // حفظ الحالة السابقة
    graphicsState.Push(((Matrix)graphicsState.Peek()).Clone());
} 
else if (opRestoreState != null) 
{
    // استعادة الحالة السابقة
    graphicsState.Pop();
}

GSave يحفظ الحالة الرسومية الحالية، بينماGRestore يستعيد الحالة المحفوظة الأخيرة، مما يسمح لنا بعكس أي تحويلات عند معالجة الصور.

الخطوة 5: إدارة مصفوفات التحويل

بعد ذلك، نقوم بالتعامل مع سلسلة مصفوفات التحويل عند تطبيق التحويلات على الصور.

else if (opCtm != null) 
{
    Matrix cm = new Matrix(
        (float)opCtm.Matrix.A,
        (float)opCtm.Matrix.B,
        (float)opCtm.Matrix.C,
        (float)opCtm.Matrix.D,
        (float)opCtm.Matrix.E,
        (float)opCtm.Matrix.F);
    
    ((Matrix)graphicsState.Peek()).Multiply(cm);
    continue;
}

عندما يتم تطبيق مصفوفة التحويل، نقوم بضربها بالمصفوفة الحالية المخزنة في حالة الرسومات حتى نتمكن من متابعة أي تغيير في القياس أو الترجمة يتم تطبيقه على الصورة.

الخطوة 6: استخراج معلومات الصورة

وأخيرًا، نقوم بمعالجة عامل الرسم للصور واستخراج المعلومات الضرورية، مثل الأبعاد والدقة.

else if (opDo != null) 
{
    // عامل التشغيل Do الذي يرسم الكائنات
    if (imageNames.Contains(opDo.Name)) 
    {
        Matrix lastCTM = (Matrix)graphicsState.Peek();
        XImage image = doc.Pages[1].Resources.Images[opDo.Name];
        double scaledWidth = Math.Sqrt(Math.Pow(lastCTM.Elements[0], 2) + Math.Pow(lastCTM.Elements[1], 2));
        double scaledHeight = Math.Sqrt(Math.Pow(lastCTM.Elements[2], 2) + Math.Pow(lastCTM.Elements[3], 2));
        double originalWidth = image.Width;
        double originalHeight = image.Height;
        
        double resHorizontal = originalWidth * defaultResolution / scaledWidth;
        double resVertical = originalHeight * defaultResolution / scaledHeight;
        
        // إخراج المعلومات
        Console.Out.WriteLine(string.Format(dataDir + "image {0} ({1:.##}:{2:.##}): res {3:.##} x {4:.##}",
                         opDo.Name, scaledWidth, scaledHeight, resHorizontal, resVertical));
    }
}

هنا، نتحقق مما إذا كان المشغل مسؤولاً عن رسم صورة. إذا كان الأمر كذلك، نحصل على كائن XImage المقابل، ونحسب أبعاده ودقته، ونطبع المعلومات اللازمة.

خاتمة

تهانينا! لقد قمت للتو بإنشاء مثال عملي لكيفية استخراج معلومات الصورة من ملف PDF باستخدام Aspose.PDF لـ .NET. يمكن أن تكون هذه الإمكانية مفيدة بشكل لا يصدق للمطورين الذين يحتاجون إلى تحليل أو معالجة مستندات PDF لتطبيقات مختلفة، مثل إعداد التقارير أو استخراج البيانات أو حتى عارضات PDF المخصصة.

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

ما هي مكتبة Aspose.PDF؟

تُعد مكتبة Aspose.PDF أداة فعّالة لإنشاء ملفات PDF ومعالجتها وتحويلها في تطبيقات .NET.

هل يمكنني استخدام المكتبة مجانًا؟

نعم، تقدم Aspose نسخة تجريبية مجانية. يمكنك تنزيلهاهنا.

ما هي أنواع تنسيقات الصور التي يمكن استخراجها؟

تدعم المكتبة تنسيقات الصور المختلفة، بما في ذلك JPEG وPNG وTIFF، طالما أنها مضمنة في ملف PDF.

هل يتم استخدام Aspose لأغراض تجارية؟

نعم، يمكنك استخدام منتجات Aspose تجاريًا. للحصول على الترخيص، تفضل بزيارةصفحة الشراء.

كيف أحصل على الدعم لـ Aspose؟

يمكنك الوصول إلى منتدى الدعمهنا.

تحديد الصور في ملف PDF وضع الصور