LNNBot/指令/musicjs*

musicjs*
属性	别名指令
父级指令	musicjs

musicjs* 是 musicjs 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

用法

musicjs* <code...>

除 musicjs 提供的函数和变量之外，musicjs* 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 eval 指令向 musicjs* 添加辅助函数，只需在对象 storage.musicjsX 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码。

aj()

辅助函数作者：DGCK81LNN

aj()（“ASCII 简谱”）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 dd，控制音符 6 与基准音（由 baseFrequency 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 >、< 会增减其值。例如使用 5 个 > 可使 1=F4。

aj() 每次被调用时，会将 gain 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 bpm 及圆括号的层数共同定义一“拍”的时长。

aj() 乐谱语法

字符	名称	作用
1–7	音符	以当前的一拍为时值创建对应的简谱音符。
0	休止符	休止一拍。
,	低音点	将前一个音符降低一个八度。
'	高音点	将前一个音符升高一个八度。
.	附点	将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
-	延音线	将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|	小节线	无作用，仅辅助阅读。
( )	减时线	括号内一拍的时长减半，可以嵌套。
b	降号	使下一个音符降低一个半音。不会影响后续的音符。
#	升号	使下一个音符升高一个半音。不会影响后续的音符。
[ / ]	分声部	方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
>	升调	升调一个半音。
<	降调	降调一个半音。
p	力度：弱	将 gain 设为 0.33，若已经是 0.33 则设为 0.18。
m	力度：中	将 gain 设为 0.5。
f	力度：强	将 gain 设为 0.75，若已经是 0.75 则设为 1。
t	开始三连音或结束连音（triplet/tuplet）	如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
dN	开始 N 连音（irregular division）	若 N 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 ${\frac {2^{\lfloor \log _{2}N\rfloor }}{N}}$。N 为 1 时实际效果为结束连音。
rM:N	开始 M:N 连音（ratio）	将时值乘数设为 N / M。
s	延长（sustain）	将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。

示例：《Somebody That I Used To Know》副歌

//musicjs* bpm=129 aj('>>>>>') // 1=F aj(`[f 0(5561'1'6)|4'.(3')3'-| 0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')| 1'-(61'1'6)|4'.(3')3'(66)| (2'3'3'3'3'.(2')2'6)|655-| /pp 3''--0|00(5''--2''| -3''----)0|1''-(5'--2''| -3''----)0|00(5''--2''| -3''----02''|-1''-----2''|-) /m 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| ]`) aj(`[f 0(5561'1'6)|4'.(3')3'-| 0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')| 1'-(61'1'6)|3'.(2')2'-| (2'3'3'3'1'2'2'2')|2'1'1'-| /pp (03''----)0|00(5''--2''| -3''----)0|1''-(5'--2''| -3''----)0|00(5''--2''| -3''----02''|-1''-----2''|-) /m 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| ]`) aj(`[f 0000|0000| (2'3'3'3'1'2'2'2')|2'1'1'-| 0000|0000| (2'3'3'3'1'2'2'(2'3'))|2'1'1'-| /p (50502'02'0|3'4'5'3')2'0| (1'01'07070|6060)50| (50502'02'0|3'4'5'3')2'0| (60)00(70)|(60)00((2'3')0)| /pp (03''----)0|00(5''--2''| -3''----)0|1''-(5'--2''| -3''----)0|00(5''--2''| -3''----02''|-1''----)0| /m 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)| 6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,, ]`)

ip7()

辅助函数作者：6xL-Bro islptng

ip7() 函数接受一个乐谱字符串和一个 BPM 数字，使用一种相比于 aj() 更加紧凑的语法。乐谱语法见此页面：ip7 music

tr3()

辅助函数作者：cycwin

待补充