vexflow 4.0.1-beta.1 → 4.0.1-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (331) hide show
  1. package/build/cjs/vexflow-bravura.js +2 -2
  2. package/build/cjs/vexflow-bravura.js.map +1 -1
  3. package/build/cjs/vexflow-core.js +2 -2
  4. package/build/cjs/vexflow-core.js.map +1 -1
  5. package/build/cjs/vexflow-debug-with-tests.js +92 -24
  6. package/build/cjs/vexflow-debug-with-tests.js.map +1 -1
  7. package/build/cjs/vexflow-debug.js +38 -16
  8. package/build/cjs/vexflow-debug.js.map +1 -1
  9. package/build/cjs/vexflow-font-gonville.js +1 -1
  10. package/build/cjs/vexflow-font-gonville.js.map +1 -1
  11. package/build/cjs/vexflow-gonville.js +2 -2
  12. package/build/cjs/vexflow-gonville.js.map +1 -1
  13. package/build/cjs/vexflow-petaluma.js +2 -2
  14. package/build/cjs/vexflow-petaluma.js.map +1 -1
  15. package/build/cjs/vexflow.js +2 -2
  16. package/build/cjs/vexflow.js.map +1 -1
  17. package/build/esm/entry/vexflow-bravura.js +11 -0
  18. package/build/esm/entry/vexflow-core.js +54 -0
  19. package/build/esm/entry/vexflow-debug-with-tests.js +4 -0
  20. package/build/esm/entry/vexflow-debug.js +3 -0
  21. package/build/esm/entry/vexflow-font-bravura.js +7 -0
  22. package/build/esm/entry/vexflow-font-custom.js +7 -0
  23. package/build/esm/entry/vexflow-font-gonville.js +7 -0
  24. package/build/esm/entry/vexflow-font-petaluma.js +7 -0
  25. package/build/esm/entry/vexflow-gonville.js +11 -0
  26. package/build/esm/entry/vexflow-petaluma.js +11 -0
  27. package/build/esm/entry/vexflow.js +9 -0
  28. package/build/esm/src/accidental.js +348 -0
  29. package/build/esm/src/annotation.js +232 -0
  30. package/build/esm/src/articulation.js +267 -0
  31. package/build/esm/src/barnote.js +58 -0
  32. package/build/esm/src/beam.js +632 -0
  33. package/build/esm/src/bend.js +202 -0
  34. package/build/esm/src/boundingbox.js +59 -0
  35. package/build/esm/src/boundingboxcomputation.js +107 -0
  36. package/build/esm/src/canvascontext.js +202 -0
  37. package/build/esm/src/chordsymbol.js +578 -0
  38. package/build/esm/src/clef.js +153 -0
  39. package/build/esm/src/clefnote.js +65 -0
  40. package/build/esm/src/crescendo.js +77 -0
  41. package/build/esm/src/curve.js +118 -0
  42. package/build/esm/src/dot.js +137 -0
  43. package/build/esm/src/easyscore.js +374 -0
  44. package/build/esm/src/element.js +216 -0
  45. package/build/esm/src/factory.js +440 -0
  46. package/build/esm/src/flow.js +275 -0
  47. package/build/esm/src/font.js +264 -0
  48. package/build/esm/src/fonts/bravura_glyphs.js +3239 -0
  49. package/build/esm/src/fonts/bravura_metrics.js +507 -0
  50. package/build/esm/src/fonts/custom_glyphs.js +78 -0
  51. package/build/esm/src/fonts/custom_metrics.js +5 -0
  52. package/build/esm/src/fonts/gonville_glyphs.js +828 -0
  53. package/build/esm/src/fonts/gonville_metrics.js +421 -0
  54. package/build/esm/src/fonts/load_all.js +10 -0
  55. package/build/esm/src/fonts/load_bravura.js +6 -0
  56. package/build/esm/src/fonts/load_custom.js +6 -0
  57. package/build/esm/src/fonts/load_gonville.js +6 -0
  58. package/build/esm/src/fonts/load_petaluma.js +6 -0
  59. package/build/esm/src/fonts/petaluma_glyphs.js +1335 -0
  60. package/build/esm/src/fonts/petaluma_metrics.js +536 -0
  61. package/build/esm/src/fonts/petalumascript_glyphs.js +863 -0
  62. package/build/esm/src/fonts/robotoslab_glyphs.js +863 -0
  63. package/build/esm/src/fonts/textfonts.js +44 -0
  64. package/build/esm/src/formatter.js +568 -0
  65. package/build/esm/src/fraction.js +171 -0
  66. package/build/esm/src/frethandfinger.js +156 -0
  67. package/build/esm/src/ghostnote.js +50 -0
  68. package/build/esm/src/glyph.js +331 -0
  69. package/build/esm/src/glyphnote.js +55 -0
  70. package/build/esm/src/gracenote.js +133 -0
  71. package/build/esm/src/gracenotegroup.js +128 -0
  72. package/build/esm/src/gracetabnote.js +12 -0
  73. package/build/esm/src/index.js +91 -0
  74. package/build/esm/src/keymanager.js +99 -0
  75. package/build/esm/src/keysignature.js +250 -0
  76. package/build/esm/src/keysignote.js +28 -0
  77. package/build/esm/src/modifier.js +128 -0
  78. package/build/esm/src/modifiercontext.js +110 -0
  79. package/build/esm/src/multimeasurerest.js +173 -0
  80. package/build/esm/src/music.js +322 -0
  81. package/build/esm/src/note.js +371 -0
  82. package/build/esm/src/notehead.js +169 -0
  83. package/build/esm/src/notesubgroup.js +59 -0
  84. package/build/esm/src/ornament.js +206 -0
  85. package/build/esm/src/parenthesis.js +76 -0
  86. package/build/esm/src/parser.js +164 -0
  87. package/build/esm/src/pedalmarking.js +192 -0
  88. package/build/esm/src/registry.js +81 -0
  89. package/build/esm/src/rendercontext.js +24 -0
  90. package/build/esm/src/renderer.js +112 -0
  91. package/build/esm/src/repeatnote.js +22 -0
  92. package/build/esm/src/stave.js +547 -0
  93. package/build/esm/src/stavebarline.js +182 -0
  94. package/build/esm/src/staveconnector.js +196 -0
  95. package/build/esm/src/stavehairpin.js +120 -0
  96. package/build/esm/src/staveline.js +218 -0
  97. package/build/esm/src/stavemodifier.js +77 -0
  98. package/build/esm/src/stavenote.js +855 -0
  99. package/build/esm/src/staverepetition.js +155 -0
  100. package/build/esm/src/stavesection.js +58 -0
  101. package/build/esm/src/stavetempo.js +91 -0
  102. package/build/esm/src/stavetext.js +82 -0
  103. package/build/esm/src/stavetie.js +141 -0
  104. package/build/esm/src/stavevolta.js +67 -0
  105. package/build/esm/src/stem.js +131 -0
  106. package/build/esm/src/stemmablenote.js +193 -0
  107. package/build/esm/src/stringnumber.js +231 -0
  108. package/build/esm/src/strokes.js +200 -0
  109. package/build/esm/src/svgcontext.js +414 -0
  110. package/build/esm/src/system.js +116 -0
  111. package/build/esm/src/tables.js +1102 -0
  112. package/build/esm/src/tabnote.js +299 -0
  113. package/build/esm/src/tabslide.js +76 -0
  114. package/build/esm/src/tabstave.js +17 -0
  115. package/build/esm/src/tabtie.js +19 -0
  116. package/build/esm/src/textbracket.js +144 -0
  117. package/build/esm/src/textdynamics.js +81 -0
  118. package/build/esm/src/textformatter.js +177 -0
  119. package/build/esm/src/textnote.js +176 -0
  120. package/build/esm/src/tickable.js +214 -0
  121. package/build/esm/src/tickcontext.js +170 -0
  122. package/build/esm/src/timesigglyph.js +85 -0
  123. package/build/esm/src/timesignature.js +89 -0
  124. package/build/esm/src/timesignote.js +32 -0
  125. package/build/esm/src/tremolo.js +47 -0
  126. package/build/esm/src/tuning.js +54 -0
  127. package/build/esm/src/tuplet.js +240 -0
  128. package/build/esm/src/typeguard.js +30 -0
  129. package/build/esm/src/util.js +58 -0
  130. package/build/esm/src/version.js +3 -3
  131. package/build/esm/src/vex.js +51 -0
  132. package/build/esm/src/vibrato.js +100 -0
  133. package/build/esm/src/vibratobracket.js +50 -0
  134. package/build/esm/src/voice.js +187 -0
  135. package/build/esm/src/web.js +15 -0
  136. package/build/esm/tests/accidental_tests.js +974 -0
  137. package/build/esm/tests/annotation_tests.js +377 -0
  138. package/build/esm/tests/articulation_tests.js +365 -0
  139. package/build/esm/tests/auto_beam_formatting_tests.js +548 -0
  140. package/build/esm/tests/bach_tests.js +335 -0
  141. package/build/esm/tests/barline_tests.js +52 -0
  142. package/build/esm/tests/beam_tests.js +595 -0
  143. package/build/esm/tests/bend_tests.js +215 -0
  144. package/build/esm/tests/boundingbox_tests.js +53 -0
  145. package/build/esm/tests/boundingboxcomputation_tests.js +183 -0
  146. package/build/esm/tests/chordsymbol_tests.js +320 -0
  147. package/build/esm/tests/clef_tests.js +131 -0
  148. package/build/esm/tests/curve_tests.js +118 -0
  149. package/build/esm/tests/dot_tests.js +123 -0
  150. package/build/esm/tests/easyscore_tests.js +459 -0
  151. package/build/esm/tests/factory_tests.js +44 -0
  152. package/build/esm/tests/font_tests.js +135 -0
  153. package/build/esm/tests/formatter/framestack.js +61 -0
  154. package/build/esm/tests/formatter/tests.js +203 -0
  155. package/build/esm/tests/formatter_tests.js +669 -0
  156. package/build/esm/tests/fraction_tests.js +72 -0
  157. package/build/esm/tests/ghostnote_tests.js +77 -0
  158. package/build/esm/tests/glyphnote_tests.js +113 -0
  159. package/build/esm/tests/gracenote_tests.js +413 -0
  160. package/build/esm/tests/gracetabnote_tests.js +79 -0
  161. package/build/esm/tests/index.js +68 -0
  162. package/build/esm/tests/key_clef_tests.js +103 -0
  163. package/build/esm/tests/keymanager_tests.js +68 -0
  164. package/build/esm/tests/keysignature_tests.js +308 -0
  165. package/build/esm/tests/mocks.js +71 -0
  166. package/build/esm/tests/modifier_tests.js +24 -0
  167. package/build/esm/tests/multimeasurerest_tests.js +141 -0
  168. package/build/esm/tests/music_tests.js +161 -0
  169. package/build/esm/tests/notehead_tests.js +137 -0
  170. package/build/esm/tests/notesubgroup_tests.js +149 -0
  171. package/build/esm/tests/offscreencanvas_tests.js +47 -0
  172. package/build/esm/tests/ornament_tests.js +298 -0
  173. package/build/esm/tests/parser_tests.js +122 -0
  174. package/build/esm/tests/pedalmarking_tests.js +64 -0
  175. package/build/esm/tests/percussion_tests.js +180 -0
  176. package/build/esm/tests/registry_tests.js +64 -0
  177. package/build/esm/tests/renderer_tests.js +113 -0
  178. package/build/esm/tests/rests_tests.js +248 -0
  179. package/build/esm/tests/rhythm_tests.js +357 -0
  180. package/build/esm/tests/stave_tests.js +560 -0
  181. package/build/esm/tests/staveconnector_tests.js +402 -0
  182. package/build/esm/tests/stavehairpin_tests.js +90 -0
  183. package/build/esm/tests/staveline_tests.js +122 -0
  184. package/build/esm/tests/stavemodifier_tests.js +51 -0
  185. package/build/esm/tests/stavenote_tests.js +867 -0
  186. package/build/esm/tests/stavetie_tests.js +108 -0
  187. package/build/esm/tests/stringnumber_tests.js +259 -0
  188. package/build/esm/tests/strokes_tests.js +275 -0
  189. package/build/esm/tests/style_tests.js +98 -0
  190. package/build/esm/tests/support/qunit.js +2765 -0
  191. package/build/esm/tests/tabnote_tests.js +474 -0
  192. package/build/esm/tests/tabslide_tests.js +135 -0
  193. package/build/esm/tests/tabstave_tests.js +23 -0
  194. package/build/esm/tests/tabtie_tests.js +173 -0
  195. package/build/esm/tests/textbracket_tests.js +100 -0
  196. package/build/esm/tests/textformatter_tests.js +24 -0
  197. package/build/esm/tests/textnote_tests.js +215 -0
  198. package/build/esm/tests/threevoice_tests.js +132 -0
  199. package/build/esm/tests/tickcontext_tests.js +36 -0
  200. package/build/esm/tests/timesignature_tests.js +134 -0
  201. package/build/esm/tests/tremolo_tests.js +75 -0
  202. package/build/esm/tests/tuning_tests.js +56 -0
  203. package/build/esm/tests/tuplet_tests.js +450 -0
  204. package/build/esm/tests/typeguard_tests.js +82 -0
  205. package/build/esm/tests/vexflow_test_helpers.js +266 -0
  206. package/build/esm/tests/vf_prefix_tests.js +115 -0
  207. package/build/esm/tests/vibrato_tests.js +92 -0
  208. package/build/esm/tests/vibratobracket_tests.js +45 -0
  209. package/build/esm/tests/voice_tests.js +69 -0
  210. package/build/types/entry/vexflow-bravura.d.ts +3 -0
  211. package/build/types/entry/vexflow-core.d.ts +3 -0
  212. package/build/types/entry/vexflow-debug.d.ts +3 -0
  213. package/build/types/entry/vexflow-font-bravura.d.ts +3771 -0
  214. package/build/types/entry/vexflow-font-custom.d.ts +86 -0
  215. package/build/types/entry/vexflow-font-gonville.d.ts +1267 -0
  216. package/build/types/entry/vexflow-font-petaluma.d.ts +1896 -0
  217. package/build/types/entry/vexflow-gonville.d.ts +3 -0
  218. package/build/types/entry/vexflow-petaluma.d.ts +3 -0
  219. package/build/types/entry/vexflow.d.ts +3 -0
  220. package/build/types/src/accidental.d.ts +66 -0
  221. package/build/types/src/annotation.d.ts +60 -0
  222. package/build/types/src/articulation.d.ts +62 -0
  223. package/build/types/src/barnote.d.ts +29 -0
  224. package/build/types/src/beam.d.ts +124 -0
  225. package/build/types/src/bend.d.ts +73 -0
  226. package/build/types/src/boundingbox.d.ts +42 -0
  227. package/build/types/src/boundingboxcomputation.d.ts +33 -0
  228. package/build/types/src/canvascontext.d.ts +89 -0
  229. package/build/types/src/chordsymbol.d.ts +149 -0
  230. package/build/types/src/clef.d.ts +48 -0
  231. package/build/types/src/clefnote.d.ts +25 -0
  232. package/build/types/src/crescendo.d.ts +27 -0
  233. package/build/types/src/curve.d.ts +41 -0
  234. package/build/types/src/dot.d.ts +20 -0
  235. package/build/types/src/easyscore.d.ts +148 -0
  236. package/build/types/src/element.d.ts +202 -0
  237. package/build/types/src/factory.d.ts +271 -0
  238. package/build/types/src/flow.d.ts +245 -0
  239. package/build/types/src/font.d.ts +181 -0
  240. package/build/types/src/fonts/bravura_glyphs.d.ts +3239 -0
  241. package/build/types/src/fonts/bravura_metrics.d.ts +533 -0
  242. package/build/types/src/fonts/custom_glyphs.d.ts +78 -0
  243. package/build/types/src/fonts/custom_metrics.d.ts +5 -0
  244. package/build/types/src/fonts/gonville_glyphs.d.ts +828 -0
  245. package/build/types/src/fonts/gonville_metrics.d.ts +440 -0
  246. package/build/types/src/fonts/load_all.d.ts +1 -0
  247. package/build/types/src/fonts/load_bravura.d.ts +1 -0
  248. package/build/types/src/fonts/load_custom.d.ts +1 -0
  249. package/build/types/src/fonts/load_gonville.d.ts +1 -0
  250. package/build/types/src/fonts/load_petaluma.d.ts +1 -0
  251. package/build/types/src/fonts/petaluma_glyphs.d.ts +1335 -0
  252. package/build/types/src/fonts/petaluma_metrics.d.ts +562 -0
  253. package/build/types/src/fonts/petalumascript_glyphs.d.ts +863 -0
  254. package/build/types/src/fonts/robotoslab_glyphs.d.ts +863 -0
  255. package/build/types/src/fonts/textfonts.d.ts +1 -0
  256. package/build/types/src/formatter.d.ts +203 -0
  257. package/build/types/src/fraction.d.ts +62 -0
  258. package/build/types/src/frethandfinger.d.ts +22 -0
  259. package/build/types/src/ghostnote.d.ts +16 -0
  260. package/build/types/src/glyph.d.ts +139 -0
  261. package/build/types/src/glyphnote.d.ts +17 -0
  262. package/build/types/src/gracenote.d.ts +19 -0
  263. package/build/types/src/gracenotegroup.d.ts +33 -0
  264. package/build/types/src/gracetabnote.d.ts +5 -0
  265. package/build/types/src/index.d.ts +91 -0
  266. package/build/types/src/keymanager.d.ts +25 -0
  267. package/build/types/src/keysignature.d.ts +50 -0
  268. package/build/types/src/keysignote.d.ts +11 -0
  269. package/build/types/src/modifier.d.ts +97 -0
  270. package/build/types/src/modifiercontext.d.ts +45 -0
  271. package/build/types/src/multimeasurerest.d.ts +61 -0
  272. package/build/types/src/music.d.ts +91 -0
  273. package/build/types/src/note.d.ts +231 -0
  274. package/build/types/src/notehead.d.ts +70 -0
  275. package/build/types/src/notesubgroup.d.ts +18 -0
  276. package/build/types/src/ornament.d.ts +76 -0
  277. package/build/types/src/parenthesis.d.ts +22 -0
  278. package/build/types/src/parser.d.ts +45 -0
  279. package/build/types/src/pedalmarking.d.ts +69 -0
  280. package/build/types/src/registry.d.ts +40 -0
  281. package/build/types/src/rendercontext.d.ts +64 -0
  282. package/build/types/src/renderer.d.ts +35 -0
  283. package/build/types/src/repeatnote.d.ts +6 -0
  284. package/build/types/src/stave.d.ts +186 -0
  285. package/build/types/src/stavebarline.d.ts +28 -0
  286. package/build/types/src/staveconnector.d.ts +67 -0
  287. package/build/types/src/stavehairpin.d.ts +56 -0
  288. package/build/types/src/staveline.d.ts +57 -0
  289. package/build/types/src/stavemodifier.d.ts +44 -0
  290. package/build/types/src/stavenote.d.ts +154 -0
  291. package/build/types/src/staverepetition.d.ts +32 -0
  292. package/build/types/src/stavesection.d.ts +15 -0
  293. package/build/types/src/stavetempo.d.ts +25 -0
  294. package/build/types/src/stavetext.d.ts +25 -0
  295. package/build/types/src/stavetie.d.ts +59 -0
  296. package/build/types/src/stavevolta.d.ts +21 -0
  297. package/build/types/src/stem.d.ts +58 -0
  298. package/build/types/src/stemmablenote.d.ts +39 -0
  299. package/build/types/src/stringnumber.d.ts +27 -0
  300. package/build/types/src/strokes.d.ts +33 -0
  301. package/build/types/src/svgcontext.d.ts +131 -0
  302. package/build/types/src/system.d.ts +92 -0
  303. package/build/types/src/tables.d.ts +96 -0
  304. package/build/types/src/tabnote.d.ts +44 -0
  305. package/build/types/src/tabslide.d.ts +34 -0
  306. package/build/types/src/tabstave.d.ts +7 -0
  307. package/build/types/src/tabtie.d.ts +18 -0
  308. package/build/types/src/textbracket.d.ts +55 -0
  309. package/build/types/src/textdynamics.d.ts +39 -0
  310. package/build/types/src/textformatter.d.ts +109 -0
  311. package/build/types/src/textnote.d.ts +49 -0
  312. package/build/types/src/tickable.d.ts +140 -0
  313. package/build/types/src/tickcontext.d.ts +82 -0
  314. package/build/types/src/timesigglyph.d.ts +14 -0
  315. package/build/types/src/timesignature.d.ts +26 -0
  316. package/build/types/src/timesignote.d.ts +11 -0
  317. package/build/types/src/tremolo.d.ts +17 -0
  318. package/build/types/src/tuning.d.ts +23 -0
  319. package/build/types/src/tuplet.d.ts +105 -0
  320. package/build/types/src/typeguard.d.ts +99 -0
  321. package/build/types/src/util.d.ts +27 -0
  322. package/build/types/src/version.d.ts +3 -0
  323. package/build/types/src/vex.d.ts +18 -0
  324. package/build/types/src/vibrato.d.ts +29 -0
  325. package/build/types/src/vibratobracket.d.ts +33 -0
  326. package/build/types/src/voice.d.ts +108 -0
  327. package/build/types/src/web.d.ts +2 -0
  328. package/package.json +1 -1
  329. package/src/annotation.ts +27 -6
  330. package/src/articulation.ts +8 -2
  331. package/src/fonts/gonville_glyphs.ts +4 -4
