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

يتم التحقق مما إذا كانت الصورة التي تم اقتصاصها صالحة من حجم البكسل الذي تم فك تشفيره، وليس بايتات PNG كمؤشر للجودة. تستخدم الأمثلة الصفحات غير المدورة، والنقاط لكل بوصة الثابتة، والتقاطعات المستطيلة، مع الرفض الصريح عندما تكون خارج الحدود تمامًا؛ يجب التعامل مع عمليات التدوير والتحويلات الإحداثية الأخرى بشكل منفصل.

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

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

هل تريد فقط عرض منطقة توقيع العقد؟ استنتاج جملة واحدة

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

حالتكالممارسات الموصى بهاسبب
مطلوب منطقة التوقيع فقط، وليس الصفحة بأكملهاقم بتمرير مستطيل clip إلى get_pixmap()يقتصر نطاق التنقيط على المستطيل المحدد لتجنب إنشاء صور نقطية بملء الصفحة.
تأتي إحداثيات منطقة التوقيع من التعرف الضوئي على الحروف (OCR) أو التعليق التوضيحي اليدويقم بتنفيذ clip &= page.rect قبل العرضقد تنحرف الإحداثيات بسبب التدوير أو اختلافات CropBox، ويمكن تصفية المناطق غير الصالحة بعد التقاطع
ضربات التوقيع غير مقروءة عند 96 نقطة في البوصةاستخدم DPI أعلى مثل dpi=300عادةً ما تشغل منطقة التوقيع جزءًا صغيرًا فقط من الصفحة، ويمكن أن تؤدي الدقة المنخفضة إلى التصاق الحدود.
تحتاج إلى تأكيد هوية أو الأثر القانوني للموقعاستخدم آلية التحقق من التوقيع الرقمي بدلاً من تحليل الصورلا يمكن لاستخراج الصور إلا إثبات وجود علامات مرئية في المواقع ولا يمكنه التحقق من خصائص التشفير.

لماذا لا يتم القص مباشرة؟

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

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

لا تكمن الصعوبة الهندسية الحقيقية في "كيفية الاقتصاص"، بل في ثلاثة أشياء: التأكد من أن الصورة التي تم اقتصاصها تحتوي على وحدات بكسل صالحة، وأن الدقة تلبي متطلبات التحقق، والتمييز الصارم بين "صور التوقيع المرئي" و"مصادقة التوقيع القانوني".

مثال على تكوين قائم بذاته

راجع قائمة الاستيراد لمعرفة التبعيات. يقوم الكود ببناء الإدخال في الذاكرة، ويتم توفير سجلات التشغيل بشكل منفصل ولا تمثل ضمانًا لجميع الملفات الحقيقية.

import pymupdf
from io import BytesIO
from PIL import Image
def render(doc, rect):
    page = doc[0]
    clip = pymupdf.Rect(rect) & page.rect
    if clip.is_empty:
        raise ValueError("empty intersection")
    return page.get_pixmap(dpi=72, clip=clip, annots=False).tobytes("png")
with pymupdf.open() as doc:
    doc.new_page(width=200, height=100)
    normal = Image.open(BytesIO(render(doc, (20, 20, 80, 60))))
    edge = Image.open(BytesIO(render(doc, (180, 80, 250, 120))))
    assert normal.size == (60, 40)
    assert edge.size == (20, 20)
    try:
        render(doc, (250, 200, 300, 250))
    except ValueError:
        pass
    else:
        raise AssertionError("outside clip accepted")

مقطع يجب أن يتقاطع المستطيل مع الصفحة، وإلا سيتم إرجاع صورة فارغة

لن يقوم Page.get_pixmap(clip=rect) الخاص بـ PyMuPDF باقتطاع المستطيلات التي تتجاوز حدود الصفحة إلى المناطق القانونية تلقائيًا. إذا كان clip يقع خارج page.rect تمامًا، أو لا يوجد تقاطع بسبب إزاحة النظام الإحداثي، فقد يكون عرض وارتفاع Pixmap الذي تم إرجاعه 0، وسيفشل الحفظ أو التعرف اللاحق بصمت.

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

فحص التقاطع الصحيح

قم بتنفيذ عملية التقاطع بشكل صريح قبل استدعاء العرض: clip &= page.rect. إذا كانت النتيجة مستطيلًا فارغًا، فيجب تسجيل سجل الاستثناءات بدلاً من الاستمرار في العرض. يمنع خط الفحص هذا عددًا كبيرًا من "صور التوقيع الفارغة" من التدفق إلى العمليات النهائية.

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

