AlphaTex 基本语法结构

AlphaTex 文档通常由两部分组成：元数据部分和乐谱内容部分。

1. 元数据部分

元数据以反斜杠 \ 开头，用于定义乐谱的全局属性：

\title "歌曲标题"
\subtitle "副标题"  
\artist "艺术家"  
\album "专辑"  
\words "作词"  
\music "作曲"  
\copyright "版权信息"  
\tempo 120  
\time 4/4  
\instrument 25

2. 乐谱内容部分

乐谱内容以点号 . 开始，后面跟着音符、小节线等：

.
4.4.4 0.2.4 1.3.4 | 5.3.8 5.3.8 5.3.8 5.3.8 r.2

详细语法参考

元数据命令

从代码中可以看到，AlphaTex 支持多种元数据命令：

• 基本信息
  • \title - 设置乐谱标题
  • \subtitle - 设置副标题
  • \artist - 设置艺术家
  • \album - 设置专辑
  • \words - 设置作词
  • \music - 设置作曲
  • \copyright - 设置版权信息
  • \tempo - 设置速度（BPM）
• 乐谱设置
  • \time - 设置拍号
  • \instrument - 设置乐器（MIDI程序号）
  • \capo - 设置变调夹位置
  • \tuning - 设置弦乐器调音
• 轨道和谱表设置
  • \track - 定义新轨道
  • \staff - 定义谱表属性

音符表示法

AlphaTex 中的音符表示为： 弦号.品位.时值

0.5.2 // 第0弦，第5品，二分音符
1.5.4 // 第1弦，第5品，四分音符
3.4.8 // 第3弦，第4品，八分音符

休止符

休止符表示为 r.时值 ，例如：

r.4 // 四分休止符
r.2 // 二分休止符

小节线和重复

|   // 小节线
||  // 双小节线
|*  // 重复开始
*|  // 重复结束

特殊效果

• 弯音和颤音
  • {b} - 弯音
  • {v} - 颤音
  • {tr} - 颤音琶音
• 滑音和连音
  • {s} - 滑音
  • {h} - 锤击
  • {p} - 勾弦
• 其他效果
  • {tp} - 颤音拨片
  • {tu} - 调音
  • {dd} - 死音
  • {su} - 向上扫弦
  • {sd} - 向下扫弦

和弦和指法

\chord "和弦名" 弦1 弦2 弦3 弦4 弦5 弦6

歌词

\lyrics "歌词内容"

小节标记和跳转

\section "段落名称"
\jump "跳转标记"

实际示例

以下是一个完整的 AlphaTex 示例，展示了多种语法元素：

\title "示例乐谱"
\tempo 120
\time 4/4

.
4.4.4 0.2.4 1.3.4 | 5.3.8 5.3.8 5.3.8 5.3.8 r.2