المقدمة
إنشاء نموذج OMR في Aspose.OMR FOSS لـ Python يعني بناء شجرة من تكوينات العناصر ذات الجذر TemplateConfig، ثم تسليم تلك الشجرة إلى OmrEngine.Generate(). يقوم المحرك بإنشاء صورة صفحة بالإضافة إلى وصف .omr يقرأه تمرير التعرف اللاحق. تستعرض هذه المقالة تكوينات العناصر التي تُشكل تلك الشجرة، وDSL النصي البديل الذي يبني نفس الشجرة دون إنشاء كائنات Python مباشرةً.
تستورد المكتبة كـ import omr، مرخصة تحت رخصة MIT، وتعتمد فقط على numpy، opencv-python، وPillow.
ما الذي يتضمنه
شجرة القالب
TemplateConfig هو جذر المستند؛ يحتوي على كائن واحد أو أكثر من PageConfig، واحد لكل صفحة فعلية. كل عنصر أسفل الصفحة هو فئة فرعية من BaseConfig، يحمل على الأقل Name ومميز Type (ConfigType).
from omr.generation.config import TemplateConfig
from omr.generation.config.elements.parents import PageConfig
tpl = TemplateConfig()
tpl.Name = "quiz"
page = PageConfig()
page.Children = []
tpl.Children = [page]
عناصر السؤال
ChoiceBoxConfig يعرّف سؤالًا واحدًا بمجموعة ثابتة من فقاعات الخيارات (كل منها ChoiceBoxAnswerConfig) ويدعم اختيارًا متعددًا؛ FormValidationLogic، يُحدَّد مرة واحدة لكل TemplateProcessor، يمكن أن يرفع إذا كان سؤالًا مع Multiselect معطَّل يتلقى أكثر من علامة واحدة. AnswerSheetConfig يعرّض مصفوفة مرقمة من فقاعات الإجابة لأوراق الامتحانات، مع BubbleType وBubbleSize قابلين للتكوين. CheckBoxConfig هو مجموعة معنونة من الصناديق الفارغة التي تقبل أي علامة، مع عتبة تعبئة قابلة للتعديل.
from omr.generation.config.elements import AnswerSheetConfig
sheet = AnswerSheetConfig()
sheet.Name = "answers"
sheet.AnswersCount = 4 # bubbles per question (e.g. A-D)
sheet.ElementsCount = 20 # number of questions
الشبكات والشبكات المركبة
GridConfig يعرض مصفوفة أرقام — عدد ثابت من الأقسام، كل منها يحتوي على فقاعات خيارات من 0–9 — يتم دمجها في قيمة واحدة، تُستخدم عادةً لأرقام الهوية. CompositeGridConfig هو النسخة الأكثر مرونة: مجموعة رموز مخصصة لكل عمود، مع دمج العلامات عبر الأعمدة في قيمة واحدة.
حاويات التخطيط
BlockConfig هو صندوق ذو حدود وحشو؛ ContainerConfig يرتب الكتل الفرعية في أعمدة أو تذييل الصفحة؛ PositionedBlockConfig يضع الأطفال عند إحداثيات XPosition/YPosition مطلقة بدلاً من تدفقهم. BlockConfig وGlobalPageSettings يحملان أيضًا خاصية Overflow (OverflowAction فئات فرعية من Clip/NoClip/Wrap) وLongWordHandling، لكن هذه القيم التعدادية تُفسَّر وتُتحقق منها بشكل صحيح دون أن تُطبق بعد في محرك العرض لهذا الإصدار — سلوك الفائض لم يُصبح قابلًا للتكوين بعد، ويتم تتبعه في خارطة الطريق العليا.
لغة توصيف العلامات DSL
يمكن كتابة الشجرة نفسها كنص عادي بدلاً من كائنات Python. ?choicebox=... يفتح سؤالًا بصندوق اختيار، وتُدرج السطور التالية خياراته، و&choicebox يغلقه.
import json
from omr.api import OmrEngine
markup = [
"?choicebox=Rate it",
"(1) Poor (2) Fair (3) Good",
"&choicebox",
]
engine = OmrEngine()
result = engine.Generate(markup)
desc = json.loads(result.Template)
البدء السريع
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.