理解X形音符头与常见错误
在音乐记谱中，x形音符头（或称死音符、幽灵音符）通常用于表示非传统演奏方式的音符，例如打击乐器的特定敲击、吉他的闷音、或无法确定音高的音符。在lilypond中，实现这种特殊音符头需要特定的语法。
许多用户在尝试通过Abjad（一个用于生成LilyPond代码的Python库）创建X形音符头时，可能会直观地尝试使用类似xNote的命令。然而，这会导致一个常见的错误：Exception: LilyPondParser can not emulate music function: xNote。这个错误表明Abjad的内置LilyPond解析器无法识别或模拟xNote这一非标准的LilyPond函数。实际上，LilyPond并没有一个名为xNote的单一命令来切换X形音符头。
LilyPond中X形音符头的正确语法
LilyPond中用于开启和关闭X形音符头的正确命令是xNotesOn和xNotesOff。
- xNotesOn：此命令用于开启X形音符头模式。在其之后出现的所有音符（直到遇到xNotesOff或乐句结束）都将以X形音符头显示。
- xNotesOff：此命令用于关闭X形音符头模式。在其之后出现的音符将恢复为标准音符头。
这种成对的命令结构允许用户精确控制X形音符头的应用范围，无论是单个音符、一段旋律还是和弦中的部分音符。
在Abjad中实现X形音符头
Abjad作为LilyPond的Python接口，允许用户通过字符串形式嵌入原生的LilyPond命令。因此，要解决上述错误并正确创建X形音符头，我们需要在Abjad的音符字符串中直接使用xNotesOn和xNotesOff。
示例代码：错误与纠正
让我们对比一下最初的错误尝试和正确的实现方式。
错误的尝试（导致解析错误）：
import abjad
# 尝试使用 xNote，这将导致 LilyPondParser 错误
notes_incorrect = r"c''4 b xNote { e f } c b < g xNote c f > b"
voice_1_incorrect = abjad.Voice(notes_incorrect)
staff_incorrect = abjad.Staff([voice_1_incorrect])
# abjad.show(staff_incorrect) # 运行此行将抛出异常
print("此代码会抛出 'LilyPondParser can not emulate music function: \xNote' 异常。")正确的实现方式：
import abjad # 使用 xNotesOn 和 xNotesOff 来正确创建 X 形音符头 notes_correct = r"c''4 b xNotesOn e f xNotesOff c b < g xNotesOn c xNotesOff f > b" voice_1_correct = abjad.Voice(notes_correct) staff_correct = abjad.Staff([voice_1_correct]) # 显示乐谱 abjad.show(staff_correct)
代码解析
在正确的示例中：
- import abjad：导入Abjad库。
- notes_correct = r"c''4 b xNotesOn e f xNotesOff c b b"：
- r"" 表示这是一个原始字符串，可以避免反斜杠的转义问题。
- c''4 b 是普通的音符。
- xNotesOn e f xNotesOff：在e和f音符之前插入xNotesOn，在其之后插入xNotesOff。这样，e和f将显示为X形音符头。
- c b 是普通的音符。
- ：这是一个和弦。在这个和弦内部，我们希望c音符显示为X形音符头。因此，在c之前放置xNotesOn，之后放置xNotesOff。注意，g和f仍然是普通音符，因为xNotesOn和xNotesOff只包围了c。
- voice_1_correct = abjad.Voice(notes_correct)：将包含LilyPond命令的字符串解析为一个Abjad的Voice对象。
- staff_correct = abjad.Staff([voice_1_correct])：将Voice对象添加到Staff对象中。
- abjad.show(staff_correct)：生成并显示LilyPond乐谱。
通过这种方式，Abjad会将包含xNotesOn和xNotesOff的字符串直接传递给LilyPond进行处理，从而避免了Abjad解析器无法模拟特定LilyPond函数的问题，并成功生成带有X形音符头的乐谱。
注意事项
- 作用范围： xNotesOn和xNotesOff是成对使用的命令，它们会影响其之间所有音符的显示。务必确保在需要恢复标准音符头时使用xNotesOff，否则后续所有音符都将保持X形。
- 和弦内部应用： 如示例所示，xNotesOn和xNotesOff也可以在和弦内部精确控制单个音符的显示。
- 与其他特殊音符头的结合： 如果需要结合其他特殊音符头（如菱形音符头、三角形音符头等），请查阅LilyPond官方文档中关于 ote-head-style的详细说明，并以类似的方式在Abjad中嵌入相应的LilyPond命令。
总结
在Abjad中创建X形音符头（死音符）的关键在于理解LilyPond的正确语法。避免使用不存在的xNote命令，而应始终使用xNotesOn和xNotesOff这对命令来精确控制X形音符头的开启和关闭。通过在Abjad的音符字符串中直接嵌入这些原生的LilyPond命令，我们可以有效地绕过Abjad解析器的限制，实现复杂的音乐记谱需求，并生成符合预期的专业级乐谱。
