企业官网建设流程全解析

• 桌面应用
• 计算机视觉
• 图像处理
• OCR

本指南围绕 Audiveris OMR 引擎的页面有效性（Sheet validity）机制展开：当一本书（Book）中包含插图页、空白页等非乐谱页面时，引擎如何自动识别并标记无效页面，用户在交互模式下如何确认、查看和切换页面有效性状态，以及无效页面会被如何处理（不再转录、导出或打印）。读完本文，你将掌握有效性状态的检测原理、菜单操作路径、标签颜色语义，以及它和页面选择（Sheet selection）、拆分合并（Split and merge）工具之间的正确分工。

为什么需要"页面有效性"概念

Audiveris 把一本书的每个输入图像都当作一个独立的页面（Sheet）来处理，但输入文件中的所有图像并不一定都是乐谱：一本书的扫描件中可能混有插图页、扉页、空白页，甚至封面扫描图。如果把这些页面也纳入 OMR 转录流程，不但浪费时间，还会污染整本书的乐谱合并结果。

为此，Audiveris 为每个页面维护一个有效性标志（validity flag）：页面要么是valid（有效，包含可转录的乐谱内容），要么是invalid（无效，不包含乐谱内容）。从源码看，这个标志被持久化保存在每个页面存根（SheetStub）的 XML 属性中：

/** * If true, this boolean signals that the sheet contains no valid music * from OMR point of view. * This occurs mainly at the beginning or the end of a book, where some sheets may be left * blank or contain just illustrations. * Sheet invalidity can generally be detected during the <code>SCALE</code> step. * By default, this boolean is false and not present in the project XML data. */ @XmlAttribute @XmlJavaTypeAdapter(type = boolean.class, value = Jaxb.BooleanPositiveAdapter.class) private boolean invalid;

（见 SheetStub.java）

注意一个细节：默认情况下该布尔值为false且不会出现在项目的 XML 数据中——也就是说，绝大多数正常页面在工程文件里根本不记录有效性字段，只有被判定为无效的页面才会写入该标志。

自动检测：SCALE 步骤如何判定页面无效

一般情况下，SCALE 步骤足够智能，能够检测出页面中"staff 素材（staff material）"不足，从而从 OMR 的角度判定该页面无效。SCALE 步骤负责分析图像中的黑像素分布，估算谱线粗细与线间距（interline）等关键尺度参数。

从 ScaleBuilder.java 的源码可以确认两条具体的失效判定路径：

1. 找不到有规律的谱线间距（combo peak）时：

if (comboPeaks.isEmpty()) { sheet.getStub().invalidate(); throw new StepException("No regularly spaced lines found"); }

（见 ScaleBuilder.java）

2. 找不到有意义的黑线（staff line / beam）峰值时：

if (blackPeaks.isEmpty()) { sheet.getStub().invalidate(); throw new StepException("No significant black lines found"); }

（见 ScaleBuilder.java）

也就是说，当一个页面既没有足够的前景黑像素素材（连谱线粗细都无法估算），也找不到等间距的谱线结构时，SCALE 步骤就会抛出StepException并同时调用stub.invalidate()把该页面标记为无效。插图页、纯文本页、空白页通常都会命中这两条判定中的至少一条。

批处理与交互模式：两种不同的处理方式

有效性标志的"落地"方式取决于运行模式：

• 批处理模式（batch）：引擎直接为页面设置invalid标志，无需人工干预。整本书转录时，无效页面会被自动跳过。
• 交互模式（interactive）：当 SCALE 步骤检测到页面可能无效时，会弹出确认提示，询问你是否确认该页面确实无效。这给了你纠错的机会——例如一个版面特殊的乐谱页可能被误判，你可以在这一步就纠正它。

从源码看，交互模式下的手动切换也带有确认环节。BookActions.java 中的toggleSheetValidity动作在真正切换状态之前，会先弹出确认对话框（displayConfirmation(msg + doYouConfirm)），只有确认后才调用stub.invalidate()或stub.validate()：

if (isValid) { stub.invalidate(); if (ViewParameters.getInstance().isInvalidSheetDisplay() == false) { controller.removeAssembly(stub); } } else { stub.validate(); }

有趣的是，当页面被标记为无效且当前设置是"不显示无效页签"时，交互模式还会顺手把该页面的装配（assembly，即页面视图）从界面中移除。

查看与切换有效性状态：Sheet 下拉菜单

如何知道某个页面当前被判定为有效还是无效？答案是打开Sheet下拉菜单，查看其中的Current status（当前状态）菜单项：

• 该菜单项会显示页面当前的有效性状态（valid 或 invalid）；
• 按下该菜单项即可切换页面的有效性状态——从源码看，这个菜单项背后绑定的正是上面提到的toggleSheetValidity动作（BookActions.java）。

切换后会弹出确认框，并依据页面当前状态显示不同的确认文案（资源文件中分别定义了setSheetInvalid.pattern与setSheetValid.pattern，见 BookActions.java）。

两种状态下，页面区域的外观对比如下：

有效页面	无效页面

标签颜色：一眼识别无效页面

