故障排除 Aspose.OMR FOSS for Python
故障排除 Aspose.OMR FOSS 用于 Python
生成问题
生成的页面为空或缺少元素
构建但从未追加到父级 Children 列表的元素永远不会被渲染。请确认在调用 OmrEngine.Generate() 之前，每个元素（包括页面自身的子元素）都已实际附加到树中。
设置 Overflow 或 LongWordHandling 没有可见效果
此版本的渲染引擎尚未支持这些枚举——它们能够正确解析和验证，但溢出行为尚不可配置。此问题已在上游路线图上标记为未实现。
SaveAsPdf() 引发 NotImplementedError
此版本未实现 PDF 导出。请改用 Save()（或 MemoryGenerationResult.GetImages()）来输出 PNG。
识别问题
GetAnswer() 对看起来已填充的标记返回空字符串
该标记的识别阈值可能过于严格。将 -100 传递给 Recognize() 以进行自动校准，或在不重新扫描的情况下，对现有结果调用 TemplateProcessor.Recalculate(result, threshold) 并使用更宽松的阈值。
FormValidationLogic.Exception 即使在多标记问题上也从不抛出异常
该检查仅在 Multiselect 被禁用的问题上触发；GlobalPageSettings.Multiselect 默认是启用的。请确认针对您期望为单选的问题已显式关闭 Multiselect，然后将 FormValidationLogic.Exception 传递给 GetTemplateProcessor()。
在 ImageCollection 中注册图像时，如果第二次使用相同名称调用会抛出异常
ImageCollection 为仅追加模式，不允许重复名称。在调用 Add() 前检查 Contains(name)，或为每个图像使用唯一名称。
安装问题
pip install 报告未找到该软件包
git clone https://github.com/aspose-omr-foss/Aspose.OMR-FOSS-for-Python.git
cd Aspose.OMR-FOSS-for-Python
pip install -e .诊断检查清单
- 确认 Python 3.10 或更高版本，并且已安装
numpy、opencv-python和Pillow。 - 确认每个模板元素都已附加到其父级的
Children列表中。 - 确认识别阈值与扫描质量匹配 — 在尝试固定值之前，使用
-100进行自动校准。 - 确认
FormValidationLogic符合您预期的验证行为（Ignore与Exception），并且在相关问题上Multiselect已按您的预期进行设置。
