介绍
在 Aspose.OMR FOSS 中为 Python 生成 OMR 表单意味着构建一个以 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。