跳到主要内容

文档缩放与样式选项

除了字体、间距等系统性的渲染属性外,Sparks NMN 中还存在一些零碎的选项,它们主要控制一些细节样式,因而被称为样式选项

所有样式选项

名称类型说明默认值
debugboolean显示错误警告true
sectionorder"paren"|"bracket"|"plain"|"none"小节线序号模式paren
scalenumber文档缩放1
gutter_leftnumber(1)左边距 - 曲谱1
connector_leftnumber(0)左边距 - 连谱号0
left_separatornumber显示行首的小节线false
grayoutboolean降低延长连音音符的不透明度false
explicitmarkersboolean总是显示声部标签true
offset_lyrics_iternumber(1.5)偏移值 - 歌词行编号1.5
offset_section_boundarynumber(1)偏移值 - 小节边距1
  • boolean 类型的取值为 true(开) 或 false(关)。
  • 所有间距、边距、宽度选项的单位均为 em,表示文档页面宽度的 1122\frac{1}{122}

样式选项介绍

调试模式 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 将允许我们添加页脚并自动生成页码,这对需要打印的文档显然是比较重要的。