文档缩放、样式选项
除了字体、间距等系统性的渲染属性外，Sparks NMN 中还存在一些零碎的选项，它们主要控制一些细节样式，因而被称为样式选项。
所有样式选项
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
debug | boolean | 显示错误警告 | true |
sectionorder | "paren"|"bracket"|"plain"|"none" | 小节序号模式 | paren |
scale | number | 文档缩放 | 1 |
gutter_left | number | (1)左边距 - 曲谱 | 1 |
connector_left | number | (0)左边距 - 连谱号 | 0 |
left_separator | number | 显示行首的小节线 | false |
grayout | boolean | 降低延长连音音符的不透明度 | false |
explicitmarkers | boolean | 总是显示声部标签 | true |
offset_lyrics_iter | number | (1.5)偏移值 - 歌词行编号 | 1.5 |
offset_section_boundary | number | (1)偏移值 - 小节边距 | 1 |
boolean类型的取值为true(开) 或false(关)。- 所有间距、边距、宽度选项的单位均为
em，表示除去页面边距后的页面宽度的 。
样式选项介绍
文档整体缩放 scale
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
scale | number | 文档缩放 | 1 |
控制文档的整体缩放，以适应特殊宽度的纸张。
如果你的目的是在一般电脑屏幕上显示，或者在 A4 纸上打印，你可能不需要用到这个选项。
1
0.8
1.2
调试模式 debug
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
debug | boolean | 显示错误警告 | true |
调试模式开启时，显示结果中将会包含一些错误提示信息，目前包括节拍校验以及迭代数冲突校验的色块。
true
false
小节序号 sectionorder
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
sectionorder | "paren"|"bracket"|"plain"|"none" | 小节序号模式 | paren |
控制行首小节序号的显示格式。
paren
bracket
plain
none
额外左边距 _left
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
gutter_left | number | (1)左边距 - 曲谱 | 1 |
connector_left | number | (0)左边距 - 连谱号 | 0 |
前者控制每行第一个小节的左端与左侧装订线之间的距离，后者控制连谱号与左侧装订线之间的距离。
1, 0
0, 0
1, 5
行首小节线 left_separator
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
left_separator | number | 显示行首的小节线 | false |
控制每行每声部第一个小节的开头是否显示一条小节线。这条小节线一般被认为是多余的，默认也是不显示的。
false
true
弱化音符变灰 grayout
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
grayout | boolean | 降低延长连音音符的不透明度 | false |
控制是否降低被延长连音线弱化的音符的不透明度。这是一种对音乐初学者友好的视觉提示。
false
true
始终显示声部名称 explicitmarkers
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
explicitmarkers | boolean | 总是显示声部标签 | true |
控制是否始终显示声部名称，即使声部构成与上一行一致。
true
false
歌词行编号间距 offset_lyrics_iter
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
offset_lyrics_iter | number | (1.5)偏移值 - 歌词行编号 | 1.5 |
控制歌词行的编号与歌词行第一个字之间的距离。
1.5
0.6
小节内边距 offset_section_boundary
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
offset_section_boundary | number | (1)偏移值 - 小节边距 | 1 |
控制小节的水平方向内边距。由于还有时值空间的存在，边距设置为 0 并不会导致音符紧贴小节线。
注意：布局空间不足的情况下算法会自动尝试占据边距空间来完成布局。如果布局仍然失败，减小边距不能解决问题。正确的做法是调节小节宽度。
1
0
接下来...
接下来我们将介绍所有能设置字体的位置，以及设置字体的方法。