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, []