واجهة برمجة تطبيقات OMR PHP مجانية لتحليل النماذج والصور الممسوحة ضوئياً عبر الإنترنت
مكتبة PHP مفتوحة المصدر للتعرف الضوئي على العلامات (OMR) صُممت لتحليل النماذج الممسوحة ضوئياً واكتشاف الإجابات المحددة من مناطق محددة مسبقاً داخل تطبيق PHP.
ما هو FormRead؟
في العالم الرقمي اليوم، يُعد أتمتة استخراج البيانات من النماذج أمرًا حيويًا للأعمال والمؤسسات التعليمية والمنظمات البحثية. في مجال جمع البيانات، لا يزال التعرف الضوئي على العلامات (OMR) طريقة موثوقة لمسح وتفسير البيانات المعلَّمة على النماذج والاستطلاعات والاختبارات والبطاقات الانتخابية. يوفر FormRead، وهو واجهة برمجة تطبيقات OMR مفتوحة المصدر بلغة PHP، حلاً قويًا لقراءة ومعالجة النماذج المعلَّمة بكفاءة. إنه واجهة برمجة تطبيقات OMR مبنية على PHP صممت لاكتشاف وتفسير المناطق المعلَّمة على النماذج الممسوحة ضوئيًا أو الاستطلاعات أو أوراق الإجابة. وهو مفيد بشكل خاص لأتمتة جمع البيانات من النماذج الورقية، مما يقلل من أخطاء الإدخال اليدوي، ويحسن الكفاءة.
FormRead هي مكتبة مفتوحة المصدر للتعرف الضوئي على العلامات مكتوبة بلغة PHP. تدعم مجموعة متنوعة من أنواع الحقول الشائعة في نماذج OMR، مثل مربعات الاختيار، النص، الاختيار والمجموعة. تم تصميم المكتبة خصيصًا لتحليل النماذج الممسوحة ضوئيًا واكتشاف الإجابات المحددة من مناطق محددة مسبقًا — مثالية لحالات الاستخدام مثل امتحانات الاختيار المتعدد، نماذج التعليقات، بطاقات التصويت، أو أي جمع بيانات يعتمد على النماذج. تسمح المكتبة للمطورين بتعريف مناطق (أو “شبكات”) على صورة النموذج ثم اكتشاف أي من تلك المناطق تم وضع علامة (ملء) عليها من قبل المستخدمين. هناك عدة ميزات هامة في المكتبة، مثل تعريف النموذج المرن، تحميل ومعالجة الصورة، التعامل مع حساسية العتبة، دعم صيغ الصور المتنوعة، قوالب قابلة للتخصيص، دعم الباركود ورمز الاستجابة السريعة (QR Code)، والعديد غيرها. FormRead هي واجهة برمجة تطبيقات OMR متعددة الاستخدامات بلغة PHP تُبسّط معالجة النماذج تلقائيًا. سواءً كنت تقوم بتصحيح الامتحانات، معالجة الاستطلاعات، أو رقمنة السجلات، فإنها توفر حلاً مرنًا وفعالًا.
البدء مع FormRead
الطريقة الموصى بها لتثبيت مكتبة PHP FormRead هي باستخدام Composer. يرجى استخدام الأمر التالي لتثبيت سلس.
تثبيت OFormReadMR عبر Composer
composer require mojv/formread
تثبيت FormRead عبر GitHub
git clone https://github.com/mojv/FormRead.git
cd FormRead معالجة النموذج الممسوح باستخدام PHP
المكتبة المفتوحة المصدر FormRead تجعل من السهل على مطوري البرمجيات تحميل ومعالجة النماذج الممسوحة ضوئياً والصور داخل تطبيقات PHP. أولاً، ستحصل على صورة ممسوحة ضوئياً للنموذج المكتمل، لنطلق عليها filled_form.jpg. يستخدم البرنامج النصي PHP التالي مكتبة FormRead لمعالجة هذه الصورة عن طريق استدعاء الدالة processImage() مع مسار النموذج الممسوح. ثم يتم ترميز النتائج كـ JSON منسق بشكل جميل ويتم طباعتها.
كيف يتم معالجة نموذج ممسوح ضوئياً داخل تطبيقات PHP؟
require 'vendor/autoload.php';
use FormRead\FormRead;
// Path to the form definition and the scanned image
$formJsonPath = 'path/to/your/form.json';
$imagePath = 'path/to/your/filled_form.jpg';
try {
// Create a new FormRead instance
$formRead = new FormRead($formJsonPath);
// Process the image
$results = $formRead->processImage($imagePath);
// Output the results as JSON
header('Content-Type: application/json');
echo json_encode($results, JSON_PRETTY_PRINT);
} catch (Exception $e) {
// Handle any errors
echo 'Error: ' . $e->getMessage();
}
تعيين إحداثيات الحقول المخصصة
توفر مكتبة FormRead دعماً كاملاً لتعيين إحداثيات الحقول المخصصة داخل تطبيقات PHP. يمكن لمطوري البرمجيات تحديد الموقع الدقيق لكل خانة اختيار أو فقاعة باستخدام إحداثيات البكسل (x, y)، العرض، والارتفاع. هذا أمر أساسي لأن كل تخطيط نموذج مختلف. يوضح المثال التالي كيفية تعريف نموذج مخصص بالمواقع الدقيقة عبر واجهة برمجة التطبيقات PHP.
كيف يتم تعريف حقول نموذج مخصصة بالمواقع الدقيقة عبر واجهة برمجة تطبيقات PHP؟
$fields = [
['x' => 100, 'y' => 200, 'width' => 20, 'height' => 20], // Question 1 - Option A
['x' => 130, 'y' => 200, 'width' => 20, 'height' => 20], // Question 1 - Option B
['x' => 160, 'y' => 200, 'width' => 20, 'height' => 20], // Question 1 - Option C
// Add more fields as needed...
];
معالجة نماذج متعددة عبر واجهة برمجة تطبيقات PHP؟
بفضل تصميمه البسيط واستخدامه لتقنيات معالجة الصور الفعّالة، يمكن لمكتبة FormRead المفتوحة المصدر معالجة النماذج على دفعات بسهولة. بفضل هذه المعالجة القوية للنماذج، يصبح ذلك مناسبًا لأنظمة تصحيح الامتحانات أو استيراد الاستطلاعات الضخمة. يوضح المثال التالي كيف يمكن للمطورين تنفيذ معالجة دفعات من النماذج باستخدام أوامر PHP.
كيف يتم تنفيذ معالجة دفعة من النماذج باستخدام مكتبة PHP؟
$scans = ['form1.jpg', 'form2.jpg', 'form3.jpg'];
foreach ($scans as $form) {
$results = FormRead::read($form, $fields);
// Save to DB or evaluate result
echo "Form $form: " . implode(',', $results) . "\n";
}
