Options节

本节用于设定文档的选项参数。

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

ParamName = Value1, Value2, Value3…

目前支持如下种类的参数：

  • Digit(音符字体)
  • Paper(页面)
  • HorzSpacing_AW (水平定位-前进宽度)
  • HorzSpacing_Gap (水平定位-最小间隔)
  • VertSpacing(垂直定位)
  • Arc(弧线)
  • Accomp(伴奏)
  • MaxFitFactor(最大拉伸因子)

今后还会逐步增加参数种类。

Digit(音符字体)

格式为：Digit = Value1, Value2, Value3

子参数 数据类型 含义 备注
Value1 Integer 音符数字(唱名)的字型. 范围0到3. 默认为0
Value2 Float 音符数字(唱名)的高度. 单位是mm. 默认为3.0
Value3 Float 音符数字(唱名)的宽高比. 默认为0.80

举例：

Digit = 0, 3.00, 0.80

Paper(页面)

格式为：Paper = Value1, Value2, Value3, Value4, Value5, Value6

子参数 数据类型 含义 备注
Value1 Float 页面宽度. 单位是mm 默认为210
Value2 Float 页面高度. 单位是mm 默认为297
Value3 Float 左边距. 单位是mm 默认为20
Value4 Float 右边距. 单位是mm 默认为20
Value5 Float 上边距. 单位是mm 默认为20
Value6 Float 下边距. 单位是mm 默认为20

举例：

Paper = 210, 297, 20, 20, 20, 20

HorzSpacing_AW (水平定位-前进宽度)

格式为：HorzSpacing_AW = Value1, Value2, Value3

子参数 数据类型 含义 备注
Value1 enum 参考时值 取值4th/8th/16th 默认为16th
Value2 Float 参数前进宽度. 取值1.0到5.0 默认为1.30
Value3 Float 线性因子. 取值0.0到1.0 默认为0.60

举例：

HorzSpacing_AW = 16th, 1.30, 0.60

HorzSpacing_Gap (水平定位-最小间隔)

格式为：HorzSpacing_Gap = Value1, Value2, Value3, Value4, Value5

子参数 数据类型 含义 备注
Value1 Float 最小间隔系数-任意两个音符之间 默认为0.00
Value2 Float 最小间隔系数-整拍音符与后续音符之间 默认为1.00
Value3 Float 最小间隔系数-非整拍音符与4分音符之间 默认为0.70
Value4 Float 最小间隔系数-音符与小节线之间 默认为1.00
Value5 Float 最小间隔系数-其他符号之间 默认为0.50

举例：

HorzSpacing_Gap = 0.00, 1.00, 0.70, 1.00, 0.50

VertSpacing (垂直定位)

格式为：VertSpacing = Value1, Value2, Value3, Value4

子参数 数据类型 含义 备注
Value1 Float 行间距系数-标题与乐谱之间 默认为1.00
Value2 Float 行间距系数-乐谱行与歌词行之间 默认为0.30
Value3 Float 行间距系数-歌词行与歌词行之间 默认为0.20
Value4 Float 行间距系数-歌词行与乐谱行之间 默认为2.00

举例：

VertSpacing = 1.00, 0.30, 0.20, 2.00

Arc(弧线)

格式为：Arc = Value1, Value2, Value3, Value4

子参数 数据类型 含义 备注
Value1 integer 缺省形状，取值0到3 默认为0
Value2 integer 何时由圆顶转到平顶，取值0到4 默认为4
Value3 Float 弧线转换时的超长门槛，单位是mm 默认为20.0
Value4 Float 垂直间隔系数-弧线与音符之间 默认为0.40
Value5 Float 垂直间隔系数-弧线与弧线之间 默认为0.20

举例：

Arc = 0, 4, 20.0, 0.40, 0.20

Accomp(伴奏)

格式为：Accomp = Value1

子参数 数据类型 含义 备注
Value1 Enum 伴奏音符的风格. 取值： 默认为SubStyleNormal

举例：

Accomp = SubStyleNormal

MaxFitFactor(最大拉伸因子)

格式为：MaxFitFactor = Value1, Value2

子参数 数据类型 含义 备注
Value1 float 水平方向两端对齐时，允许的最大拉伸倍数。 默认为3.0
Value2 float 垂直方向两端对齐时，允许的最大拉伸倍数。 默认为2.0

举例：

MaxFitFactor = 3.0, 2.0