渲染属性
渲染属性是调整布局和渲染的参数,以若干 <键>=<值>
的格式写在 Rp:
或 Srp:
开头的行中。这是一个例子:
常见错误
渲染属性行是按空格分割的,因此单个属性内部不能有空格。例如不能将 n=3
写成 n = 3
。
提示
当渲染属性行变得过长难以编辑的时候,可以使用软折行将其分行。
所有渲染属性
名称 | 类型 | 说明 | 默认值 |
---|---|---|---|
page | page | 页面高度与宽度之比 | 0 |
double_sided | boolean | 分页时假设双面打印 | false |
n | number | 每行小节数 | 4 |
time_lining | boolean | 基于时值的小节宽度 | false |
legacy_positioning 最低版本:Sparks NMN 1.14.20 | boolean | 使用旧版布局算法 | false |
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 |
font_sectionorder 最低版本:Sparks NMN 1.15.1 | font | 字体 - 小节序号 | CommonLight/400 |
font_part | font | 字体 - 声部标签 | Roman,CommonSerif/700 |
font_article | font | 字体 - 章节标题 | Roman,CommonSerif/700 |
font_title | font | 字体 - 大标题 | Roman,CommonSerif/700 |
font_subtitle | font | 字体 - 副标题 | CommonSerif/400 |
font_author | font | 字体 - 作者 | CommonSerif/400 |
font_corner | font | 字体 - 角落标记 | CommonLight/400 |
font_text | font | 字体 - 文本章节 | Roman,CommonSerif/400 |
font_footnote | font | 字体 - 尾注 | CommonSerif/400 |
font_descend | font | 字体 - 页脚 | CommonLight/400 |
font_attr | font | 字体 - 属性文本 | CommonSerif/400 |
font_force | font | 字体 - 力度 | RomanItalic,CommonBlack/400 |
font_chord | font | 字体 - 和弦 | Roman/600 |
font_annotation0 | font | 字体 - 默认自定义标记 | CommonSerif/600 |
font_annotation1 | font | 字体 - 第一自定义标记 | CommonSerif/600 |
font_annotation2 | font | 字体 - 第二自定义标记 | CommonSerif/600 |
font_annotation3 | font | 字体 - 第三自定义标记 | CommonSerif/600 |
font_annotation4 | font | 字体 - 第四自定义标记 | CommonSerif/600 |
font_annotation5 | font | 字体 - 第五自定义标记 | CommonSerif/600 |
font_annotation6 | font | 字体 - 第六自定义标记 | CommonSerif/600 |
font_lyrics | font | 字体 - 歌词 | Roman,CommonSerif/600 |
font_checkpoint | font | 字体 - 段落标记 | Roman,CommonSerif/700 |
margin_after_props | number | (2)间距 - 大标题之后 | 2 |
margin_after_article | number | (1.5)间距 - 章节之后 | 1.5 |
margin_after_header | number | (0.8)间距 - 章节标题之后 | 0.8 |
margin_after_header_text | number | (0.7)间距/额外 - 文本章节标题之后 | 0.7 |
margin_before_line | number | (1.2)间距 - 乐谱行之前 | 1.2 |
margin_after_line | number | (0.1)间距 - 乐谱行之后 | 0.1 |
margin_between_parts | number | (2.5)间距 - 声部之间 | 2.5 |
margin_after_part_notes | number | (2)间距 - 声部曲谱部分之后 | 2 |
inset_before_lyrics | number | (1.3)负间距 - 声部歌词组之前 | 1.3 |
margin_after_lyrics | number | (0.1)间距 - 声部歌词组之后 | 0.1 |
margin_after_part | number | (1)间距 - 声部之后 | 1 |
offset_lyrics_iter | number | (1.5)偏移值 - 歌词行编号 | 1.5 |
offset_section_boundary | number | (1)偏移值 - 小节边距 | 1 |
page
类型指定页面高度与宽度之比,设置后将启用页面精排模式和页脚。这一属性只在Rp:
开头的行中有效。- 可以设置为数字,例如
1.4142
。 - 可以设置为
A2
A3
A4
A5
A6
或B3
B4
B5
。 - 可以描述页面的高度与宽度,例如
29.7/21.0
,Sparks NMN 将自动计算比值。 - 设置为
0
,将禁用页面精排。
- 可以设置为数字,例如
boolean
类值应当为true
或false
。- 边距与间距选项的单位是
em
,表示页面宽度的 。 font
类的写法应当是<字体名>/<字重>/<大小>
。- 字重和大小可以省略。
- 字重参考值:
400
- 普通,700
- 加粗。 - 大小指的是相对默认大小的倍数。
- 字体名中的空格用下划线
_
代替,名称中原来的下划线用两个连续的下划线__
代替。 - 字体名称可以是多个字体,使用逗号
,
隔开,例如Roman,CommonSerif
。注意逗号后不能有空格。
关于字体的信息
为了确保默认显示效果的一致性,Sparks NMN 内置了八个字体,如下:
SparksNMN-EOPNumber
,这是曲谱音符数字、节奏记号、特殊音符-
以及附点所使用的字体。SparksNMN-mscore-20
,这是来自 MuseScore 的字体,包含力度记号和部分音乐符号。SparksNMN-Bravura
,包含部分音乐符号和小节线。Roman
,这是类似 Times New Roman 的有英文衬线字体,仅包含英文字符,往往和 CommonSerif 配合使用。RomanItalic
,这是类似 Times New Roman 斜体的英文字体,仅包含英文字符,用于一些特殊的记号。CommonSerif
,代表经过修改的类宋体字体 AR PL UMing,类似于 Windows 系统的中易宋体。CommonBlack
,不包含粗体,为文泉驿微米黑,其加粗形式也用于显示音符_
,类似于 Windows 系统的微软雅黑。CommonLight
,其“常规”对应 Noto Sans SC 的细体,“粗体”对应 Noto Sans SC 的常规体,用于取代(但并不像)Windows 系统的方正等线。
只使用这些字体,可以保证乐谱在不同设备上显示效果的一致性(在打印时也会应用)。其他字体将会从系统中加载。
提示
字体一般不能自由地使用,否则会面临侵犯著作权的风险,因此 Sparks NMN 选择内置了可以免费商用的字体。下面是关于这些字体的授权信息。
那 Frp 呢?
你可能看到碎片也能拥有渲染属性,写在 Frp:
开头的行中。事实是,在 Frp:
开头的行中,只有 n
属性是有效的,其他都会被忽略。