Attachments节

本节记录所有的Attachments类符号,即特殊附属符号。每一行代表了一个Attachments符号。

本节所有行采用Name-Value Pair(名-值对)的形式,Name-Value之间采用等号分隔,Value由一个或多个不定数目的子参数构成,各个子参数之间采用逗号分隔。每个符号占用一行。其中等号两侧以及逗号两侧均允许有空格。

等号左侧由3部分构成,其内部不允许有任何空格:

名称 含义 备注
符号类型 枚举。取值如下: 必需
关联位置 由@起头,后跟代表所关联的音符的位置:第几小节以及在小节中的第几个音符,二者之间用逗号分隔。 必需
关联偏移 代表此符号的参考点与所关联的基本符号(音符或小节线)的参考点之间的相对偏移系数。两端用圆括号括起来,两个浮点数分别代表水平方向以及垂直方向的偏移系数(坐标系的方向为向右向下为正),中间用逗号分隔。 必需

等号右侧的格式随着符号类型的不同而不同。以下分别介绍各种Attachments类符号的等号右侧的格式。

Text(特殊文字)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
FontUsage(字体) 枚举类型。取值: 必需
Text(文字) 文字本身。允许包含空格。两端无需大括号或者双引号。支持与拍号、调号、音符的混合(参见6.7.5标准文字)。 必需
Transform(变换) 两端使用大括号括起来,内部依次包含如下参数: 可选
Ocupy(占位) 两端使用中括号括起来,集合类型。内部可包含如下字母: 可选

举例:

Text@38,1(1.00,-2.60) = Default, 渐慢

Text@38,1(1.00,-2.60) = Default, 渐慢, {1.10, 0.80, False, False, Rotate90}, [DL]

FangZi(特殊房子)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
Style(类型) 枚举。取值:Full/Left/Right/RepeatNoCount/DashedLine/Line/WaveLine 必需
Length(长度) 浮点数 必需
Text(文字) 房子内部的文字 必需
Ocupy(占位) 布尔类型。取值False/True 必需

举例:

FangZi@1R(0.00,-3.00) = Full, 30.00, 1., True

Arc(特殊弧线)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
Style(类型) 枚举。取值:Full/Left/Right 必需
Shape(形状) 整型。取值0到3 必需
FullLength(完整长度) 浮点数。单位是mm。 必需
PartialLength(部分长度) 浮点数。单位是mm。 必需
TuplentNumber(连音数) 整型。取值0到20 必需
Ocupy(占位) 布尔类型。取值False/True 必需

举例:

Arc@3,2(0.00,-2.00) = Full, 1, 10.00, 5.00, 3, True

Dynamic(渐强渐弱)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
Length(长度) 浮点数。单位是mm。 必需
bJianRuo(是否是渐弱) 布尔量。取值False/True 必需
bPartial(是否是半边) 布尔量。取值False/True 必需
Ocupy(占位) 布尔量。取值False/True 必需

举例:

Dynamic@1,2(0.50,-3.00) = 15.00, False, False, True

Often(特殊记号)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
Type(类型) 枚举。取值: 必需
Transform(变换) 参见6.10.1 可选
Ocupy(占位) 参见6.10.1 可选

举例:

Often@3,2(0.00,-2.00) = Force-pp, {}, [UD]

Extend(扩展符号)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
Unicode 符号的Unicode编码。允许多个编码紧密相连。两端必须使用大括号。每个编码用\x起头,后跟4位16进制字符。支持换行符\n 必需
Transform(变换) 参见6.10.1 可选
Ocupy(占位) 参见6.10.1 可选

举例:

Extend@1,5(0.00,-2.00) = {\xF006}, {}, [UDLR]

Branch(临时声部)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
bAutoAlign(是否自动对齐主声部) 布尔量。取值False/True。 必需
InitMeter_FenZi (初始拍号的分子) 整型。 必需
InitMeter_FenMu (初始拍号的分母) 整型。 必需
InitBeatPos(初始节拍位置) 整型。 必需
AbcCode_Voice(音符的abc代码) 两端必须有大括号。内部是临时声部的abc代码。 必需
AbcCode_Lyric(歌词的abc代码) 两端必须有大括号。内部是临时声部的歌词(只能有1段)。 可选
Transform(变换) 参见6.10.1 可选
Ocupy(占位) 参见6.10.1 可选
bUseSubStyle(是否使用特定风格音符) 布尔量。取值False/True 可选
SubStyle(要使用的特定风格) 枚举。取值: 可选

举例:

Branch@33R(-3.60,-1.60) = True, 2, 4, 3, {( 56}, {}, {}, [UD], True, SubStyleSmallSize

Brace(连谱号)

等号右侧依次由如下部分构成(各部分之间用逗号分隔):

名称 含义 备注
Type(类型) 枚举,取值ZhiKuoHao/HuaKuoHao 必需
Direction(方向) 枚举,取值Left/Right 必需
Length(长度) 浮点数。单位是mm 必需
Ocupy(占位) 参见6.10.1 必需
ExtraLength 浮点数。(直括号)出头线的长度。单位是mm 可选

举例:

Brace@25,1(-2.30,-1.70) = ZhiKuoHao, Right, 26.0, []