查看“︁LNNBot/指令/musicjs*”︁的源代码

{{LNNBot指令信息
|别名=
|属性=别名指令
|所属插件=
|父级指令=musicjs
|所需权限=
}}
'''<code>musicjs*</code>''' 是 <code>[[LNNBot/指令/musicjs|musicjs]]</code> 的衍生指令，提供了一个 <code>aj()</code> 函数用于以简谱编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 提供了一个 <code>aj()</code> 函数，接受一个字符串作为乐谱，解析后使用 <code>musicjs</code> 提供的函数和变量进行演奏。

<code>musicjs*</code> 还会定义一个 <code>dd</code> 变量，初始为 0，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义）相差的半音数，使用 <code>></code>、<code><</code> 会增减其值。

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

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>&ndash;<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。<br>连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。<br>顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>t</code>
| 开始三连音或结束连音 || 如果当前时值乘数为 1，则将其设为 <math>\frac23</math>；否则设为 1。
|-
| <code>d</code><math>N</math><ref name="division-num"><math>M</math>、<math>N</math> 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 <math>N</math> 连音 || 若 <math>N</math> 是 2 的整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。
|-
| <code>r</code><math>M</math><code>:</code><math>N</math><ref name="division-num"/>
| 开始 <math>M:N</math> 连音 || 将时值乘数设为 <math>\frac N M</math>。
|-
| <code>s</code>
| 延长 || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。<br>可连用，可套在减时线内使用来延长更短的时长。
|}
<references/>

== 轶闻 ==

* 除了 <code>b</code>、<code>p</code>、<code>m</code>、<code>f</code> 直接取自共识的乐谱记号外，乐谱语法中的几个字母指令字符 <code>t</code>、<code>d</code>、<code>r</code>、<code>s</code> 分别取自 '''t'''riplet / '''t'''uplet、irregular '''d'''ivision、'''r'''atio、'''s'''ustain。