ملاحظات حول نظام الإحداثيات وCropBox

  • يقع أصل نظام الإحداثيات PDF في الزاوية اليسرى العليا، ويمتد المحور Y إلى الأسفل. على عكس بعض مكتبات معالجة الصور، يعد هذا سببًا شائعًا لفشل المقطع.
  • تقوم page.rect بإرجاع CropBox الحالي. إذا تم اقتصاص المستند، فقد يؤدي استخدام الإحداثيات المطلقة الخارجية مباشرةً إلى حدوث محاذاة غير صحيحة. إذا لزم الأمر، فأنت بحاجة إلى استعادة MediaBox أو إجراء تحويل الإحداثيات أولاً.

تحدد الدقة ما إذا كانت حدود التوقيع مقروءة أم لا.

افتراضيًا، يتم عرض get_pixmap() باستخدام 96 نقطة في البوصة، مما يؤدي إلى إنتاج صورة بحجم 595 × 842 بكسل تقريبًا لصفحة بحجم A4. يبلغ عرض منطقة التوقيع عادةً بضع عشرات من وحدات البكسل فقط، وتكون الحدود عرضة للالتصاق وطمس الحبر، مما يجعلها غير مناسبة للعين البشرية لتأكيد التفاصيل ولا مناسبة للتعرف الضوئي على الحروف لاستخراج نص التوقيع.

هناك طريقتان لزيادة الدقة: تمرير Matrix(zoom_x, zoom_y) أو تحديد dpi=300 مباشرة. يوصى باستخدام الأخير أكثر، لأنه سيتم كتابة قيمة DPI في البيانات التعريفية لملف PNG لتسهيل الأدوات اللاحقة لتفسير الحجم الفعلي بشكل صحيح، في حين أن طريقة Matrix تغير فقط عدد البكسل ولا تسجل الدقة المادية.

الدقة العالية لا تعني التكبير اللانهائي

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

من الناحية العملية، يجب حساب الحجم الفعلي الفعلي للمقطع أولاً استنادًا إلى page.rect وDPI، ومن ثم يجب تعيين DPI حسب الحاجة بدلاً من تعيين قيمة عالية عالميًا. بالنسبة للتوقيعات الإلكترونية البحتة، قد يؤدي ارتفاع DPI جدًا إلى كشف آثار الضغط أو خشونة حافة المتجهات، مما يتداخل مع الحكم البشري. يمكن وضع استراتيجية تصنيف: 150 نقطة لكل بوصة للمعاينة، و300 نقطة لكل بوصة للأرشفة، و600 نقطة لكل بوصة أو أعلى للتحليل الجنائي.

استخراج صورة التوقيع لا يساوي مصادقة التوقيع

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

قد تظهر التوقيعات في ملفات PDF بأشكال مختلفة، بما في ذلك صور JPEG أو PNG المضمنة، أو مسارات متجهة مرسومة لتقليد الكتابة اليدوية، أو المظهر المرئي لتوقيعات الشهادات الرقمية، أو خرائط شفافة مغطاة بالتعليقات التوضيحية. يمكن لـ PyMuPDF تحويل هذه المحتويات إلى وحدات بكسل، لكنه لا يستطيع تمييز المصدر، ناهيك عن التحقق من خصائص التشفير.

إذا كان هدف العمل هو التأكد من قيام شخص ما بتوقيع المستند، فيجب عليك الاعتماد على آلية التحقق من التوقيع الرقمي لـ PDF (مثل لوحة توقيع Adobe Acrobat أو مكتبة PKI مخصصة) بدلاً من تحليل الصور. يعد استخراج الصور مناسبًا فقط لأرشفة أنماط التوقيع، أو المساعدة في المراجعة اليدوية، أو إنشاء صور مصغرة للمعاينة إذا تم التأكد من صحة التوقيع. إن عملية "استخراج صور التوقيع" كأساس للمصادقة بها عيوب خطيرة في الامتثال.

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

📊 المقارنة الأساسية

البند المقارنتمر في Matrixقم بتمرير المعلمة dpi
تأثيرتغيير عدد البكسلتغيير عدد البكسل وتسجيل DPI
الدقة الجسديةلا تسجلاكتب بيانات تعريف PNG
تفسير أداة المتابعةتحتاج إلى تحويل بنفسكيمكن قراءة الأبعاد المادية بشكل صحيح
توصيةسيناريوهات التكبير الخاصةتعطى الأولوية للسيناريوهات العامة
يستخدمنقطة لكل بوصة الموصى بهايوضح
معاينة150يشغل مساحة أقل للعرض السريع
أرشيف300توازن الوضوح والحجم
تحليل الطب الشرعي600 أو أكثريزداد استخدام الذاكرة بشكل مباشر ويجب استخدامها عند الطلب.

معايير القبول وحدود المراجعة اليدوية

