KeyUtils.ts.html 39 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009
  1. <!doctype html>
  2. <html lang="en">
  3. <head>
  4. <title>Code coverage report for music-core/utils/KeyUtils.ts</title>
  5. <meta charset="utf-8" />
  6. <link rel="stylesheet" href="../../prettify.css" />
  7. <link rel="stylesheet" href="../../base.css" />
  8. <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
  9. <meta name="viewport" content="width=device-width, initial-scale=1" />
  10. <style type='text/css'>
  11. .coverage-summary .sorter {
  12. background-image: url(../../sort-arrow-sprite.png);
  13. }
  14. </style>
  15. </head>
  16. <body>
  17. <div class='wrapper'>
  18. <div class='pad1'>
  19. <h1><a href="../../index.html">All files</a> / <a href="index.html">music-core/utils</a> KeyUtils.ts</h1>
  20. <div class='clearfix'>
  21. <div class='fl pad1y space-right2'>
  22. <span class="strong">97.72% </span>
  23. <span class="quiet">Statements</span>
  24. <span class='fraction'>301/308</span>
  25. </div>
  26. <div class='fl pad1y space-right2'>
  27. <span class="strong">86% </span>
  28. <span class="quiet">Branches</span>
  29. <span class='fraction'>43/50</span>
  30. </div>
  31. <div class='fl pad1y space-right2'>
  32. <span class="strong">100% </span>
  33. <span class="quiet">Functions</span>
  34. <span class='fraction'>11/11</span>
  35. </div>
  36. <div class='fl pad1y space-right2'>
  37. <span class="strong">97.72% </span>
  38. <span class="quiet">Lines</span>
  39. <span class='fraction'>301/308</span>
  40. </div>
  41. </div>
  42. <p class="quiet">
  43. Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
  44. </p>
  45. <template id="filterTemplate">
  46. <div class="quiet">
  47. Filter:
  48. <input type="search" id="fileSearch">
  49. </div>
  50. </template>
  51. </div>
  52. <div class='status-line high'></div>
  53. <pre><table class="coverage">
  54. <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
  55. <a name='L2'></a><a href='#L2'>2</a>
  56. <a name='L3'></a><a href='#L3'>3</a>
  57. <a name='L4'></a><a href='#L4'>4</a>
  58. <a name='L5'></a><a href='#L5'>5</a>
  59. <a name='L6'></a><a href='#L6'>6</a>
  60. <a name='L7'></a><a href='#L7'>7</a>
  61. <a name='L8'></a><a href='#L8'>8</a>
  62. <a name='L9'></a><a href='#L9'>9</a>
  63. <a name='L10'></a><a href='#L10'>10</a>
  64. <a name='L11'></a><a href='#L11'>11</a>
  65. <a name='L12'></a><a href='#L12'>12</a>
  66. <a name='L13'></a><a href='#L13'>13</a>
  67. <a name='L14'></a><a href='#L14'>14</a>
  68. <a name='L15'></a><a href='#L15'>15</a>
  69. <a name='L16'></a><a href='#L16'>16</a>
  70. <a name='L17'></a><a href='#L17'>17</a>
  71. <a name='L18'></a><a href='#L18'>18</a>
  72. <a name='L19'></a><a href='#L19'>19</a>
  73. <a name='L20'></a><a href='#L20'>20</a>
  74. <a name='L21'></a><a href='#L21'>21</a>
  75. <a name='L22'></a><a href='#L22'>22</a>
  76. <a name='L23'></a><a href='#L23'>23</a>
  77. <a name='L24'></a><a href='#L24'>24</a>
  78. <a name='L25'></a><a href='#L25'>25</a>
  79. <a name='L26'></a><a href='#L26'>26</a>
  80. <a name='L27'></a><a href='#L27'>27</a>
  81. <a name='L28'></a><a href='#L28'>28</a>
  82. <a name='L29'></a><a href='#L29'>29</a>
  83. <a name='L30'></a><a href='#L30'>30</a>
  84. <a name='L31'></a><a href='#L31'>31</a>
  85. <a name='L32'></a><a href='#L32'>32</a>
  86. <a name='L33'></a><a href='#L33'>33</a>
  87. <a name='L34'></a><a href='#L34'>34</a>
  88. <a name='L35'></a><a href='#L35'>35</a>
  89. <a name='L36'></a><a href='#L36'>36</a>
  90. <a name='L37'></a><a href='#L37'>37</a>
  91. <a name='L38'></a><a href='#L38'>38</a>
  92. <a name='L39'></a><a href='#L39'>39</a>
  93. <a name='L40'></a><a href='#L40'>40</a>
  94. <a name='L41'></a><a href='#L41'>41</a>
  95. <a name='L42'></a><a href='#L42'>42</a>
  96. <a name='L43'></a><a href='#L43'>43</a>
  97. <a name='L44'></a><a href='#L44'>44</a>
  98. <a name='L45'></a><a href='#L45'>45</a>
  99. <a name='L46'></a><a href='#L46'>46</a>
  100. <a name='L47'></a><a href='#L47'>47</a>
  101. <a name='L48'></a><a href='#L48'>48</a>
  102. <a name='L49'></a><a href='#L49'>49</a>
  103. <a name='L50'></a><a href='#L50'>50</a>
  104. <a name='L51'></a><a href='#L51'>51</a>
  105. <a name='L52'></a><a href='#L52'>52</a>
  106. <a name='L53'></a><a href='#L53'>53</a>
  107. <a name='L54'></a><a href='#L54'>54</a>
  108. <a name='L55'></a><a href='#L55'>55</a>
  109. <a name='L56'></a><a href='#L56'>56</a>
  110. <a name='L57'></a><a href='#L57'>57</a>
  111. <a name='L58'></a><a href='#L58'>58</a>
  112. <a name='L59'></a><a href='#L59'>59</a>
  113. <a name='L60'></a><a href='#L60'>60</a>
  114. <a name='L61'></a><a href='#L61'>61</a>
  115. <a name='L62'></a><a href='#L62'>62</a>
  116. <a name='L63'></a><a href='#L63'>63</a>
  117. <a name='L64'></a><a href='#L64'>64</a>
  118. <a name='L65'></a><a href='#L65'>65</a>
  119. <a name='L66'></a><a href='#L66'>66</a>
  120. <a name='L67'></a><a href='#L67'>67</a>
  121. <a name='L68'></a><a href='#L68'>68</a>
  122. <a name='L69'></a><a href='#L69'>69</a>
  123. <a name='L70'></a><a href='#L70'>70</a>
  124. <a name='L71'></a><a href='#L71'>71</a>
  125. <a name='L72'></a><a href='#L72'>72</a>
  126. <a name='L73'></a><a href='#L73'>73</a>
  127. <a name='L74'></a><a href='#L74'>74</a>
  128. <a name='L75'></a><a href='#L75'>75</a>
  129. <a name='L76'></a><a href='#L76'>76</a>
  130. <a name='L77'></a><a href='#L77'>77</a>
  131. <a name='L78'></a><a href='#L78'>78</a>
  132. <a name='L79'></a><a href='#L79'>79</a>
  133. <a name='L80'></a><a href='#L80'>80</a>
  134. <a name='L81'></a><a href='#L81'>81</a>
  135. <a name='L82'></a><a href='#L82'>82</a>
  136. <a name='L83'></a><a href='#L83'>83</a>
  137. <a name='L84'></a><a href='#L84'>84</a>
  138. <a name='L85'></a><a href='#L85'>85</a>
  139. <a name='L86'></a><a href='#L86'>86</a>
  140. <a name='L87'></a><a href='#L87'>87</a>
  141. <a name='L88'></a><a href='#L88'>88</a>
  142. <a name='L89'></a><a href='#L89'>89</a>
  143. <a name='L90'></a><a href='#L90'>90</a>
  144. <a name='L91'></a><a href='#L91'>91</a>
  145. <a name='L92'></a><a href='#L92'>92</a>
  146. <a name='L93'></a><a href='#L93'>93</a>
  147. <a name='L94'></a><a href='#L94'>94</a>
  148. <a name='L95'></a><a href='#L95'>95</a>
  149. <a name='L96'></a><a href='#L96'>96</a>
  150. <a name='L97'></a><a href='#L97'>97</a>
  151. <a name='L98'></a><a href='#L98'>98</a>
  152. <a name='L99'></a><a href='#L99'>99</a>
  153. <a name='L100'></a><a href='#L100'>100</a>
  154. <a name='L101'></a><a href='#L101'>101</a>
  155. <a name='L102'></a><a href='#L102'>102</a>
  156. <a name='L103'></a><a href='#L103'>103</a>
  157. <a name='L104'></a><a href='#L104'>104</a>
  158. <a name='L105'></a><a href='#L105'>105</a>
  159. <a name='L106'></a><a href='#L106'>106</a>
  160. <a name='L107'></a><a href='#L107'>107</a>
  161. <a name='L108'></a><a href='#L108'>108</a>
  162. <a name='L109'></a><a href='#L109'>109</a>
  163. <a name='L110'></a><a href='#L110'>110</a>
  164. <a name='L111'></a><a href='#L111'>111</a>
  165. <a name='L112'></a><a href='#L112'>112</a>
  166. <a name='L113'></a><a href='#L113'>113</a>
  167. <a name='L114'></a><a href='#L114'>114</a>
  168. <a name='L115'></a><a href='#L115'>115</a>
  169. <a name='L116'></a><a href='#L116'>116</a>
  170. <a name='L117'></a><a href='#L117'>117</a>
  171. <a name='L118'></a><a href='#L118'>118</a>
  172. <a name='L119'></a><a href='#L119'>119</a>
  173. <a name='L120'></a><a href='#L120'>120</a>
  174. <a name='L121'></a><a href='#L121'>121</a>
  175. <a name='L122'></a><a href='#L122'>122</a>
  176. <a name='L123'></a><a href='#L123'>123</a>
  177. <a name='L124'></a><a href='#L124'>124</a>
  178. <a name='L125'></a><a href='#L125'>125</a>
  179. <a name='L126'></a><a href='#L126'>126</a>
  180. <a name='L127'></a><a href='#L127'>127</a>
  181. <a name='L128'></a><a href='#L128'>128</a>
  182. <a name='L129'></a><a href='#L129'>129</a>
  183. <a name='L130'></a><a href='#L130'>130</a>
  184. <a name='L131'></a><a href='#L131'>131</a>
  185. <a name='L132'></a><a href='#L132'>132</a>
  186. <a name='L133'></a><a href='#L133'>133</a>
  187. <a name='L134'></a><a href='#L134'>134</a>
  188. <a name='L135'></a><a href='#L135'>135</a>
  189. <a name='L136'></a><a href='#L136'>136</a>
  190. <a name='L137'></a><a href='#L137'>137</a>
  191. <a name='L138'></a><a href='#L138'>138</a>
  192. <a name='L139'></a><a href='#L139'>139</a>
  193. <a name='L140'></a><a href='#L140'>140</a>
  194. <a name='L141'></a><a href='#L141'>141</a>
  195. <a name='L142'></a><a href='#L142'>142</a>
  196. <a name='L143'></a><a href='#L143'>143</a>
  197. <a name='L144'></a><a href='#L144'>144</a>
  198. <a name='L145'></a><a href='#L145'>145</a>
  199. <a name='L146'></a><a href='#L146'>146</a>
  200. <a name='L147'></a><a href='#L147'>147</a>
  201. <a name='L148'></a><a href='#L148'>148</a>
  202. <a name='L149'></a><a href='#L149'>149</a>
  203. <a name='L150'></a><a href='#L150'>150</a>
  204. <a name='L151'></a><a href='#L151'>151</a>
  205. <a name='L152'></a><a href='#L152'>152</a>
  206. <a name='L153'></a><a href='#L153'>153</a>
  207. <a name='L154'></a><a href='#L154'>154</a>
  208. <a name='L155'></a><a href='#L155'>155</a>
  209. <a name='L156'></a><a href='#L156'>156</a>
  210. <a name='L157'></a><a href='#L157'>157</a>
  211. <a name='L158'></a><a href='#L158'>158</a>
  212. <a name='L159'></a><a href='#L159'>159</a>
  213. <a name='L160'></a><a href='#L160'>160</a>
  214. <a name='L161'></a><a href='#L161'>161</a>
  215. <a name='L162'></a><a href='#L162'>162</a>
  216. <a name='L163'></a><a href='#L163'>163</a>
  217. <a name='L164'></a><a href='#L164'>164</a>
  218. <a name='L165'></a><a href='#L165'>165</a>
  219. <a name='L166'></a><a href='#L166'>166</a>
  220. <a name='L167'></a><a href='#L167'>167</a>
  221. <a name='L168'></a><a href='#L168'>168</a>
  222. <a name='L169'></a><a href='#L169'>169</a>
  223. <a name='L170'></a><a href='#L170'>170</a>
  224. <a name='L171'></a><a href='#L171'>171</a>
  225. <a name='L172'></a><a href='#L172'>172</a>
  226. <a name='L173'></a><a href='#L173'>173</a>
  227. <a name='L174'></a><a href='#L174'>174</a>
  228. <a name='L175'></a><a href='#L175'>175</a>
  229. <a name='L176'></a><a href='#L176'>176</a>
  230. <a name='L177'></a><a href='#L177'>177</a>
  231. <a name='L178'></a><a href='#L178'>178</a>
  232. <a name='L179'></a><a href='#L179'>179</a>
  233. <a name='L180'></a><a href='#L180'>180</a>
  234. <a name='L181'></a><a href='#L181'>181</a>
  235. <a name='L182'></a><a href='#L182'>182</a>
  236. <a name='L183'></a><a href='#L183'>183</a>
  237. <a name='L184'></a><a href='#L184'>184</a>
  238. <a name='L185'></a><a href='#L185'>185</a>
  239. <a name='L186'></a><a href='#L186'>186</a>
  240. <a name='L187'></a><a href='#L187'>187</a>
  241. <a name='L188'></a><a href='#L188'>188</a>
  242. <a name='L189'></a><a href='#L189'>189</a>
  243. <a name='L190'></a><a href='#L190'>190</a>
  244. <a name='L191'></a><a href='#L191'>191</a>
  245. <a name='L192'></a><a href='#L192'>192</a>
  246. <a name='L193'></a><a href='#L193'>193</a>
  247. <a name='L194'></a><a href='#L194'>194</a>
  248. <a name='L195'></a><a href='#L195'>195</a>
  249. <a name='L196'></a><a href='#L196'>196</a>
  250. <a name='L197'></a><a href='#L197'>197</a>
  251. <a name='L198'></a><a href='#L198'>198</a>
  252. <a name='L199'></a><a href='#L199'>199</a>
  253. <a name='L200'></a><a href='#L200'>200</a>
  254. <a name='L201'></a><a href='#L201'>201</a>
  255. <a name='L202'></a><a href='#L202'>202</a>
  256. <a name='L203'></a><a href='#L203'>203</a>
  257. <a name='L204'></a><a href='#L204'>204</a>
  258. <a name='L205'></a><a href='#L205'>205</a>
  259. <a name='L206'></a><a href='#L206'>206</a>
  260. <a name='L207'></a><a href='#L207'>207</a>
  261. <a name='L208'></a><a href='#L208'>208</a>
  262. <a name='L209'></a><a href='#L209'>209</a>
  263. <a name='L210'></a><a href='#L210'>210</a>
  264. <a name='L211'></a><a href='#L211'>211</a>
  265. <a name='L212'></a><a href='#L212'>212</a>
  266. <a name='L213'></a><a href='#L213'>213</a>
  267. <a name='L214'></a><a href='#L214'>214</a>
  268. <a name='L215'></a><a href='#L215'>215</a>
  269. <a name='L216'></a><a href='#L216'>216</a>
  270. <a name='L217'></a><a href='#L217'>217</a>
  271. <a name='L218'></a><a href='#L218'>218</a>
  272. <a name='L219'></a><a href='#L219'>219</a>
  273. <a name='L220'></a><a href='#L220'>220</a>
  274. <a name='L221'></a><a href='#L221'>221</a>
  275. <a name='L222'></a><a href='#L222'>222</a>
  276. <a name='L223'></a><a href='#L223'>223</a>
  277. <a name='L224'></a><a href='#L224'>224</a>
  278. <a name='L225'></a><a href='#L225'>225</a>
  279. <a name='L226'></a><a href='#L226'>226</a>
  280. <a name='L227'></a><a href='#L227'>227</a>
  281. <a name='L228'></a><a href='#L228'>228</a>
  282. <a name='L229'></a><a href='#L229'>229</a>
  283. <a name='L230'></a><a href='#L230'>230</a>
  284. <a name='L231'></a><a href='#L231'>231</a>
  285. <a name='L232'></a><a href='#L232'>232</a>
  286. <a name='L233'></a><a href='#L233'>233</a>
  287. <a name='L234'></a><a href='#L234'>234</a>
  288. <a name='L235'></a><a href='#L235'>235</a>
  289. <a name='L236'></a><a href='#L236'>236</a>
  290. <a name='L237'></a><a href='#L237'>237</a>
  291. <a name='L238'></a><a href='#L238'>238</a>
  292. <a name='L239'></a><a href='#L239'>239</a>
  293. <a name='L240'></a><a href='#L240'>240</a>
  294. <a name='L241'></a><a href='#L241'>241</a>
  295. <a name='L242'></a><a href='#L242'>242</a>
  296. <a name='L243'></a><a href='#L243'>243</a>
  297. <a name='L244'></a><a href='#L244'>244</a>
  298. <a name='L245'></a><a href='#L245'>245</a>
  299. <a name='L246'></a><a href='#L246'>246</a>
  300. <a name='L247'></a><a href='#L247'>247</a>
  301. <a name='L248'></a><a href='#L248'>248</a>
  302. <a name='L249'></a><a href='#L249'>249</a>
  303. <a name='L250'></a><a href='#L250'>250</a>
  304. <a name='L251'></a><a href='#L251'>251</a>
  305. <a name='L252'></a><a href='#L252'>252</a>
  306. <a name='L253'></a><a href='#L253'>253</a>
  307. <a name='L254'></a><a href='#L254'>254</a>
  308. <a name='L255'></a><a href='#L255'>255</a>
  309. <a name='L256'></a><a href='#L256'>256</a>
  310. <a name='L257'></a><a href='#L257'>257</a>
  311. <a name='L258'></a><a href='#L258'>258</a>
  312. <a name='L259'></a><a href='#L259'>259</a>
  313. <a name='L260'></a><a href='#L260'>260</a>
  314. <a name='L261'></a><a href='#L261'>261</a>
  315. <a name='L262'></a><a href='#L262'>262</a>
  316. <a name='L263'></a><a href='#L263'>263</a>
  317. <a name='L264'></a><a href='#L264'>264</a>
  318. <a name='L265'></a><a href='#L265'>265</a>
  319. <a name='L266'></a><a href='#L266'>266</a>
  320. <a name='L267'></a><a href='#L267'>267</a>
  321. <a name='L268'></a><a href='#L268'>268</a>
  322. <a name='L269'></a><a href='#L269'>269</a>
  323. <a name='L270'></a><a href='#L270'>270</a>
  324. <a name='L271'></a><a href='#L271'>271</a>
  325. <a name='L272'></a><a href='#L272'>272</a>
  326. <a name='L273'></a><a href='#L273'>273</a>
  327. <a name='L274'></a><a href='#L274'>274</a>
  328. <a name='L275'></a><a href='#L275'>275</a>
  329. <a name='L276'></a><a href='#L276'>276</a>
  330. <a name='L277'></a><a href='#L277'>277</a>
  331. <a name='L278'></a><a href='#L278'>278</a>
  332. <a name='L279'></a><a href='#L279'>279</a>
  333. <a name='L280'></a><a href='#L280'>280</a>
  334. <a name='L281'></a><a href='#L281'>281</a>
  335. <a name='L282'></a><a href='#L282'>282</a>
  336. <a name='L283'></a><a href='#L283'>283</a>
  337. <a name='L284'></a><a href='#L284'>284</a>
  338. <a name='L285'></a><a href='#L285'>285</a>
  339. <a name='L286'></a><a href='#L286'>286</a>
  340. <a name='L287'></a><a href='#L287'>287</a>
  341. <a name='L288'></a><a href='#L288'>288</a>
  342. <a name='L289'></a><a href='#L289'>289</a>
  343. <a name='L290'></a><a href='#L290'>290</a>
  344. <a name='L291'></a><a href='#L291'>291</a>
  345. <a name='L292'></a><a href='#L292'>292</a>
  346. <a name='L293'></a><a href='#L293'>293</a>
  347. <a name='L294'></a><a href='#L294'>294</a>
  348. <a name='L295'></a><a href='#L295'>295</a>
  349. <a name='L296'></a><a href='#L296'>296</a>
  350. <a name='L297'></a><a href='#L297'>297</a>
  351. <a name='L298'></a><a href='#L298'>298</a>
  352. <a name='L299'></a><a href='#L299'>299</a>
  353. <a name='L300'></a><a href='#L300'>300</a>
  354. <a name='L301'></a><a href='#L301'>301</a>
  355. <a name='L302'></a><a href='#L302'>302</a>
  356. <a name='L303'></a><a href='#L303'>303</a>
  357. <a name='L304'></a><a href='#L304'>304</a>
  358. <a name='L305'></a><a href='#L305'>305</a>
  359. <a name='L306'></a><a href='#L306'>306</a>
  360. <a name='L307'></a><a href='#L307'>307</a>
  361. <a name='L308'></a><a href='#L308'>308</a>
  362. <a name='L309'></a><a href='#L309'>309</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
  363. <span class="cline-any cline-yes">1x</span>
  364. <span class="cline-any cline-yes">1x</span>
  365. <span class="cline-any cline-yes">1x</span>
  366. <span class="cline-any cline-yes">1x</span>
  367. <span class="cline-any cline-yes">1x</span>
  368. <span class="cline-any cline-yes">1x</span>
  369. <span class="cline-any cline-yes">1x</span>
  370. <span class="cline-any cline-yes">1x</span>
  371. <span class="cline-any cline-yes">1x</span>
  372. <span class="cline-any cline-yes">1x</span>
  373. <span class="cline-any cline-yes">1x</span>
  374. <span class="cline-any cline-yes">1x</span>
  375. <span class="cline-any cline-yes">1x</span>
  376. <span class="cline-any cline-yes">1x</span>
  377. <span class="cline-any cline-yes">1x</span>
  378. <span class="cline-any cline-yes">1x</span>
  379. <span class="cline-any cline-yes">1x</span>
  380. <span class="cline-any cline-yes">1x</span>
  381. <span class="cline-any cline-yes">1x</span>
  382. <span class="cline-any cline-yes">1x</span>
  383. <span class="cline-any cline-yes">1x</span>
  384. <span class="cline-any cline-yes">1x</span>
  385. <span class="cline-any cline-yes">1x</span>
  386. <span class="cline-any cline-yes">1x</span>
  387. <span class="cline-any cline-yes">1x</span>
  388. <span class="cline-any cline-yes">1x</span>
  389. <span class="cline-any cline-yes">1x</span>
  390. <span class="cline-any cline-yes">1x</span>
  391. <span class="cline-any cline-yes">1x</span>
  392. <span class="cline-any cline-yes">1x</span>
  393. <span class="cline-any cline-yes">1x</span>
  394. <span class="cline-any cline-yes">1x</span>
  395. <span class="cline-any cline-yes">1x</span>
  396. <span class="cline-any cline-yes">1x</span>
  397. <span class="cline-any cline-yes">1x</span>
  398. <span class="cline-any cline-yes">1x</span>
  399. <span class="cline-any cline-yes">1x</span>
  400. <span class="cline-any cline-yes">1x</span>
  401. <span class="cline-any cline-yes">1x</span>
  402. <span class="cline-any cline-yes">1x</span>
  403. <span class="cline-any cline-yes">1x</span>
  404. <span class="cline-any cline-yes">1x</span>
  405. <span class="cline-any cline-yes">1x</span>
  406. <span class="cline-any cline-yes">1x</span>
  407. <span class="cline-any cline-yes">1x</span>
  408. <span class="cline-any cline-yes">1x</span>
  409. <span class="cline-any cline-yes">1x</span>
  410. <span class="cline-any cline-yes">1x</span>
  411. <span class="cline-any cline-yes">1x</span>
  412. <span class="cline-any cline-yes">1x</span>
  413. <span class="cline-any cline-yes">1x</span>
  414. <span class="cline-any cline-yes">1x</span>
  415. <span class="cline-any cline-yes">1x</span>
  416. <span class="cline-any cline-yes">1x</span>
  417. <span class="cline-any cline-yes">1x</span>
  418. <span class="cline-any cline-yes">1x</span>
  419. <span class="cline-any cline-yes">1x</span>
  420. <span class="cline-any cline-yes">1x</span>
  421. <span class="cline-any cline-yes">1x</span>
  422. <span class="cline-any cline-yes">1x</span>
  423. <span class="cline-any cline-yes">1x</span>
  424. <span class="cline-any cline-yes">1x</span>
  425. <span class="cline-any cline-yes">4x</span>
  426. <span class="cline-any cline-yes">4x</span>
  427. <span class="cline-any cline-yes">4x</span>
  428. <span class="cline-any cline-yes">4x</span>
  429. <span class="cline-any cline-yes">4x</span>
  430. <span class="cline-any cline-yes">4x</span>
  431. <span class="cline-any cline-yes">4x</span>
  432. <span class="cline-any cline-yes">3x</span>
  433. <span class="cline-any cline-yes">3x</span>
  434. <span class="cline-any cline-yes">4x</span>
  435. <span class="cline-any cline-yes">1x</span>
  436. <span class="cline-any cline-yes">1x</span>
  437. <span class="cline-any cline-yes">1x</span>
  438. <span class="cline-any cline-no">&nbsp;</span>
  439. <span class="cline-any cline-no">&nbsp;</span>
  440. <span class="cline-any cline-no">&nbsp;</span>
  441. <span class="cline-any cline-yes">4x</span>
  442. <span class="cline-any cline-yes">4x</span>
  443. <span class="cline-any cline-yes">4x</span>
  444. <span class="cline-any cline-yes">4x</span>
  445. <span class="cline-any cline-yes">4x</span>
  446. <span class="cline-any cline-yes">4x</span>
  447. <span class="cline-any cline-yes">4x</span>
  448. <span class="cline-any cline-yes">4x</span>
  449. <span class="cline-any cline-yes">4x</span>
  450. <span class="cline-any cline-yes">4x</span>
  451. <span class="cline-any cline-yes">1x</span>
  452. <span class="cline-any cline-yes">1x</span>
  453. <span class="cline-any cline-yes">1x</span>
  454. <span class="cline-any cline-yes">1x</span>
  455. <span class="cline-any cline-yes">1x</span>
  456. <span class="cline-any cline-yes">1x</span>
  457. <span class="cline-any cline-yes">1x</span>
  458. <span class="cline-any cline-yes">6x</span>
  459. <span class="cline-any cline-yes">6x</span>
  460. <span class="cline-any cline-yes">1x</span>
  461. <span class="cline-any cline-yes">1x</span>
  462. <span class="cline-any cline-yes">1x</span>
  463. <span class="cline-any cline-yes">1x</span>
  464. <span class="cline-any cline-yes">1x</span>
  465. <span class="cline-any cline-yes">1x</span>
  466. <span class="cline-any cline-yes">1x</span>
  467. <span class="cline-any cline-yes">1x</span>
  468. <span class="cline-any cline-yes">10x</span>
  469. <span class="cline-any cline-yes">10x</span>
  470. <span class="cline-any cline-yes">10x</span>
  471. <span class="cline-any cline-yes">2x</span>
  472. <span class="cline-any cline-yes">2x</span>
  473. <span class="cline-any cline-yes">8x</span>
  474. <span class="cline-any cline-yes">8x</span>
  475. <span class="cline-any cline-yes">10x</span>
  476. <span class="cline-any cline-yes">10x</span>
  477. <span class="cline-any cline-yes">10x</span>
  478. <span class="cline-any cline-yes">10x</span>
  479. <span class="cline-any cline-yes">71x</span>
  480. <span class="cline-any cline-yes">71x</span>
  481. <span class="cline-any cline-yes">8x</span>
  482. <span class="cline-any cline-yes">8x</span>
  483. <span class="cline-any cline-yes">71x</span>
  484. <span class="cline-any cline-no">&nbsp;</span>
  485. <span class="cline-any cline-no">&nbsp;</span>
  486. <span class="cline-any cline-no">&nbsp;</span>
  487. <span class="cline-any cline-yes">1x</span>
  488. <span class="cline-any cline-yes">1x</span>
  489. <span class="cline-any cline-yes">1x</span>
  490. <span class="cline-any cline-yes">1x</span>
  491. <span class="cline-any cline-yes">1x</span>
  492. <span class="cline-any cline-yes">1x</span>
  493. <span class="cline-any cline-yes">1x</span>
  494. <span class="cline-any cline-yes">1x</span>
  495. <span class="cline-any cline-yes">7x</span>
  496. <span class="cline-any cline-yes">7x</span>
  497. <span class="cline-any cline-yes">7x</span>
  498. <span class="cline-any cline-yes">7x</span>
  499. <span class="cline-any cline-yes">7x</span>
  500. <span class="cline-any cline-yes">7x</span>
  501. <span class="cline-any cline-yes">7x</span>
  502. <span class="cline-any cline-yes">7x</span>
  503. <span class="cline-any cline-yes">7x</span>
  504. <span class="cline-any cline-yes">7x</span>
  505. <span class="cline-any cline-yes">7x</span>
  506. <span class="cline-any cline-yes">7x</span>
  507. <span class="cline-any cline-yes">7x</span>
  508. <span class="cline-any cline-yes">7x</span>
  509. <span class="cline-any cline-yes">56x</span>
  510. <span class="cline-any cline-yes">56x</span>
  511. <span class="cline-any cline-yes">56x</span>
  512. <span class="cline-any cline-yes">56x</span>
  513. <span class="cline-any cline-yes">7x</span>
  514. <span class="cline-any cline-yes">7x</span>
  515. <span class="cline-any cline-yes">56x</span>
  516. <span class="cline-any cline-yes">56x</span>
  517. <span class="cline-any cline-yes">56x</span>
  518. <span class="cline-any cline-yes">56x</span>
  519. <span class="cline-any cline-yes">7x</span>
  520. <span class="cline-any cline-yes">7x</span>
  521. <span class="cline-any cline-yes">7x</span>
  522. <span class="cline-any cline-yes">1x</span>
  523. <span class="cline-any cline-yes">1x</span>
  524. <span class="cline-any cline-yes">1x</span>
  525. <span class="cline-any cline-yes">1x</span>
  526. <span class="cline-any cline-yes">1x</span>
  527. <span class="cline-any cline-yes">1x</span>
  528. <span class="cline-any cline-yes">1x</span>
  529. <span class="cline-any cline-yes">1x</span>
  530. <span class="cline-any cline-yes">2x</span>
  531. <span class="cline-any cline-yes">2x</span>
  532. <span class="cline-any cline-yes">2x</span>
  533. <span class="cline-any cline-yes">2x</span>
  534. <span class="cline-any cline-yes">2x</span>
  535. <span class="cline-any cline-yes">2x</span>
  536. <span class="cline-any cline-yes">2x</span>
  537. <span class="cline-any cline-yes">2x</span>
  538. <span class="cline-any cline-yes">2x</span>
  539. <span class="cline-any cline-yes">16x</span>
  540. <span class="cline-any cline-yes">16x</span>
  541. <span class="cline-any cline-yes">16x</span>
  542. <span class="cline-any cline-yes">16x</span>
  543. <span class="cline-any cline-yes">16x</span>
  544. <span class="cline-any cline-yes">16x</span>
  545. <span class="cline-any cline-yes">2x</span>
  546. <span class="cline-any cline-yes">2x</span>
  547. <span class="cline-any cline-yes">2x</span>
  548. <span class="cline-any cline-yes">1x</span>
  549. <span class="cline-any cline-yes">1x</span>
  550. <span class="cline-any cline-yes">1x</span>
  551. <span class="cline-any cline-yes">1x</span>
  552. <span class="cline-any cline-yes">1x</span>
  553. <span class="cline-any cline-yes">1x</span>
  554. <span class="cline-any cline-yes">1x</span>
  555. <span class="cline-any cline-yes">1x</span>
  556. <span class="cline-any cline-yes">1x</span>
  557. <span class="cline-any cline-yes">1x</span>
  558. <span class="cline-any cline-yes">4x</span>
  559. <span class="cline-any cline-yes">4x</span>
  560. <span class="cline-any cline-yes">4x</span>
  561. <span class="cline-any cline-yes">4x</span>
  562. <span class="cline-any cline-yes">4x</span>
  563. <span class="cline-any cline-yes">2x</span>
  564. <span class="cline-any cline-no">&nbsp;</span>
  565. <span class="cline-any cline-yes">4x</span>
  566. <span class="cline-any cline-yes">1x</span>
  567. <span class="cline-any cline-yes">1x</span>
  568. <span class="cline-any cline-yes">1x</span>
  569. <span class="cline-any cline-yes">1x</span>
  570. <span class="cline-any cline-yes">1x</span>
  571. <span class="cline-any cline-yes">1x</span>
  572. <span class="cline-any cline-yes">1x</span>
  573. <span class="cline-any cline-yes">1x</span>
  574. <span class="cline-any cline-yes">1x</span>
  575. <span class="cline-any cline-yes">1x</span>
  576. <span class="cline-any cline-yes">3x</span>
  577. <span class="cline-any cline-yes">3x</span>
  578. <span class="cline-any cline-yes">3x</span>
  579. <span class="cline-any cline-yes">3x</span>
  580. <span class="cline-any cline-yes">3x</span>
  581. <span class="cline-any cline-yes">3x</span>
  582. <span class="cline-any cline-yes">3x</span>
  583. <span class="cline-any cline-yes">3x</span>
  584. <span class="cline-any cline-yes">2x</span>
  585. <span class="cline-any cline-yes">2x</span>
  586. <span class="cline-any cline-yes">3x</span>
  587. <span class="cline-any cline-yes">1x</span>
  588. <span class="cline-any cline-yes">1x</span>
  589. <span class="cline-any cline-yes">1x</span>
  590. <span class="cline-any cline-yes">1x</span>
  591. <span class="cline-any cline-yes">1x</span>
  592. <span class="cline-any cline-yes">1x</span>
  593. <span class="cline-any cline-yes">1x</span>
  594. <span class="cline-any cline-yes">1x</span>
  595. <span class="cline-any cline-yes">4x</span>
  596. <span class="cline-any cline-yes">4x</span>
  597. <span class="cline-any cline-yes">4x</span>
  598. <span class="cline-any cline-yes">4x</span>
  599. <span class="cline-any cline-yes">4x</span>
  600. <span class="cline-any cline-yes">4x</span>
  601. <span class="cline-any cline-yes">4x</span>
  602. <span class="cline-any cline-yes">4x</span>
  603. <span class="cline-any cline-yes">4x</span>
  604. <span class="cline-any cline-yes">4x</span>
  605. <span class="cline-any cline-yes">4x</span>
  606. <span class="cline-any cline-yes">1x</span>
  607. <span class="cline-any cline-yes">1x</span>
  608. <span class="cline-any cline-yes">1x</span>
  609. <span class="cline-any cline-yes">1x</span>
  610. <span class="cline-any cline-yes">1x</span>
  611. <span class="cline-any cline-yes">1x</span>
  612. <span class="cline-any cline-yes">1x</span>
  613. <span class="cline-any cline-yes">1x</span>
  614. <span class="cline-any cline-yes">1x</span>
  615. <span class="cline-any cline-yes">1x</span>
  616. <span class="cline-any cline-yes">1x</span>
  617. <span class="cline-any cline-yes">1x</span>
  618. <span class="cline-any cline-yes">1x</span>
  619. <span class="cline-any cline-yes">1x</span>
  620. <span class="cline-any cline-yes">1x</span>
  621. <span class="cline-any cline-yes">1x</span>
  622. <span class="cline-any cline-yes">1x</span>
  623. <span class="cline-any cline-yes">1x</span>
  624. <span class="cline-any cline-yes">7x</span>
  625. <span class="cline-any cline-yes">7x</span>
  626. <span class="cline-any cline-yes">7x</span>
  627. <span class="cline-any cline-yes">7x</span>
  628. <span class="cline-any cline-yes">1x</span>
  629. <span class="cline-any cline-yes">1x</span>
  630. <span class="cline-any cline-yes">1x</span>
  631. <span class="cline-any cline-yes">1x</span>
  632. <span class="cline-any cline-yes">1x</span>
  633. <span class="cline-any cline-yes">1x</span>
  634. <span class="cline-any cline-yes">1x</span>
  635. <span class="cline-any cline-yes">1x</span>
  636. <span class="cline-any cline-yes">1x</span>
  637. <span class="cline-any cline-yes">1x</span>
  638. <span class="cline-any cline-yes">1x</span>
  639. <span class="cline-any cline-yes">6x</span>
  640. <span class="cline-any cline-yes">6x</span>
  641. <span class="cline-any cline-yes">6x</span>
  642. <span class="cline-any cline-yes">6x</span>
  643. <span class="cline-any cline-yes">6x</span>
  644. <span class="cline-any cline-yes">1x</span>
  645. <span class="cline-any cline-yes">1x</span>
  646. <span class="cline-any cline-yes">1x</span>
  647. <span class="cline-any cline-yes">1x</span>
  648. <span class="cline-any cline-yes">1x</span>
  649. <span class="cline-any cline-yes">1x</span>
  650. <span class="cline-any cline-yes">1x</span>
  651. <span class="cline-any cline-yes">1x</span>
  652. <span class="cline-any cline-yes">5x</span>
  653. <span class="cline-any cline-yes">5x</span>
  654. <span class="cline-any cline-yes">5x</span>
  655. <span class="cline-any cline-yes">5x</span>
  656. <span class="cline-any cline-yes">5x</span>
  657. <span class="cline-any cline-yes">5x</span>
  658. <span class="cline-any cline-yes">5x</span>
  659. <span class="cline-any cline-yes">5x</span>
  660. <span class="cline-any cline-yes">5x</span>
  661. <span class="cline-any cline-yes">5x</span>
  662. <span class="cline-any cline-yes">5x</span>
  663. <span class="cline-any cline-yes">5x</span>
  664. <span class="cline-any cline-yes">5x</span>
  665. <span class="cline-any cline-yes">5x</span>
  666. <span class="cline-any cline-yes">5x</span>
  667. <span class="cline-any cline-yes">5x</span>
  668. <span class="cline-any cline-yes">5x</span>
  669. <span class="cline-any cline-yes">5x</span>
  670. <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/**
  671. * @file 调号工具函数
  672. * @description 提供调号相关的计算和转换
  673. */
  674. &nbsp;
  675. import { StepName, KeyMode } from '../models/types';
  676. import { getKeyTonic, getKeyAlterations, getMidiPitch } from './PitchUtils';
  677. &nbsp;
  678. /**
  679. * 调号信息
  680. */
  681. export interface KeyInfo {
  682. /** 五度圈位置 */
  683. fifths: number;
  684. /** 调式 */
  685. mode: KeyMode;
  686. /** 主音 */
  687. tonic: { step: StepName; alter?: number };
  688. /** 调号中的升降音 */
  689. alterations: { step: StepName; alter: number }[];
  690. /** 调号名称(中文) */
  691. name: string;
  692. /** 关系大小调 */
  693. relative?: { fifths: number; mode: KeyMode };
  694. }
  695. &nbsp;
  696. /**
  697. * 大调名称映射
  698. */
  699. const MAJOR_KEY_NAMES: Record&lt;number, string&gt; = {
  700. [-7]: 'Cb大调', [-6]: 'Gb大调', [-5]: 'Db大调', [-4]: 'Ab大调',
  701. [-3]: 'Eb大调', [-2]: 'Bb大调', [-1]: 'F大调', [0]: 'C大调',
  702. [1]: 'G大调', [2]: 'D大调', [3]: 'A大调', [4]: 'E大调',
  703. [5]: 'B大调', [6]: 'F#大调', [7]: 'C#大调'
  704. };
  705. &nbsp;
  706. /**
  707. * 小调名称映射
  708. */
  709. const MINOR_KEY_NAMES: Record&lt;number, string&gt; = {
  710. [-7]: 'ab小调', [-6]: 'eb小调', [-5]: 'bb小调', [-4]: 'f小调',
  711. [-3]: 'c小调', [-2]: 'g小调', [-1]: 'd小调', [0]: 'a小调',
  712. [1]: 'e小调', [2]: 'b小调', [3]: 'f#小调', [4]: 'c#小调',
  713. [5]: 'g#小调', [6]: 'd#小调', [7]: 'a#小调'
  714. };
  715. &nbsp;
  716. /**
  717. * 简谱调号名称(1=X)
  718. */
  719. const JIANPU_KEY_NAMES: Record&lt;number, string&gt; = {
  720. [-7]: '1=Cb', [-6]: '1=Gb', [-5]: '1=Db', [-4]: '1=Ab',
  721. [-3]: '1=bE', [-2]: '1=bB', [-1]: '1=F', [0]: '1=C',
  722. [1]: '1=G', [2]: '1=D', [3]: '1=A', [4]: '1=E',
  723. [5]: '1=B', [6]: '1=#F', [7]: '1=#C'
  724. };
  725. &nbsp;
  726. /**
  727. * 获取调号的完整信息
  728. * @param fifths 五度圈位置
  729. * @param mode 调式(默认大调)
  730. * @returns 调号信息
  731. */
  732. export function getKeyInfo(fifths: number, mode: KeyMode = 'major'): KeyInfo {
  733. const tonic = getKeyTonic(fifths);
  734. const alterations = getKeyAlterations(fifths);
  735. let name: string;
  736. let relative: { fifths: number; mode: KeyMode } | undefined;
  737. if (mode === 'major') {
  738. name = MAJOR_KEY_NAMES[fifths<span class="branch-0 cbranch-no" title="branch not covered" >] ?? `${fifths}个升降号大调`;</span>
  739. relative = { fifths, mode: 'minor' }; // 关系小调
  740. } else if (mode === 'minor') {
  741. name = MINOR_KEY_NAMES[fifths<span class="branch-0 cbranch-no" title="branch not covered" >] ?? `${fifths}个升降号小调`;</span>
  742. relative = { fifths, mode: 'major' }; // 关系大调
  743. <span class="branch-0 cbranch-no" title="branch not covered" > } else {</span>
  744. <span class="cstat-no" title="statement not covered" > // 其他调式</span>
  745. <span class="cstat-no" title="statement not covered" > name = `${tonic.step}${tonic.alter === 1 ? '#' : tonic.alter === -1 ? 'b' : ''} ${mode}`;</span>
  746. <span class="cstat-no" title="statement not covered" > }</span>
  747. return {
  748. fifths,
  749. mode,
  750. tonic,
  751. alterations,
  752. name,
  753. relative
  754. };
  755. }
  756. &nbsp;
  757. /**
  758. * 获取简谱调号标记
  759. * @param fifths 五度圈位置
  760. * @returns 如 "1=C", "1=G", "1=bB"
  761. */
  762. export function getJianpuKeyName(fifths: number): string {
  763. return JIANPU_KEY_NAMES[fifths<span class="branch-0 cbranch-no" title="branch not covered" >] ?? `1=${getKeyTonic(fifths).step}`;</span>
  764. }
  765. &nbsp;
  766. /**
  767. * 从调名获取五度圈位置
  768. * @param keyName 调名(如 "C", "G", "Bb", "F#")
  769. * @param mode 调式
  770. * @returns 五度圈位置
  771. */
  772. export function getKeyFifths(keyName: string, mode: KeyMode = 'major'): number {
  773. // 解析调名
  774. const match = keyName.match(/^([A-G])([#b])?$/i);
  775. if (!match) {
  776. throw new Error(`Invalid key name: ${keyName}`);
  777. }
  778. const step = match[1].toUpperCase() as StepName;
  779. const alter = match[2] === '#' ? 1 : match[2] === 'b' ? -1 : 0;
  780. // 根据主音找五度圈位置
  781. for (let fifths = -7; fifths &lt;= 7; fifths++) {
  782. const tonic = getKeyTonic(fifths);
  783. if (tonic.step === step &amp;&amp; (tonic.alter ?? 0) === alter) {
  784. return fifths;
  785. }
  786. <span class="branch-0 cbranch-no" title="branch not covered" > }</span>
  787. <span class="cstat-no" title="statement not covered" > </span>
  788. <span class="cstat-no" title="statement not covered" > throw new Error(`Key not found: ${keyName}`);</span>
  789. <span class="cstat-no" title="statement not covered" >}</span>
  790. &nbsp;
  791. /**
  792. * 获取调内音阶(大调)
  793. * @param fifths 五度圈位置
  794. * @param octave 起始八度
  795. * @returns 音阶音符数组
  796. */
  797. export function getMajorScale(
  798. fifths: number,
  799. octave: number
  800. ): { step: StepName; octave: number; alter: number }[] {
  801. const scale: { step: StepName; octave: number; alter: number }[] = [];
  802. const tonic = getKeyTonic(fifths);
  803. const alterations = getKeyAlterations(fifths);
  804. const alterMap = new Map(alterations.map(a =&gt; [a.step, a.alter]));
  805. // 大调音阶:全全半全全全半
  806. const steps: StepName[] = ['C', 'D', 'E', 'F', 'G', 'A', 'B'];
  807. const tonicIndex = steps.indexOf(tonic.step);
  808. let currentOctave = octave;
  809. for (let i = 0; i &lt; 8; i++) {
  810. const stepIndex = (tonicIndex + i) % 7;
  811. const step = steps[stepIndex];
  812. if (i &gt; 0 &amp;&amp; stepIndex === 0) {
  813. currentOctave++;
  814. }
  815. const alter = alterMap.get(step) ?? 0;
  816. scale.push({ step, octave: currentOctave, alter });
  817. }
  818. return scale;
  819. }
  820. &nbsp;
  821. /**
  822. * 获取调内音阶(自然小调)
  823. * @param fifths 五度圈位置
  824. * @param octave 起始八度
  825. * @returns 音阶音符数组
  826. */
  827. export function getNaturalMinorScale(
  828. fifths: number,
  829. octave: number
  830. ): { step: StepName; octave: number; alter: number }[] {
  831. // 自然小调 = 关系大调从第6级开始
  832. const scale = getMajorScale(fifths, octave);
  833. // 重新排列,从第6级开始(la = 6)
  834. const minorScale = [];
  835. for (let i = 5; i &lt; 5 + 8; i++) {
  836. const note = scale[i % 7];
  837. minorScale.push({
  838. ...note,
  839. octave: note.octave + (i &gt;= 7 ? 1 : 0)
  840. });
  841. }
  842. return minorScale;
  843. }
  844. &nbsp;
  845. /**
  846. * 判断两个调是否为关系大小调
  847. * @param fifths1 调1的五度圈位置
  848. * @param mode1 调1的调式
  849. * @param fifths2 调2的五度圈位置
  850. * @param mode2 调2的调式
  851. * @returns 是否为关系大小调
  852. */
  853. export function areRelativeKeys(
  854. fifths1: number, mode1: KeyMode,
  855. fifths2: number, mode2: KeyMode
  856. ): boolean {
  857. // 关系大小调有相同的五度圈位置,但调式不同
  858. return fifths1 === fifths2 &amp;&amp; mode1 !== mode2 &amp;&amp;
  859. ((mode1 === 'major' &amp;&amp; mode2 === <span class="branch-0 cbranch-no" title="branch not covered" >'minor') || </span>
  860. <span class="cstat-no" title="statement not covered" > (mode1 === 'minor' &amp;&amp; mode2 === 'major'));</span>
  861. }
  862. &nbsp;
  863. /**
  864. * 判断两个调是否为同主音大小调
  865. * @param fifths1 调1的五度圈位置
  866. * @param mode1 调1的调式
  867. * @param fifths2 调2的五度圈位置
  868. * @param mode2 调2的调式
  869. * @returns 是否为同主音大小调
  870. */
  871. export function areParallelKeys(
  872. fifths1: number, mode1: KeyMode,
  873. fifths2: number, mode2: KeyMode
  874. ): boolean {
  875. // 同主音大小调有相同的主音,但调式不同
  876. const tonic1 = getKeyTonic(fifths1);
  877. const tonic2 = getKeyTonic(fifths2);
  878. return tonic1.step === tonic2.step &amp;&amp;
  879. (tonic1.alter ?? 0) === (tonic2.alter ?? 0) &amp;&amp;
  880. mode1 !== mode2;
  881. }
  882. &nbsp;
  883. /**
  884. * 计算两个调之间的转调关系
  885. * @param fromFifths 起始调
  886. * @param toFifths 目标调
  887. * @returns 转调信息
  888. */
  889. export function getModulationInfo(
  890. fromFifths: number,
  891. toFifths: number
  892. ): { distance: number; direction: 'sharp' | 'flat' | 'none'; isNear: boolean } {
  893. const distance = toFifths - fromFifths;
  894. const direction = distance &gt; 0 ? 'sharp' : distance &lt; 0 ? 'flat' : 'none';
  895. // 近关系调:五度圈上相差 ±1
  896. const isNear = Math.abs(distance) &lt;= 1;
  897. return { distance, direction, isNear };
  898. }
  899. &nbsp;
  900. /**
  901. * 获取调内和弦(大调)
  902. * @param fifths 五度圈位置
  903. * @returns 级数和弦数组
  904. */
  905. export function getDiatonicChords(fifths: number): {
  906. degree: number;
  907. root: { step: StepName; alter: number };
  908. quality: 'major' | 'minor' | 'diminished';
  909. romanNumeral: string;
  910. }[] {
  911. const scale = getMajorScale(fifths, 4);
  912. const qualities: ('major' | 'minor' | 'diminished')[] =
  913. ['major', 'minor', 'minor', 'major', 'major', 'minor', 'diminished'];
  914. const romanNumerals = ['I', 'ii', 'iii', 'IV', 'V', 'vi', 'vii°'];
  915. return scale.slice(0, 7).map((note, i) =&gt; ({
  916. degree: i + 1,
  917. root: { step: note.step, alter: note.alter },
  918. quality: qualities[i],
  919. romanNumeral: romanNumerals[i]
  920. }));
  921. }
  922. &nbsp;
  923. /**
  924. * 检查音符是否需要临时记号
  925. * @param step 音名
  926. * @param alter 升降
  927. * @param fifths 调号
  928. * @returns 是否需要临时记号
  929. */
  930. export function needsAccidental(step: StepName, alter: number, fifths: number): boolean {
  931. const keyAlterations = getKeyAlterations(fifths);
  932. const keyAlterMap = new Map(keyAlterations.map(a =&gt; [a.step, a.alter]));
  933. const expectedAlter = keyAlterMap.get(step) ?? 0;
  934. return alter !== expectedAlter;
  935. }
  936. &nbsp;
  937. /**
  938. * 获取移调后的调号
  939. * @param fifths 原调号
  940. * @param semitones 移调半音数
  941. * @returns 新调号的五度圈位置
  942. */
  943. export function transposeKey(fifths: number, semitones: number): number {
  944. // 半音与五度圈的关系:每上升7个半音 = 五度圈+1
  945. // 简化:半音数 % 12,然后找对应的五度圈变化
  946. const semitoneToFifths: Record&lt;number, number&gt; = {
  947. 0: 0, 1: 7, 2: 2, 3: -3, 4: 4, 5: -1,
  948. 6: 6, 7: 1, 8: -4, 9: 3, 10: -2, 11: 5
  949. };
  950. const normalizedSemitones = ((semitones % 12) + 12) % 12;
  951. const fifthsChange = semitoneToFifths[normalizedSemitones];
  952. let newFifths = fifths + fifthsChange;
  953. // 保持在 -7 到 +7 范围内
  954. while (newFifths &gt; 7) newFifths -= 12;
  955. while (newFifths &lt; -7) <span class="branch-0 cbranch-no" title="branch not covered" >newFifths += 12;</span>
  956. return newFifths;
  957. }
  958. &nbsp;</pre></td></tr></table></pre>
  959. <div class='push'></div><!-- for sticky footer -->
  960. </div><!-- /wrapper -->
  961. <div class='footer quiet pad2 space-top1 center small'>
  962. Code coverage generated by
  963. <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
  964. at 2026-01-30T13:40:00.128Z
  965. </div>
  966. <script src="../../prettify.js"></script>
  967. <script>
  968. window.onload = function () {
  969. prettyPrint();
  970. };
  971. </script>
  972. <script src="../../sorter.js"></script>
  973. <script src="../../block-navigation.js"></script>
  974. </body>
  975. </html>