@@ -0,0 +1,632 @@
1
+ import { Element } from './element.js';
2
+ import { Fraction } from './fraction.js';
3
+ import { Stem } from './stem.js';
4
+ import { Tables } from './tables.js';
5
+ import { isStaveNote, isTabNote } from './typeguard.js';
6
+ import { RuntimeError } from './util.js';
7
+ function calculateStemDirection(notes) {
8
+ let lineSum = 0;
9
+ notes.forEach((note) => {
10
+ if (note.keyProps) {
11
+ note.keyProps.forEach((keyProp) => {
12
+ lineSum += keyProp.line - 3;
13
+ });
14
+ }
15
+ });
16
+ if (lineSum >= 0) {
17
+ return Stem.DOWN;
18
+ }
19
+ return Stem.UP;
20
+ }
21
+ function getStemSlope(firstNote, lastNote) {
22
+ const firstStemTipY = firstNote.getStemExtents().topY;
23
+ const firstStemX = firstNote.getStemX();
24
+ const lastStemTipY = lastNote.getStemExtents().topY;
25
+ const lastStemX = lastNote.getStemX();
26
+ return (lastStemTipY - firstStemTipY) / (lastStemX - firstStemX);
27
+ }
28
+ const BEAM_LEFT = 'L';
29
+ const BEAM_RIGHT = 'R';
30
+ const BEAM_BOTH = 'B';
31
+ export class Beam extends Element {
32
+ constructor(notes, auto_stem = false) {
33
+ super();
34
+ this.slope = 0;
35
+ this.y_shift = 0;
36
+ if (!notes || notes.length === 0) {
37
+ throw new RuntimeError('BadArguments', 'No notes provided for beam.');
38
+ }
39
+ if (notes.length === 1) {
40
+ throw new RuntimeError('BadArguments', 'Too few notes for beam.');
41
+ }
42
+ this.ticks = notes[0].getIntrinsicTicks();
43
+ if (this.ticks >= Tables.durationToTicks('4')) {
44
+ throw new RuntimeError('BadArguments', 'Beams can only be applied to notes shorter than a quarter note.');
45
+ }
46
+ let i;
47
+ let note;
48
+ this.stem_direction = Stem.UP;
49
+ for (i = 0; i < notes.length; ++i) {
50
+ note = notes[i];
51
+ if (note.hasStem()) {
52
+ this.stem_direction = note.getStemDirection();
53
+ break;
54
+ }
55
+ }
56
+ let stem_direction = this.stem_direction;
57
+ if (auto_stem && isStaveNote(notes[0])) {
58
+ stem_direction = calculateStemDirection(notes);
59
+ }
60
+ else if (auto_stem && isTabNote(notes[0])) {
61
+ const stem_weight = notes.reduce((memo, note) => memo + note.getStemDirection(), 0);
62
+ stem_direction = stem_weight > -1 ? Stem.UP : Stem.DOWN;
63
+ }
64
+ for (i = 0; i < notes.length; ++i) {
65
+ note = notes[i];
66
+ if (auto_stem) {
67
+ note.setStemDirection(stem_direction);
68
+ this.stem_direction = stem_direction;
69
+ }
70
+ note.setBeam(this);
71
+ }
72
+ this.postFormatted = false;
73
+ this.notes = notes;
74
+ this.beam_count = this.getBeamCount();
75
+ this.break_on_indices = [];
76
+ this.render_options = {
77
+ beam_width: 5,
78
+ max_slope: 0.25,
79
+ min_slope: -0.25,
80
+ slope_iterations: 20,
81
+ slope_cost: 100,
82
+ show_stemlets: false,
83
+ stemlet_extension: 7,
84
+ partial_beam_length: 10,
85
+ flat_beams: false,
86
+ min_flat_beam_offset: 15,
87
+ };
88
+ }
89
+ static get CATEGORY() {
90
+ return "Beam";
91
+ }
92
+ getStemDirection() {
93
+ return this.stem_direction;
94
+ }
95
+ static getDefaultBeamGroups(time_sig) {
96
+ if (!time_sig || time_sig === 'c') {
97
+ time_sig = '4/4';
98
+ }
99
+ const defaults = {
100
+ '1/2': ['1/2'],
101
+ '2/2': ['1/2'],
102
+ '3/2': ['1/2'],
103
+ '4/2': ['1/2'],
104
+ '1/4': ['1/4'],
105
+ '2/4': ['1/4'],
106
+ '3/4': ['1/4'],
107
+ '4/4': ['1/4'],
108
+ '1/8': ['1/8'],
109
+ '2/8': ['2/8'],
110
+ '3/8': ['3/8'],
111
+ '4/8': ['2/8'],
112
+ '1/16': ['1/16'],
113
+ '2/16': ['2/16'],
114
+ '3/16': ['3/16'],
115
+ '4/16': ['2/16'],
116
+ };
117
+ const groups = defaults[time_sig];
118
+ if (groups === undefined) {
119
+ const beatTotal = parseInt(time_sig.split('/')[0], 10);
120
+ const beatValue = parseInt(time_sig.split('/')[1], 10);
121
+ const tripleMeter = beatTotal % 3 === 0;
122
+ if (tripleMeter) {
123
+ return [new Fraction(3, beatValue)];
124
+ }
125
+ else if (beatValue > 4) {
126
+ return [new Fraction(2, beatValue)];
127
+ }
128
+ else if (beatValue <= 4) {
129
+ return [new Fraction(1, beatValue)];
130
+ }
131
+ }
132
+ else {
133
+ return groups.map((group) => new Fraction().parse(group));
134
+ }
135
+ return [new Fraction(1, 4)];
136
+ }
137
+ static applyAndGetBeams(voice, stem_direction, groups) {
138
+ return Beam.generateBeams(voice.getTickables(), { groups, stem_direction });
139
+ }
140
+ static generateBeams(notes, config = {}) {
141
+ if (!config.groups || !config.groups.length) {
142
+ config.groups = [new Fraction(2, 8)];
143
+ }
144
+ const tickGroups = config.groups.map((group) => {
145
+ if (!group.multiply) {
146
+ throw new RuntimeError('InvalidBeamGroups', 'The beam groups must be an array of Vex.Flow.Fractions');
147
+ }
148
+ return group.clone().multiply(Tables.RESOLUTION, 1);
149
+ });
150
+ const unprocessedNotes = notes;
151
+ let currentTickGroup = 0;
152
+ let noteGroups = [];
153
+ let currentGroup = [];
154
+ function getTotalTicks(vf_notes) {
155
+ return vf_notes.reduce((memo, note) => note.getTicks().clone().add(memo), new Fraction(0, 1));
156
+ }
157
+ function nextTickGroup() {
158
+ if (tickGroups.length - 1 > currentTickGroup) {
159
+ currentTickGroup += 1;
160
+ }
161
+ else {
162
+ currentTickGroup = 0;
163
+ }
164
+ }
165
+ function createGroups() {
166
+ let nextGroup = [];
167
+ let currentGroupTotalTicks = new Fraction(0, 1);
168
+ unprocessedNotes.forEach((unprocessedNote) => {
169
+ nextGroup = [];
170
+ if (unprocessedNote.shouldIgnoreTicks()) {
171
+ noteGroups.push(currentGroup);
172
+ currentGroup = nextGroup;
173
+ return;
174
+ }
175
+ currentGroup.push(unprocessedNote);
176
+ const ticksPerGroup = tickGroups[currentTickGroup].clone();
177
+ const totalTicks = getTotalTicks(currentGroup).add(currentGroupTotalTicks);
178
+ const unbeamable = Tables.durationToNumber(unprocessedNote.getDuration()) < 8;
179
+ if (unbeamable && unprocessedNote.getTuplet()) {
180
+ ticksPerGroup.numerator *= 2;
181
+ }
182
+ if (totalTicks.greaterThan(ticksPerGroup)) {
183
+ if (!unbeamable) {
184
+ const note = currentGroup.pop();
185
+ if (note)
186
+ nextGroup.push(note);
187
+ }
188
+ noteGroups.push(currentGroup);
189
+ do {
190
+ currentGroupTotalTicks = totalTicks.subtract(tickGroups[currentTickGroup]);
191
+ nextTickGroup();
192
+ } while (currentGroupTotalTicks.greaterThanEquals(tickGroups[currentTickGroup]));
193
+ currentGroup = nextGroup;
194
+ }
195
+ else if (totalTicks.equals(ticksPerGroup)) {
196
+ noteGroups.push(currentGroup);
197
+ currentGroupTotalTicks = new Fraction(0, 1);
198
+ currentGroup = nextGroup;
199
+ nextTickGroup();
200
+ }
201
+ });
202
+ if (currentGroup.length > 0) {
203
+ noteGroups.push(currentGroup);
204
+ }
205
+ }
206
+ function getBeamGroups() {
207
+ return noteGroups.filter((group) => {
208
+ if (group.length > 1) {
209
+ let beamable = true;
210
+ group.forEach((note) => {
211
+ if (note.getIntrinsicTicks() >= Tables.durationToTicks('4')) {
212
+ beamable = false;
213
+ }
214
+ });
215
+ return beamable;
216
+ }
217
+ return false;
218
+ });
219
+ }
220
+ function sanitizeGroups() {
221
+ const sanitizedGroups = [];
222
+ noteGroups.forEach((group) => {
223
+ let tempGroup = [];
224
+ group.forEach((note, index, group) => {
225
+ const isFirstOrLast = index === 0 || index === group.length - 1;
226
+ const prevNote = group[index - 1];
227
+ const breaksOnEachRest = !config.beam_rests && note.isRest();
228
+ const breaksOnFirstOrLastRest = config.beam_rests && config.beam_middle_only && note.isRest() && isFirstOrLast;
229
+ let breakOnStemChange = false;
230
+ if (config.maintain_stem_directions && prevNote && !note.isRest() && !prevNote.isRest()) {
231
+ const prevDirection = prevNote.getStemDirection();
232
+ const currentDirection = note.getStemDirection();
233
+ breakOnStemChange = currentDirection !== prevDirection;
234
+ }
235
+ const isUnbeamableDuration = parseInt(note.getDuration(), 10) < 8;
236
+ const shouldBreak = breaksOnEachRest || breaksOnFirstOrLastRest || breakOnStemChange || isUnbeamableDuration;
237
+ if (shouldBreak) {
238
+ if (tempGroup.length > 0) {
239
+ sanitizedGroups.push(tempGroup);
240
+ }
241
+ tempGroup = breakOnStemChange ? [note] : [];
242
+ }
243
+ else {
244
+ tempGroup.push(note);
245
+ }
246
+ });
247
+ if (tempGroup.length > 0) {
248
+ sanitizedGroups.push(tempGroup);
249
+ }
250
+ });
251
+ noteGroups = sanitizedGroups;
252
+ }
253
+ function formatStems() {
254
+ noteGroups.forEach((group) => {
255
+ let stemDirection;
256
+ if (config.maintain_stem_directions) {
257
+ const note = findFirstNote(group);
258
+ stemDirection = note ? note.getStemDirection() : Stem.UP;
259
+ }
260
+ else {
261
+ if (config.stem_direction) {
262
+ stemDirection = config.stem_direction;
263
+ }
264
+ else {
265
+ stemDirection = calculateStemDirection(group);
266
+ }
267
+ }
268
+ applyStemDirection(group, stemDirection);
269
+ });
270
+ }
271
+ function findFirstNote(group) {
272
+ for (let i = 0; i < group.length; i++) {
273
+ const note = group[i];
274
+ if (!note.isRest()) {
275
+ return note;
276
+ }
277
+ }
278
+ return false;
279
+ }
280
+ function applyStemDirection(group, direction) {
281
+ group.forEach((note) => {
282
+ note.setStemDirection(direction);
283
+ });
284
+ }
285
+ function getTuplets() {
286
+ const uniqueTuplets = [];
287
+ noteGroups.forEach((group) => {
288
+ let tuplet;
289
+ group.forEach((note) => {
290
+ const noteTuplet = note.getTuplet();
291
+ if (noteTuplet && tuplet !== noteTuplet) {
292
+ tuplet = noteTuplet;
293
+ uniqueTuplets.push(tuplet);
294
+ }
295
+ });
296
+ });
297
+ return uniqueTuplets;
298
+ }
299
+ createGroups();
300
+ sanitizeGroups();
301
+ formatStems();
302
+ const beamedNoteGroups = getBeamGroups();
303
+ const allTuplets = getTuplets();
304
+ const beams = [];
305
+ beamedNoteGroups.forEach((group) => {
306
+ const beam = new Beam(group);
307
+ if (config.show_stemlets) {
308
+ beam.render_options.show_stemlets = true;
309
+ }
310
+ if (config.secondary_breaks) {
311
+ beam.render_options.secondary_break_ticks = Tables.durationToTicks(config.secondary_breaks);
312
+ }
313
+ if (config.flat_beams === true) {
314
+ beam.render_options.flat_beams = true;
315
+ beam.render_options.flat_beam_offset = config.flat_beam_offset;
316
+ }
317
+ beams.push(beam);
318
+ });
319
+ allTuplets.forEach((tuplet) => {
320
+ const direction = tuplet.notes[0].stem_direction === Stem.DOWN ? -1 : 1;
321
+ tuplet.setTupletLocation(direction);
322
+ let bracketed = false;
323
+ for (let i = 0; i < tuplet.notes.length; i++) {
324
+ const note = tuplet.notes[i];
325
+ if (!note.hasBeam()) {
326
+ bracketed = true;
327
+ break;
328
+ }
329
+ }
330
+ tuplet.setBracketed(bracketed);
331
+ });
332
+ return beams;
333
+ }
334
+ getNotes() {
335
+ return this.notes;
336
+ }
337
+ getBeamCount() {
338
+ const beamCounts = this.notes.map((note) => note.getGlyph().beam_count);
339
+ const maxBeamCount = beamCounts.reduce((max, beamCount) => (beamCount > max ? beamCount : max));
340
+ return maxBeamCount;
341
+ }
342
+ breakSecondaryAt(indices) {
343
+ this.break_on_indices = indices;
344
+ return this;
345
+ }
346
+ getSlopeY(x, first_x_px, first_y_px, slope) {
347
+ return first_y_px + (x - first_x_px) * slope;
348
+ }
349
+ calculateSlope() {
350
+ const { notes, stem_direction: stemDirection, render_options: { max_slope, min_slope, slope_iterations, slope_cost }, } = this;
351
+ const firstNote = notes[0];
352
+ const initialSlope = getStemSlope(firstNote, notes[notes.length - 1]);
353
+ const increment = (max_slope - min_slope) / slope_iterations;
354
+ let minCost = Number.MAX_VALUE;
355
+ let bestSlope = 0;
356
+ let yShift = 0;
357
+ for (let slope = min_slope; slope <= max_slope; slope += increment) {
358
+ let totalStemExtension = 0;
359
+ let yShiftTemp = 0;
360
+ for (let i = 1; i < notes.length; ++i) {
361
+ const note = notes[i];
362
+ if (note.hasStem() || note.isRest()) {
363
+ const adjustedStemTipY = this.getSlopeY(note.getStemX(), firstNote.getStemX(), firstNote.getStemExtents().topY, slope) + yShiftTemp;
364
+ const stemTipY = note.getStemExtents().topY;
365
+ if (stemTipY * stemDirection < adjustedStemTipY * stemDirection) {
366
+ const diff = Math.abs(stemTipY - adjustedStemTipY);
367
+ yShiftTemp += diff * -stemDirection;
368
+ totalStemExtension += diff * i;
369
+ }
370
+ else {
371
+ totalStemExtension += (stemTipY - adjustedStemTipY) * stemDirection;
372
+ }
373
+ }
374
+ }
375
+ const idealSlope = initialSlope / 2;
376
+ const distanceFromIdeal = Math.abs(idealSlope - slope);
377
+ const cost = slope_cost * distanceFromIdeal + Math.abs(totalStemExtension);
378
+ if (cost < minCost) {
379
+ minCost = cost;
380
+ bestSlope = slope;
381
+ yShift = yShiftTemp;
382
+ }
383
+ }
384
+ this.slope = bestSlope;
385
+ this.y_shift = yShift;
386
+ }
387
+ calculateFlatSlope() {
388
+ const { notes, stem_direction, render_options: { beam_width, min_flat_beam_offset, flat_beam_offset }, } = this;
389
+ let total = 0;
390
+ let extremeY = 0;
391
+ let extremeBeamCount = 0;
392
+ let currentExtreme = 0;
393
+ for (let i = 0; i < notes.length; i++) {
394
+ const note = notes[i];
395
+ const stemTipY = note.getStemExtents().topY;
396
+ total += stemTipY;
397
+ if (stem_direction === Stem.DOWN && currentExtreme < stemTipY) {
398
+ currentExtreme = stemTipY;
399
+ extremeY = Math.max(...note.getYs());
400
+ extremeBeamCount = note.getBeamCount();
401
+ }
402
+ else if (stem_direction === Stem.UP && (currentExtreme === 0 || currentExtreme > stemTipY)) {
403
+ currentExtreme = stemTipY;
404
+ extremeY = Math.min(...note.getYs());
405
+ extremeBeamCount = note.getBeamCount();
406
+ }
407
+ }
408
+ let offset = total / notes.length;
409
+ const beamWidth = beam_width * 1.5;
410
+ const extremeTest = min_flat_beam_offset + extremeBeamCount * beamWidth;
411
+ const newOffset = extremeY + extremeTest * -stem_direction;
412
+ if (stem_direction === Stem.DOWN && offset < newOffset) {
413
+ offset = extremeY + extremeTest;
414
+ }
415
+ else if (stem_direction === Stem.UP && offset > newOffset) {
416
+ offset = extremeY - extremeTest;
417
+ }
418
+ if (!flat_beam_offset) {
419
+ this.render_options.flat_beam_offset = offset;
420
+ }
421
+ else if (stem_direction === Stem.DOWN && offset > flat_beam_offset) {
422
+ this.render_options.flat_beam_offset = offset;
423
+ }
424
+ else if (stem_direction === Stem.UP && offset < flat_beam_offset) {
425
+ this.render_options.flat_beam_offset = offset;
426
+ }
427
+ this.slope = 0;
428
+ this.y_shift = 0;
429
+ }
430
+ getBeamYToDraw() {
431
+ const firstNote = this.notes[0];
432
+ const firstStemTipY = firstNote.getStemExtents().topY;
433
+ let beamY = firstStemTipY;
434
+ if (this.render_options.flat_beams && this.render_options.flat_beam_offset) {
435
+ beamY = this.render_options.flat_beam_offset;
436
+ }
437
+ return beamY;
438
+ }
439
+ applyStemExtensions() {
440
+ const { notes, slope, y_shift, stem_direction, beam_count, render_options: { show_stemlets, stemlet_extension, beam_width }, } = this;
441
+ const firstNote = notes[0];
442
+ const firstStemTipY = this.getBeamYToDraw();
443
+ const firstStemX = firstNote.getStemX();
444
+ for (let i = 0; i < notes.length; ++i) {
445
+ const note = notes[i];
446
+ const stem = note.getStem();
447
+ if (stem) {
448
+ const stemX = note.getStemX();
449
+ const { topY: stemTipY } = note.getStemExtents();
450
+ const beamedStemTipY = this.getSlopeY(stemX, firstStemX, firstStemTipY, slope) + y_shift;
451
+ const preBeamExtension = stem.getExtension();
452
+ const beamExtension = stem_direction === Stem.UP ? stemTipY - beamedStemTipY : beamedStemTipY - stemTipY;
453
+ stem.setExtension(preBeamExtension + beamExtension);
454
+ stem.adjustHeightForBeam();
455
+ if (note.isRest() && show_stemlets) {
456
+ const beamWidth = beam_width;
457
+ const totalBeamWidth = (beam_count - 1) * beamWidth * 1.5 + beamWidth;
458
+ stem.setVisibility(true).setStemlet(true, totalBeamWidth + stemlet_extension);
459
+ }
460
+ }
461
+ }
462
+ }
463
+ lookupBeamDirection(duration, prev_tick, tick, next_tick) {
464
+ if (duration === '4') {
465
+ return BEAM_LEFT;
466
+ }
467
+ const lookup_duration = `${Tables.durationToNumber(duration) / 2}`;
468
+ const prev_note_gets_beam = prev_tick < Tables.durationToTicks(lookup_duration);
469
+ const next_note_gets_beam = next_tick < Tables.durationToTicks(lookup_duration);
470
+ const note_gets_beam = tick < Tables.durationToTicks(lookup_duration);
471
+ if (prev_note_gets_beam && next_note_gets_beam && note_gets_beam) {
472
+ return BEAM_BOTH;
473
+ }
474
+ else if (prev_note_gets_beam && !next_note_gets_beam && note_gets_beam) {
475
+ return BEAM_LEFT;
476
+ }
477
+ else if (!prev_note_gets_beam && next_note_gets_beam && note_gets_beam) {
478
+ return BEAM_RIGHT;
479
+ }
480
+ return this.lookupBeamDirection(lookup_duration, prev_tick, tick, next_tick);
481
+ }
482
+ getBeamLines(duration) {
483
+ const tick_of_duration = Tables.durationToTicks(duration);
484
+ let beam_started = false;
485
+ const beam_lines = [];
486
+ let current_beam = undefined;
487
+ const partial_beam_length = this.render_options.partial_beam_length;
488
+ let previous_should_break = false;
489
+ let tick_tally = 0;
490
+ for (let i = 0; i < this.notes.length; ++i) {
491
+ const note = this.notes[i];
492
+ const ticks = note.getTicks().value();
493
+ tick_tally += ticks;
494
+ let should_break = false;
495
+ if (parseInt(duration, 10) >= 8) {
496
+ should_break = this.break_on_indices.indexOf(i) !== -1;
497
+ if (this.render_options.secondary_break_ticks && tick_tally >= this.render_options.secondary_break_ticks) {
498
+ tick_tally = 0;
499
+ should_break = true;
500
+ }
501
+ }
502
+ const note_gets_beam = note.getIntrinsicTicks() < tick_of_duration;
503
+ const stem_x = note.getStemX() - Stem.WIDTH / 2;
504
+ const prev_note = this.notes[i - 1];
505
+ const next_note = this.notes[i + 1];
506
+ const next_note_gets_beam = next_note && next_note.getIntrinsicTicks() < tick_of_duration;
507
+ const prev_note_gets_beam = prev_note && prev_note.getIntrinsicTicks() < tick_of_duration;
508
+ const beam_alone = prev_note && next_note && note_gets_beam && !prev_note_gets_beam && !next_note_gets_beam;
509
+ if (note_gets_beam) {
510
+ if (beam_started) {
511
+ current_beam = beam_lines[beam_lines.length - 1];
512
+ current_beam.end = stem_x;
513
+ if (should_break) {
514
+ beam_started = false;
515
+ if (next_note && !next_note_gets_beam && current_beam.end === undefined) {
516
+ current_beam.end = current_beam.start - partial_beam_length;
517
+ }
518
+ }
519
+ }
520
+ else {
521
+ current_beam = { start: stem_x, end: undefined };
522
+ beam_started = true;
523
+ if (beam_alone) {
524
+ const prev_tick = prev_note.getIntrinsicTicks();
525
+ const next_tick = next_note.getIntrinsicTicks();
526
+ const tick = note.getIntrinsicTicks();
527
+ const beam_direction = this.lookupBeamDirection(duration, prev_tick, tick, next_tick);
528
+ if ([BEAM_LEFT, BEAM_BOTH].includes(beam_direction)) {
529
+ current_beam.end = current_beam.start - partial_beam_length;
530
+ }
531
+ else {
532
+ current_beam.end = current_beam.start + partial_beam_length;
533
+ }
534
+ }
535
+ else if (!next_note_gets_beam) {
536
+ if ((previous_should_break || i === 0) && next_note) {
537
+ current_beam.end = current_beam.start + partial_beam_length;
538
+ }
539
+ else {
540
+ current_beam.end = current_beam.start - partial_beam_length;
541
+ }
542
+ }
543
+ else if (should_break) {
544
+ current_beam.end = current_beam.start - partial_beam_length;
545
+ beam_started = false;
546
+ }
547
+ beam_lines.push(current_beam);
548
+ }
549
+ }
550
+ else {
551
+ beam_started = false;
552
+ }
553
+ previous_should_break = should_break;
554
+ }
555
+ const last_beam = beam_lines[beam_lines.length - 1];
556
+ if (last_beam && last_beam.end === undefined) {
557
+ last_beam.end = last_beam.start - partial_beam_length;
558
+ }
559
+ return beam_lines;
560
+ }
561
+ drawStems(ctx) {
562
+ this.notes.forEach((note) => {
563
+ const stem = note.getStem();
564
+ if (stem) {
565
+ ctx.openGroup('stem', note.getAttribute('id') + '-stem');
566
+ stem.setContext(ctx).draw();
567
+ ctx.closeGroup();
568
+ }
569
+ }, this);
570
+ }
571
+ drawBeamLines(ctx) {
572
+ const valid_beam_durations = ['4', '8', '16', '32', '64'];
573
+ const firstNote = this.notes[0];
574
+ let beamY = this.getBeamYToDraw();
575
+ const firstStemX = firstNote.getStemX();
576
+ const beamThickness = this.render_options.beam_width * this.stem_direction;
577
+ for (let i = 0; i < valid_beam_durations.length; ++i) {
578
+ const duration = valid_beam_durations[i];
579
+ const beamLines = this.getBeamLines(duration);
580
+ for (let j = 0; j < beamLines.length; ++j) {
581
+ const beam_line = beamLines[j];
582
+ const startBeamX = beam_line.start;
583
+ const startBeamY = this.getSlopeY(startBeamX, firstStemX, beamY, this.slope);
584
+ const lastBeamX = beam_line.end;
585
+ if (lastBeamX) {
586
+ const lastBeamY = this.getSlopeY(lastBeamX, firstStemX, beamY, this.slope);
587
+ this.setAttribute('el', ctx.openGroup('beam'));
588
+ ctx.beginPath();
589
+ ctx.moveTo(startBeamX, startBeamY);
590
+ ctx.lineTo(startBeamX, startBeamY + beamThickness);
591
+ ctx.lineTo(lastBeamX + 1, lastBeamY + beamThickness);
592
+ ctx.lineTo(lastBeamX + 1, lastBeamY);
593
+ ctx.closePath();
594
+ ctx.fill();
595
+ ctx.closeGroup();
596
+ }
597
+ else {
598
+ throw new RuntimeError('NoLastBeamX', 'lastBeamX undefined.');
599
+ }
600
+ }
601
+ beamY += beamThickness * 1.5;
602
+ }
603
+ }
604
+ preFormat() {
605
+ return this;
606
+ }
607
+ postFormat() {
608
+ if (this.postFormatted)
609
+ return;
610
+ if (isTabNote(this.notes[0]) || this.render_options.flat_beams) {
611
+ this.calculateFlatSlope();
612
+ }
613
+ else {
614
+ this.calculateSlope();
615
+ }
616
+ this.applyStemExtensions();
617
+ this.postFormatted = true;
618
+ }
619
+ draw() {
620
+ const ctx = this.checkContext();
621
+ this.setRendered();
622
+ if (this.unbeamable)
623
+ return;
624
+ if (!this.postFormatted) {
625
+ this.postFormat();
626
+ }
627
+ this.drawStems(ctx);
628
+ this.applyStyle();
629
+ this.drawBeamLines(ctx);
630
+ this.restoreStyle();
631
+ }
632
+ }