跳到主要内容

渲染属性

渲染属性是调整布局和渲染的参数,以若干 <键>=<值> 的格式写在 Rp:Srp: 开头的行中。这是一个例子:

常见错误

渲染属性行是按空格分割的,因此单个属性内部不能有空格。例如不能将 n=3 写成 n = 3

提示

当渲染属性行变得过长难以编辑的时候,可以使用软折行将其分行。

所有渲染属性

名称类型说明默认值
pagepage页面高度与宽度之比0
double_sidedboolean分页时假设双面打印false
nnumber每行小节数4
time_liningboolean基于时值的小节宽度false
legacy_positioning
最低版本:Sparks NMN 1.14.20
boolean使用旧版布局算法false
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
font_sectionorder
最低版本:Sparks NMN 1.15.1
font字体 - 小节序号CommonLight/400
font_partfont字体 - 声部标签Roman,CommonSerif/700
font_articlefont字体 - 章节标题Roman,CommonSerif/700
font_titlefont字体 - 大标题Roman,CommonSerif/700
font_subtitlefont字体 - 副标题CommonSerif/400
font_authorfont字体 - 作者CommonSerif/400
font_cornerfont字体 - 角落标记CommonLight/400
font_textfont字体 - 文本章节Roman,CommonSerif/400
font_footnotefont字体 - 尾注CommonSerif/400
font_descendfont字体 - 页脚CommonLight/400
font_attrfont字体 - 属性文本CommonSerif/400
font_forcefont字体 - 力度RomanItalic,CommonBlack/400
font_chordfont字体 - 和弦Roman/600
font_annotation0font字体 - 默认自定义标记CommonSerif/600
font_annotation1font字体 - 第一自定义标记CommonSerif/600
font_annotation2font字体 - 第二自定义标记CommonSerif/600
font_annotation3font字体 - 第三自定义标记CommonSerif/600
font_annotation4font字体 - 第四自定义标记CommonSerif/600
font_annotation5font字体 - 第五自定义标记CommonSerif/600
font_annotation6font字体 - 第六自定义标记CommonSerif/600
font_lyricsfont字体 - 歌词Roman,CommonSerif/600
font_checkpointfont字体 - 段落标记Roman,CommonSerif/700
margin_after_propsnumber(2)间距 - 大标题之后2
margin_after_articlenumber(1.5)间距 - 章节之后1.5
margin_after_headernumber(0.8)间距 - 章节标题之后0.8
margin_after_header_textnumber(0.7)间距/额外 - 文本章节标题之后0.7
margin_before_linenumber(1.2)间距 - 乐谱行之前1.2
margin_after_linenumber(0.1)间距 - 乐谱行之后0.1
margin_between_partsnumber(2.5)间距 - 声部之间2.5
margin_after_part_notesnumber(2)间距 - 声部曲谱部分之后2
inset_before_lyricsnumber(1.3)负间距 - 声部歌词组之前1.3
margin_after_lyricsnumber(0.1)间距 - 声部歌词组之后0.1
margin_after_partnumber(1)间距 - 声部之后1
offset_lyrics_iternumber(1.5)偏移值 - 歌词行编号1.5
offset_section_boundarynumber(1)偏移值 - 小节边距1
  • page 类型指定页面高度与宽度之比,设置后将启用页面精排模式和页脚。这一属性只在 Rp: 开头的行中有效。
    • 可以设置为数字,例如 1.4142
    • 可以设置为 A2 A3 A4 A5 A6B3 B4 B5
    • 可以描述页面的高度与宽度,例如 29.7/21.0,Sparks NMN 将自动计算比值。
    • 设置为 0,将禁用页面精排。
  • boolean 类值应当为 truefalse
  • 边距与间距选项的单位是 em,表示页面宽度的 1122\frac{1}{122}
  • 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 属性是有效的,其他都会被忽略。