مراقبة الظواهرالأسباب المحتملةقرار المعالجةما إذا كانت المراجعة اليدوية مطلوبة
حجم PNG الناتج هو 0×0المقطع ليس له تقاطع مع الصفحةسجل الاستثناء وتخطي هذه الصفحةلا
التوقيع غير واضح ولكن الحجم طبيعيDPI غير كافية أو أن الصورة الأصلية عبارة عن مسح ضوئي منخفض الجودةقم بزيادة DPI وحاول مرة أخرى، إذا كان لا يزال غير واضح، ضع علامة "ثقة منخفضة"نعم
منطقة التوقيع بيضاء بالكاملإحداثيات المقطع خاطئة أو أن التوقيع موجود في طبقة التعليقات التوضيحيةتحقق من معلمة التعليقات التوضيحية وحاول إعادة عرض annots=Trueنعم
التوقيع واضح ولكن معوضتحتوي الصفحة على اختلافات في التدوير أو CropBoxقم باستعادة page.rect واضبط المقطعلا
تم استخراج التوقيع ولكن لا يمكن تأكيد الموقعاستخراج الصور فقط، ولم يتم التحقق من التوقيع الرقميتم وضع علامة واضحة على "للإشارة المرئية فقط"نعم

هذا الجدول مخصص لقبول نتائج العرض على مستوى العرض التوضيحي للكود ولا يمثل تأثير الأعمال الشامل. عندما يتعلق الأمر بالصلاحية القانونية أو مصادقة الهوية أو مقارنة المستندات، يجب نقل عملية المراجعة اليدوية. النص الآلي مسؤول فقط عن إنشاء المواد للمراجعة ولا يتحمل مسؤولية الحكم. يوصى بإنشاء نظام وضع العلامات في النظام للتمييز بين الحالة "مقروءة آليًا" و"المراجعة اليدوية المعلقة" و"التحقق منها".

مراجع

التحقق من النصائح قبل ترجمة المستندات

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

توفر OmniDoc (بوابة المنتج) بوابة لترجمة المستندات متعددة التنسيقات، ويقدم الموقع الرسمي وظائف التعرف الضوئي على الحروف (OCR) والمسرد ووظائف المقارنة ثنائية اللغة. بالنسبة للفرق التي ترغب في العمل مباشرة من الملفات، فهذا مسار يستحق التقييم باستخدام عينات من الحياة الواقعية. الرجاء استخدام الملفات غير الحساسة التي لديك إذن بتحميلها، واستخدام عناصر الاختيار في هذه المقالة لمراجعة النتائج. لا يوجد ادعاء هنا بأن OmniDoc يستخدم المكتبات مفتوحة المصدر أو الخوارزميات الداخلية في هذه المقالة، ولا يحل المثال محل اختبار أداء المنتج.

❓ الأسئلة الشائعة (الأسئلة الشائعة)

1. لماذا الصورة المعروضة 0×0؟

السبب الأكثر شيوعًا هو أن مستطيل clip لا يتقاطع مع الصفحة. قم بتنفيذ clip &= page.rect قبل العرض. إذا كانت النتيجة فارغة، قم بتسجيل استثناء وتخطي الصفحة.

2. لماذا يبدو التوقيع ضبابيًا؟

يكون الرقم الافتراضي 96 نقطة في البوصة منخفضًا بشكل عام بالنسبة لمناطق التوقيع. ويمكن زيادتها إلى 300 نقطة في البوصة؛ إذا كانت لا تزال ضبابية، فيجب عليك التفكير فيما إذا كانت الصورة الأصلية نفسها عبارة عن مسح ضوئي منخفض الجودة ووضع علامة "منخفضة الثقة" عليها للمراجعة اليدوية.

3. هل يمكنني استخدام صورة التوقيع المقدمة لتأكيد الموقع؟

لا أستطيع. توضح الصورة المقدمة فقط وجود علامة مرئية في الموقع ولا يمكنها التحقق من خصائص التشفير. يتطلب تأكيد المُوقع استخدام آلية التحقق من التوقيع الرقمي بتنسيق PDF.

4. ماذا أفعل إذا كانت منطقة التوقيع بيضاء بالكامل؟

تحقق مما إذا كانت إحداثيات المقطع صحيحة وتأكد مما إذا كان التوقيع موجودًا على طبقة التعليقات التوضيحية. يمكنك تجربة إعادة عرض annots=True مع الاحتفاظ بعملية المراجعة اليدوية.

5. كيف يتم التعامل مع اختلال الإحداثيات بعد تدوير الصفحة أو قصها؟

قم أولاً بإعادة الحصول على page.rect لتأكيد ما إذا كان CropBox الحالي متوافقًا مع الإحداثيات. استعادة MediaBox أو إجراء تحويل الإحداثيات إذا لزم الأمر؛ لا تغطي الأمثلة الواردة في هذه المقالة التدوير وتحويلات الإحداثيات الأخرى ويجب معالجتها بشكل منفصل.

📝 ملخص

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

جربه الآن: قم بتحميل المستند لبدء الترجمة، مع الاحتفاظ بالتخطيط الأصلي

تاريخ التحديث: 2026-11-16