在音乐记谱中，x 形符头音符（或称“死音”、“静音”）常用于表示特定的演奏技巧，例如吉他上的闷音、打击乐器上的击边音，或作为教学指示。abjad 作为 lilypond 的 python 包装器，允许用户通过其强大的接口生成复杂的音乐乐谱。然而，直接在 abjad 字符串中嵌入错误的 lilypond 命令（如 \xnote）会导致解析错误。本教程将指导您如何正确地在 abjad 项目中实现这些特殊的音符标记。
理解 LilyPond 的 X 形符头语法
Abjad 在底层依赖于 LilyPond 来渲染乐谱。因此，要正确标记 X 形符头，首先需要了解 LilyPond 自身的语法规则。LilyPond 并没有提供一个单独的 \xNote 命令来标记单个 X 形符头音符。相反，它使用一对命令来开启和关闭 X 形符头模式：
- \xNotesOn: 开启 X 形符头模式。在此命令之后出现的所有音符都将显示为 X 形符头。
- \xNotesOff: 关闭 X 形符头模式。在此命令之后，音符将恢复为标准符头。
这两个命令必须成对使用，以明确指定 X 形符头的起始和结束范围。这是实现 X 形符头标记的关键所在。
在 Abjad 中实现 X 形符头
由于 Abjad 允许通过 abjad.LilyPondLiteral 对象直接插入 LilyPond 原始代码，我们可以利用这一点来应用 \xNotesOn 和 \xNotesOff。以下是实现步骤和示例代码：
- 导入必要的库：首先导入 abjad 库。
- 创建音乐元素列表：将音符、和弦以及 abjad.LilyPondLiteral 对象按照音乐的逻辑顺序组合成一个列表。
- 插入 LilyPondLiteral 对象：将 abjad.LilyPondLiteral(r"\xNotesOn") 和 abjad.LilyPondLiteral(r"\xNotesOff") 插入到您希望 X 形符头模式开始和结束的位置。
- 构建音乐结构：将包含所有元素的列表传递给 abjad.Voice 或其他 Abjad 容器，然后构建完整的乐谱结构。
示例代码：
下面的 Abjad 脚本演示了如何使用 abjad.LilyPondLiteral 来标记 X 形符头音符。我们将让 e4 和 f4 显示为 X 形符头，以及和弦
import abjad
# 构建一个包含音符、和弦和LilyPondLiteral的音乐元素列表
music_elements = [
abjad.Note("c''4"), # 普通音符
abjad.Note("b4"), # 普通音符
abjad.LilyPondLiteral(r"\xNotesOn"), # 开启X形符头模式
abjad.Note("e4"), # 此音符将显示为X形符头
abjad.Note("f4"), # 此音符将显示为X形符头
abjad.LilyPondLiteral(r"\xNotesOff"), # 关闭X形符头模式
abjad.Note("c4"), # 普通音符
abjad.Note("b4"), # 普通音符
abjad.LilyPondLiteral(r"\xNotesOn"), # 再次开启X形符头模式
abjad.Chord("4"), # 此和弦将显示为X形符头
abjad.LilyPondLiteral(r"\xNotesOff"), # 关闭X形符头模式
abjad.Note("b4"), # 普通音符
]
# 将元素列表传递给 abjad.Voice
voice = abjad.Voice(music_elements)
# 创建一个 Staff 并添加 Voice
staff = abjad.Staff([voice])
# 显示乐谱
abjad.show(staff) 运行上述代码，您将看到生成的乐谱中，e4、f4 和
注意事项
- 成对使用 \xNotesOn 和 \xNotesOff：这两个命令必须成对出现，以明确指定 X 形符头模式的作用范围。如果在 \xNotesOn 之后没有 \xNotesOff，那么其后的所有音符都将以 X 形符头显示，直到乐谱结束或遇到另一个 \xNotesOff。
- abjad.LilyPondLiteral 的作用：当 Abjad 遇到无法识别的 LilyPond 命令（如用户尝试的 \xNote）时，它会抛出 LilyPondParser 异常。使用 abjad.LilyPondLiteral 可以将任何 LilyPond 原始代码安全地嵌入到 Abjad 的音乐结构中，让 LilyPond 解释器直接处理这些命令，从而避免 Abjad 自身的解析限制。
- 作用范围：\xNotesOn 和 \xNotesOff 的作用范围是它们被插入到的音乐上下文。通常，它们会影响其所在 Voice 或 Staff 中的后续音符。
- 其他特殊符头：LilyPond 还支持其他类型的特殊符头（例如，菱形符头 \diamondNotesOn / \diamondNotesOff，或斜线符头 \slashNotesOn / \slashNotesOff）。原理与 X 形符头类似，都是通过成对的 \xxxNotesOn 和 \xxxNotesOff 命令，结合 abjad.LilyPondLiteral 在 Abjad 中实现。
总结
在 Abjad 中创建 X 形符头音符（死音）的关键在于理解 LilyPond 的底层语法，并利用 abjad.LilyPondLiteral 对象将正确的 LilyPond 命令 (\xNotesOn 和 \xNotesOff) 嵌入到您的音乐结构中。通过这种方式，您可以精确控制乐谱中特殊音符的显示，避免常见的解析错误，并生成符合专业记谱标准的乐谱。掌握 abjad.LilyPondLiteral 的使用，将极大地扩展您在 Abjad 中进行高级音乐记谱的能力。
