บทนำ
การสร้างแบบฟอร์ม 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, แต่ enum เหล่านี้สามารถพาร์สและตรวจสอบความถูกต้องได้อย่างถูกต้องแม้ยังไม่ได้รับการสนับสนุนโดยเอนจิ้นการเรนเดอร์ของรุ่นนี้ — พฤติกรรม 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.