מבוא
יצירת טופס 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, אך enums אלה מפענחים ומאמתים כראוי מבלי שה-render engine של גרסה זו עדיין מכבד אותם — התנהגות overflow עדיין לא ניתנת להגדרה, והיא מתועדת במפת הדרכים של המקור.
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.