المقدمة
Aspose.OMR FOSS لـ Python العامة API (omr.api) صغيرة عن قصد: OmrEngine، TemplateProcessor، ImageCollection، وتعداد FormValidationLogic. هذه المقالة تستعرض ما يفعله كل منها وكيفية ربطهم عبر سير عمل توليد → التعرف → التصدير.
المكتبة تُستورد كـ import omr، مرخصة بترخيص MIT، وتعتمد فقط على numpy وopencv-python وPillow.
ما المتضمن
OmrEngine — مصنع بدون حالة
OmrEngine لا يحتفظ بأي حالة بين الاستدعاءات. Generate(source, settings) يقبل إما مصدر نصي markup-DSL أو شجرة TemplateConfig برمجة أولية، ويعيد GenerationResult — صورة(ات) الصفحة بالإضافة إلى قالب .omr JSON الذي يصف موقع كل عنصر. GetTemplateProcessor(templateSource, validationLogic) يحمل ملف .omr محفوظ مسبقاً (أو موصِف في الذاكرة) ويعيد TemplateProcessor مرتبطاً به.
from omr.api import OmrEngine, FormValidationLogic
engine = OmrEngine()
gen = engine.Generate("final-exam.txt")
gen.Save("out", "final-exam")
processor = engine.GetTemplateProcessor("out/final-exam.omr", FormValidationLogic.Ignore)
GenerationResult و MemoryGenerationResult
GenerationResult يكشف عن ErrorCode، ErrorMessage، Template (وصف .omr كسلسلة JSON)، TemplateImage، و — للقوالب متعددة الصفحات — MultipageTemplateImages. Save(folder, name) يكتب الصورة والوصف إلى القرص؛ SaveAsPdf() غير مُنفّذ في هذا الإصدار ويرفع NotImplementedError. MemoryGenerationResult يلف نفس البيانات كتيارات في الذاكرة بدلاً من ذلك: GetImages() يُعيد قائمة بتيارات الصور في الذاكرة، وGetOmr(encoding) يُعيد الوصف كتيار — مفيد عندما لا يرغب المستدعي في لمس نظام الملفات على الإطلاق.
TemplateProcessor — التعرف على المسحات الضوئية
TemplateProcessor.Recognize(source, recognitionThreshold) يقرأ صورة ممسوحة ضوئياً واحدة مقابل القالب الذي أُنشئ منه ويعيد RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) يُجري نفس التعرف على كل صورة في مجلد في استدعاء واحد، مُرجعاً قائمة بالنتائج — مريحة لمعالجة دفعات من مجموعة مسحات ضوئية. Recalculate(result, recognitionThreshold) يُعيد تقييم نتيجة مُعترف بها مسبقاً بعتبة مختلفة، دون إعادة قراءة الصورة الأصلية.
RecognitionResult — قراءة الإجابات
كل عنصر في RecognitionResult.OmrElements يُنفّذ IOmrElement، كاشفاً عن GetAnswer() وGetCsv() لكل عنصر، إلى جانب QuestionName. على مستوى النتيجة، GetCsv(encoding) وGetJson(encoding) وGetXml(encoding) يصدرون النتيجة بأكملها، كلٌ مع نسخة ...AsStream مطابقة تُعيد BytesIO بدلاً من سلسلة عادية.
ImageCollection — تضمين الصور في الترميز
ImageCollection هو خريطة تُضاف إليها فقط، حساسة لحالة الأحرف، من اسم إلى بايتات صورة خام. Add(name, image) يُسجِّل صورة، Contains(name) يتحقق ما إذا كان الاسم مسجلاً بالفعل، وas_dict() يُعيد الخريطة الداعمة. يمكن للترميز بعد ذلك الإشارة إلى صورة مسجلة بالاسم (?image=<name>) بدلاً من مسار نظام الملفات — مفيد عندما تأتي بايتات الصورة من مصدر غير القرص، مثل تحميل عبر الويب.
بدء سريع
git clone https://github.com/aspose-omr-foss/Aspose.OMR-FOSS-for-Python.git
cd Aspose.OMR-FOSS-for-Python
pip install -e .from omr.api import OmrEngine, FormValidationLogic
engine = OmrEngine()
gen = engine.Generate("final-exam.txt") # or a code-first TemplateConfig
gen.Save("out", "final-exam") # -> out/final-exam.png + out/final-exam.omr
processor = engine.GetTemplateProcessor("out/final-exam.omr", FormValidationLogic.Ignore)
result = processor.Recognize("scan.png") # -100 = auto-calibrated threshold
print(result.GetCsv()) # also GetJson() / GetXml()
المصدر المفتوح والترخيص
Aspose.OMR FOSS لـ Python مرخص برخصة MIT ومستضاف على GitHub. يُسمح بالاستخدام التجاري وفق نفس شروط أي مشروع مرخص برخصة MIT. لميزات المؤسسات والدعم الإنتاجي، راجع Aspose.OMR — Enterprise Product Family.