文档缩放与样式选项
除了字体、间距等系统性的渲染属性外,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
,表示文档页面宽度的 。
样式选项介绍
调试模式 debug
名称:debug
, 类型:boolean
, 默认值:true
调试模式开启时,显示结果中将会包含一些错误提示信息,目前包括节拍校验以及迭代数冲突校验的色块。
true
false
小节序号 sectionorder
名称:sectionorder
, 类型:"paren"|"bracket"|"plain"|"none"
, 默认值:paren
控制行首小节序号的显示格式。
paren
bracket
plain
none
文档整体缩放 scale
名称:scale
, 类型:number
, 默认值:1
控制文档的整体缩放,以适应特殊宽度的纸张。
如果你的目的是在一般电脑屏幕上显示,或者在 A4 纸上打印,你可能不需要用到这个选项。
1
0.8
1.2
额外左边距 _left
名称:gutter_left
, 类型:number
, 默认值:1
名称:connector_left
, 类型:number
, 默认值: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
0.6
小节内边距 offset_section_boundary
名称:offset_section_boundary
, 类型:number
, 默认值:1
控制小节的水平方向内边距。由于还有时值空间的存在,边距设置为 0 并不会导致音符紧贴小节线。
注意:布局空间不足的情况下算法会自动尝试占据边距空间来完成布局。如果布局仍然失败,减小边距不能解决问题。正确的做法是调节小节宽度。
1
0
接下来...
接下来我们介绍如何在 Sparks NMN 中指定页面大小。指定页面大小后,Sparks NMN 将允许我们添加页脚并自动生成页码,这对需要打印的文档显然是比较重要的。