介绍

在 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。


快速入门

相关资源