除了Current status菜单项之外，Audiveris 还提供了视觉提示：无效页面的页签（tab）文字会变色（文档描述为红色）。从源码看，页签颜色的具体实现位于StubsController.markTab(...)，颜色定义在 Colors.java：

public static final Color SHEET_INVALID = Color.PINK; public static final Color SHEET_OK = Color.BLACK;

即有效页签使用黑色，无效页签使用**粉色（PINK）**标记；SheetStub.java 中的invalidate()方法在 GUI 模式下也会立即调用StubsController.getInstance().markTab(this, Colors.SHEET_INVALID)刷新标签颜色，无需重启即可看到变化。界面下方各书页签栏中，凡是被标记为无效的页面都会以醒目颜色区分于正常页面。

显示或隐藏无效页签：View | Display invalid sheets

默认情况下，无效页面可能被隐藏，也可能显示——这取决于一个视图参数。你可以通过菜单View | Display invalid sheets决定是否显示无效页面的页签。

该开关在源码中对应ViewParameters中的invalidSheetDisplay布尔常量（ViewParameters.java），并提供isInvalidSheetDisplay()/setInvalidSheetDisplay()以及toggleInvalidSheets(...)方法（ViewParameters.java 与 ViewParameters.java）。

StubsController在构建页签时正是依据该开关决定是否过滤无效页面（StubsController.java）：

if (ViewParameters.getInstance().isInvalidSheetDisplay()) { // Display all sheets for all books, including invalid ones } else { // Hide invalid sheets for all books }

在你将某个页面标记为无效后，如果当前设置是隐藏无效页签，交互模式还会立即把该页面装配从界面移除（见上文toggleSheetValidity的代码）。

无效页面的处理影响：什么都不做！

被声明为invalid的页面不再被处理：

• 不转录（no transcription）
• 不导出（no export）
• 不打印（no printing）
• 什么都不做！

除非你后来意识到判断有误，决定把它重新置回valid。

这个"处理时过滤无效页面"的行为在源码中得到广泛印证。例如 Book.java 的getValidSelectedStubs()会从当前选中的页面中剔除所有无效页面，只保留stub.isValid()为真的页面；getValidStubs()（Book.java）同样只返回有效的页面存根。而在 Book.java 的createScores(...)中，"无效、未选中或尚未处理"的存根都会触发乐谱分段（score break），从而保证无效页面不会混入成品的乐谱数据。

重要副作用：切换有效性会清空 OMR 数据

有效性应当如实反映页面在 OMR 视角下的真实状态，不要用它来人为地包含或排除某个页面的处理。一个重要的原因是：

修改页面有效性状态的一个副作用是：该页面的所有 OMR 数据会被清空（nullify）！

从源码看，invalidate()不只是翻转一个布尔值，它还会做一连串清理动作（SheetStub.java）：

public void invalidate () { invalid = true; doneSteps.removeIf( (s) -> s.compareTo(OmrStep.BINARY) > 0); pageRefs.clear(); book.updateScores(this); setModified(true); ... }

• doneSteps.removeIf(...)：删除 BINARY 之后的所有已执行步骤记录（即此前的 SCALE、GRID、SYMBOLS 等处理成果全部作废）；
• pageRefs.clear()：清空页面引用；
• book.updateScores(this)：同步更新整本书的乐谱结构。

反之，validate()（SheetStub.java）会把页面重新置为有效、可处理的初始状态。因此，反复切换有效性不是无代价的——每一次切换都可能丢弃该页面已完成的 OMR 成果，需要重新处理。

正确的工具分工：用"页面选择"或"拆分合并"来控制处理范围

既然有效性标志不应该被当作"排除/包含某页面"的开关，那么当你想控制某本书的处理范围时，应该用什么？

文档明确指出，应当改用以下两种机制：

1. 页面选择机制（sheet selection）：在书籍层面选中/取消选中某些页面，被选中的有效页面才会被处理（Book.java 的注释也确认了这一点：NOTA: Among this selection, only the valid sheets will be processed）。
2. 拆分合并工具（Split and merge）：更强大，可以把一个物理页面拆分为多个逻辑页面，或把多个页面合并为一个，通过 Split and merge 指南访问，入口位于书的拆分合并（book split）下拉菜单。

简单来说：有效性回答"这个页面是不是乐谱"，选择机制回答"这本我要处理哪些页面"，两者各司其职，不要混用。

小结

• 有效性状态由 SCALE 步骤自动判定（找不到规律线距或找不到黑线峰值即判无效），是 OMR 视角下的页面属性；
• 批处理模式下引擎自动设置invalid标志，交互模式下弹出确认提示；
• 通过Sheet | Current status查看并切换有效性，无效页签以粉色/红色醒目标记，可用View | Display invalid sheets控制是否显示；
• 无效页面不转录、不导出、不打印，且切换有效性会清空该页面的全部 OMR 数据；
• 需要控制处理范围时，请使用页面选择机制或 Split and merge 工具，而不是玩弄有效性标志。

理解并善用页面有效性机制，是保证 Audiveris 对包含插图页、空白页的书本进行高质量批量转录的第一步。

• 桌面应用
• 计算机视觉
• 图像处理
• OCR