vexflow 4.0.1-beta.1 → 4.0.1

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 (353) hide show
  1. package/README.md +48 -65
  2. package/build/cjs/vexflow-bravura.js +2 -2
  3. package/build/cjs/vexflow-bravura.js.map +1 -1
  4. package/build/cjs/vexflow-core.js +2 -2
  5. package/build/cjs/vexflow-core.js.map +1 -1
  6. package/build/cjs/vexflow-debug-with-tests.js +724 -697
  7. package/build/cjs/vexflow-debug-with-tests.js.map +1 -1
  8. package/build/cjs/vexflow-debug.js +550 -610
  9. package/build/cjs/vexflow-debug.js.map +1 -1
  10. package/build/cjs/vexflow-font-gonville.js +1 -1
  11. package/build/cjs/vexflow-font-gonville.js.map +1 -1
  12. package/build/cjs/vexflow-gonville.js +2 -2
  13. package/build/cjs/vexflow-gonville.js.map +1 -1
  14. package/build/cjs/vexflow-petaluma.js +2 -2
  15. package/build/cjs/vexflow-petaluma.js.map +1 -1
  16. package/build/cjs/vexflow.js +2 -2
  17. package/build/cjs/vexflow.js.map +1 -1
  18. package/build/esm/entry/vexflow-bravura.js +10 -0
  19. package/build/esm/entry/vexflow-core.js +53 -0
  20. package/build/esm/entry/vexflow-debug-with-tests.js +11 -0
  21. package/build/esm/entry/vexflow-debug.js +8 -0
  22. package/build/esm/entry/vexflow-font-bravura.js +7 -0
  23. package/build/esm/entry/vexflow-font-custom.js +7 -0
  24. package/build/esm/entry/vexflow-font-gonville.js +7 -0
  25. package/build/esm/entry/vexflow-font-petaluma.js +7 -0
  26. package/build/esm/entry/vexflow-gonville.js +10 -0
  27. package/build/esm/entry/vexflow-petaluma.js +10 -0
  28. package/build/esm/entry/vexflow.js +8 -0
  29. package/build/esm/src/accidental.js +348 -0
  30. package/build/esm/src/annotation.js +238 -0
  31. package/build/esm/src/articulation.js +267 -0
  32. package/build/esm/src/barnote.js +58 -0
  33. package/build/esm/src/beam.js +644 -0
  34. package/build/esm/src/bend.js +202 -0
  35. package/build/esm/src/boundingbox.js +59 -0
  36. package/build/esm/src/boundingboxcomputation.js +107 -0
  37. package/build/esm/src/canvascontext.js +202 -0
  38. package/build/esm/src/chordsymbol.js +578 -0
  39. package/build/esm/src/clef.js +153 -0
  40. package/build/esm/src/clefnote.js +65 -0
  41. package/build/esm/src/crescendo.js +77 -0
  42. package/build/esm/src/curve.js +118 -0
  43. package/build/esm/src/dot.js +137 -0
  44. package/build/esm/src/easyscore.js +374 -0
  45. package/build/esm/src/element.js +216 -0
  46. package/build/esm/src/factory.js +445 -0
  47. package/build/esm/src/flow.js +288 -0
  48. package/build/esm/src/font.js +262 -0
  49. package/build/esm/src/fonts/bravura_glyphs.js +3239 -0
  50. package/build/esm/src/fonts/bravura_metrics.js +507 -0
  51. package/build/esm/src/fonts/custom_glyphs.js +78 -0
  52. package/build/esm/src/fonts/custom_metrics.js +5 -0
  53. package/build/esm/src/fonts/gonville_glyphs.js +828 -0
  54. package/build/esm/src/fonts/gonville_metrics.js +421 -0
  55. package/build/esm/src/fonts/load_all.js +10 -0
  56. package/build/esm/src/fonts/load_bravura.js +6 -0
  57. package/build/esm/src/fonts/load_custom.js +6 -0
  58. package/build/esm/src/fonts/load_gonville.js +6 -0
  59. package/build/esm/src/fonts/load_petaluma.js +6 -0
  60. package/build/esm/src/fonts/petaluma_glyphs.js +1335 -0
  61. package/build/esm/src/fonts/petaluma_metrics.js +536 -0
  62. package/build/esm/src/fonts/petalumascript_glyphs.js +863 -0
  63. package/build/esm/src/fonts/robotoslab_glyphs.js +863 -0
  64. package/build/esm/src/fonts/textfonts.js +44 -0
  65. package/build/esm/src/formatter.js +585 -0
  66. package/build/esm/src/fraction.js +171 -0
  67. package/build/esm/src/frethandfinger.js +156 -0
  68. package/build/esm/src/ghostnote.js +50 -0
  69. package/build/esm/src/glyph.js +337 -0
  70. package/build/esm/src/glyphnote.js +55 -0
  71. package/build/esm/src/gracenote.js +133 -0
  72. package/build/esm/src/gracenotegroup.js +128 -0
  73. package/build/esm/src/gracetabnote.js +12 -0
  74. package/build/esm/src/index.js +89 -0
  75. package/build/esm/src/keymanager.js +99 -0
  76. package/build/esm/src/keysignature.js +250 -0
  77. package/build/esm/src/keysignote.js +28 -0
  78. package/build/esm/src/modifier.js +128 -0
  79. package/build/esm/src/modifiercontext.js +110 -0
  80. package/build/esm/src/multimeasurerest.js +173 -0
  81. package/build/esm/src/music.js +322 -0
  82. package/build/esm/src/note.js +371 -0
  83. package/build/esm/src/notehead.js +169 -0
  84. package/build/esm/src/notesubgroup.js +59 -0
  85. package/build/esm/src/ornament.js +206 -0
  86. package/build/esm/src/parenthesis.js +76 -0
  87. package/build/esm/src/parser.js +164 -0
  88. package/build/esm/src/pedalmarking.js +192 -0
  89. package/build/esm/src/registry.js +81 -0
  90. package/build/esm/src/rendercontext.js +24 -0
  91. package/build/esm/src/renderer.js +112 -0
  92. package/build/esm/src/repeatnote.js +22 -0
  93. package/build/esm/src/stave.js +547 -0
  94. package/build/esm/src/stavebarline.js +182 -0
  95. package/build/esm/src/staveconnector.js +196 -0
  96. package/build/esm/src/stavehairpin.js +120 -0
  97. package/build/esm/src/staveline.js +215 -0
  98. package/build/esm/src/stavemodifier.js +77 -0
  99. package/build/esm/src/stavenote.js +860 -0
  100. package/build/esm/src/staverepetition.js +155 -0
  101. package/build/esm/src/stavesection.js +58 -0
  102. package/build/esm/src/stavetempo.js +91 -0
  103. package/build/esm/src/stavetext.js +82 -0
  104. package/build/esm/src/stavetie.js +141 -0
  105. package/build/esm/src/stavevolta.js +67 -0
  106. package/build/esm/src/stem.js +131 -0
  107. package/build/esm/src/stemmablenote.js +193 -0
  108. package/build/esm/src/stringnumber.js +231 -0
  109. package/build/esm/src/strokes.js +200 -0
  110. package/build/esm/src/svgcontext.js +414 -0
  111. package/build/esm/src/system.js +109 -0
  112. package/build/esm/src/tables.js +1102 -0
  113. package/build/esm/src/tabnote.js +299 -0
  114. package/build/esm/src/tabslide.js +76 -0
  115. package/build/esm/src/tabstave.js +17 -0
  116. package/build/esm/src/tabtie.js +19 -0
  117. package/build/esm/src/textbracket.js +144 -0
  118. package/build/esm/src/textdynamics.js +81 -0
  119. package/build/esm/src/textformatter.js +177 -0
  120. package/build/esm/src/textnote.js +174 -0
  121. package/build/esm/src/tickable.js +214 -0
  122. package/build/esm/src/tickcontext.js +170 -0
  123. package/build/esm/src/timesigglyph.js +85 -0
  124. package/build/esm/src/timesignature.js +89 -0
  125. package/build/esm/src/timesignote.js +32 -0
  126. package/build/esm/src/tremolo.js +47 -0
  127. package/build/esm/src/tuning.js +54 -0
  128. package/build/esm/src/tuplet.js +240 -0
  129. package/build/esm/src/typeguard.js +30 -0
  130. package/build/esm/src/util.js +58 -0
  131. package/build/esm/src/version.js +3 -3
  132. package/build/esm/src/vex.js +51 -0
  133. package/build/esm/src/vibrato.js +100 -0
  134. package/build/esm/src/vibratobracket.js +50 -0
  135. package/build/esm/src/voice.js +187 -0
  136. package/build/esm/src/web.js +15 -0
  137. package/build/esm/tests/accidental_tests.js +974 -0
  138. package/build/esm/tests/annotation_tests.js +390 -0
  139. package/build/esm/tests/articulation_tests.js +365 -0
  140. package/build/esm/tests/auto_beam_formatting_tests.js +548 -0
  141. package/build/esm/tests/bach_tests.js +335 -0
  142. package/build/esm/tests/barline_tests.js +52 -0
  143. package/build/esm/tests/beam_tests.js +614 -0
  144. package/build/esm/tests/bend_tests.js +215 -0
  145. package/build/esm/tests/boundingbox_tests.js +53 -0
  146. package/build/esm/tests/boundingboxcomputation_tests.js +183 -0
  147. package/build/esm/tests/chordsymbol_tests.js +320 -0
  148. package/build/esm/tests/clef_tests.js +131 -0
  149. package/build/esm/tests/curve_tests.js +118 -0
  150. package/build/esm/tests/dot_tests.js +123 -0
  151. package/build/esm/tests/easyscore_tests.js +462 -0
  152. package/build/esm/tests/factory_tests.js +44 -0
  153. package/build/esm/tests/font_tests.js +135 -0
  154. package/build/esm/tests/formatter/framestack.js +61 -0
  155. package/build/esm/tests/formatter/tests.js +203 -0
  156. package/build/esm/tests/formatter_tests.js +670 -0
  157. package/build/esm/tests/fraction_tests.js +72 -0
  158. package/build/esm/tests/ghostnote_tests.js +77 -0
  159. package/build/esm/tests/glyphnote_tests.js +113 -0
  160. package/build/esm/tests/gracenote_tests.js +413 -0
  161. package/build/esm/tests/gracetabnote_tests.js +79 -0
  162. package/build/esm/tests/index.js +68 -0
  163. package/build/esm/tests/key_clef_tests.js +103 -0
  164. package/build/esm/tests/keymanager_tests.js +68 -0
  165. package/build/esm/tests/keysignature_tests.js +308 -0
  166. package/build/esm/tests/mocks.js +71 -0
  167. package/build/esm/tests/modifier_tests.js +24 -0
  168. package/build/esm/tests/multimeasurerest_tests.js +141 -0
  169. package/build/esm/tests/music_tests.js +161 -0
  170. package/build/esm/tests/notehead_tests.js +137 -0
  171. package/build/esm/tests/notesubgroup_tests.js +149 -0
  172. package/build/esm/tests/offscreencanvas_tests.js +47 -0
  173. package/build/esm/tests/ornament_tests.js +298 -0
  174. package/build/esm/tests/parser_tests.js +122 -0
  175. package/build/esm/tests/pedalmarking_tests.js +64 -0
  176. package/build/esm/tests/percussion_tests.js +180 -0
  177. package/build/esm/tests/registry_tests.js +64 -0
  178. package/build/esm/tests/renderer_tests.js +113 -0
  179. package/build/esm/tests/rests_tests.js +248 -0
  180. package/build/esm/tests/rhythm_tests.js +357 -0
  181. package/build/esm/tests/stave_tests.js +560 -0
  182. package/build/esm/tests/staveconnector_tests.js +402 -0
  183. package/build/esm/tests/stavehairpin_tests.js +90 -0
  184. package/build/esm/tests/staveline_tests.js +122 -0
  185. package/build/esm/tests/stavemodifier_tests.js +51 -0
  186. package/build/esm/tests/stavenote_tests.js +867 -0
  187. package/build/esm/tests/stavetie_tests.js +108 -0
  188. package/build/esm/tests/stringnumber_tests.js +259 -0
  189. package/build/esm/tests/strokes_tests.js +275 -0
  190. package/build/esm/tests/style_tests.js +98 -0
  191. package/build/esm/tests/support/qunit.js +2765 -0
  192. package/build/esm/tests/tabnote_tests.js +474 -0
  193. package/build/esm/tests/tabslide_tests.js +135 -0
  194. package/build/esm/tests/tabstave_tests.js +23 -0
  195. package/build/esm/tests/tabtie_tests.js +173 -0
  196. package/build/esm/tests/textbracket_tests.js +100 -0
  197. package/build/esm/tests/textformatter_tests.js +24 -0
  198. package/build/esm/tests/textnote_tests.js +215 -0
  199. package/build/esm/tests/threevoice_tests.js +132 -0
  200. package/build/esm/tests/tickcontext_tests.js +36 -0
  201. package/build/esm/tests/timesignature_tests.js +134 -0
  202. package/build/esm/tests/tremolo_tests.js +75 -0
  203. package/build/esm/tests/tuning_tests.js +56 -0
  204. package/build/esm/tests/tuplet_tests.js +450 -0
  205. package/build/esm/tests/typeguard_tests.js +82 -0
  206. package/build/esm/tests/vexflow_test_helpers.js +266 -0
  207. package/build/esm/tests/vf_prefix_tests.js +115 -0
  208. package/build/esm/tests/vibrato_tests.js +92 -0
  209. package/build/esm/tests/vibratobracket_tests.js +45 -0
  210. package/build/esm/tests/voice_tests.js +69 -0
  211. package/build/types/entry/vexflow-bravura.d.ts +2 -0
  212. package/build/types/entry/vexflow-core.d.ts +2 -0
  213. package/build/types/entry/vexflow-debug.d.ts +2 -0
  214. package/build/types/entry/vexflow-font-bravura.d.ts +3771 -0
  215. package/build/types/entry/vexflow-font-custom.d.ts +86 -0
  216. package/build/types/entry/vexflow-font-gonville.d.ts +1267 -0
  217. package/build/types/entry/vexflow-font-petaluma.d.ts +1896 -0
  218. package/build/types/entry/vexflow-gonville.d.ts +2 -0
  219. package/build/types/entry/vexflow-petaluma.d.ts +2 -0
  220. package/build/types/entry/vexflow.d.ts +2 -0
  221. package/build/types/src/accidental.d.ts +66 -0
  222. package/build/types/src/annotation.d.ts +61 -0
  223. package/build/types/src/articulation.d.ts +62 -0
  224. package/build/types/src/barnote.d.ts +29 -0
  225. package/build/types/src/beam.d.ts +153 -0
  226. package/build/types/src/bend.d.ts +73 -0
  227. package/build/types/src/boundingbox.d.ts +42 -0
  228. package/build/types/src/boundingboxcomputation.d.ts +33 -0
  229. package/build/types/src/canvascontext.d.ts +89 -0
  230. package/build/types/src/chordsymbol.d.ts +149 -0
  231. package/build/types/src/clef.d.ts +48 -0
  232. package/build/types/src/clefnote.d.ts +25 -0
  233. package/build/types/src/crescendo.d.ts +27 -0
  234. package/build/types/src/curve.d.ts +41 -0
  235. package/build/types/src/dot.d.ts +20 -0
  236. package/build/types/src/easyscore.d.ts +152 -0
  237. package/build/types/src/element.d.ts +202 -0
  238. package/build/types/src/factory.d.ts +274 -0
  239. package/build/types/src/flow.d.ts +260 -0
  240. package/build/types/src/font.d.ts +180 -0
  241. package/build/types/src/fonts/bravura_glyphs.d.ts +3239 -0
  242. package/build/types/src/fonts/bravura_metrics.d.ts +533 -0
  243. package/build/types/src/fonts/custom_glyphs.d.ts +78 -0
  244. package/build/types/src/fonts/custom_metrics.d.ts +5 -0
  245. package/build/types/src/fonts/gonville_glyphs.d.ts +828 -0
  246. package/build/types/src/fonts/gonville_metrics.d.ts +440 -0
  247. package/build/types/src/fonts/load_all.d.ts +1 -0
  248. package/build/types/src/fonts/load_bravura.d.ts +1 -0
  249. package/build/types/src/fonts/load_custom.d.ts +1 -0
  250. package/build/types/src/fonts/load_gonville.d.ts +1 -0
  251. package/build/types/src/fonts/load_petaluma.d.ts +1 -0
  252. package/build/types/src/fonts/petaluma_glyphs.d.ts +1335 -0
  253. package/build/types/src/fonts/petaluma_metrics.d.ts +562 -0
  254. package/build/types/src/fonts/petalumascript_glyphs.d.ts +863 -0
  255. package/build/types/src/fonts/robotoslab_glyphs.d.ts +863 -0
  256. package/build/types/src/fonts/textfonts.d.ts +1 -0
  257. package/build/types/src/formatter.d.ts +203 -0
  258. package/build/types/src/fraction.d.ts +62 -0
  259. package/build/types/src/frethandfinger.d.ts +22 -0
  260. package/build/types/src/ghostnote.d.ts +16 -0
  261. package/build/types/src/glyph.d.ts +141 -0
  262. package/build/types/src/glyphnote.d.ts +17 -0
  263. package/build/types/src/gracenote.d.ts +19 -0
  264. package/build/types/src/gracenotegroup.d.ts +33 -0
  265. package/build/types/src/gracetabnote.d.ts +5 -0
  266. package/build/types/src/index.d.ts +89 -0
  267. package/build/types/src/keymanager.d.ts +25 -0
  268. package/build/types/src/keysignature.d.ts +50 -0
  269. package/build/types/src/keysignote.d.ts +11 -0
  270. package/build/types/src/modifier.d.ts +97 -0
  271. package/build/types/src/modifiercontext.d.ts +45 -0
  272. package/build/types/src/multimeasurerest.d.ts +61 -0
  273. package/build/types/src/music.d.ts +91 -0
  274. package/build/types/src/note.d.ts +232 -0
  275. package/build/types/src/notehead.d.ts +70 -0
  276. package/build/types/src/notesubgroup.d.ts +18 -0
  277. package/build/types/src/ornament.d.ts +76 -0
  278. package/build/types/src/parenthesis.d.ts +22 -0
  279. package/build/types/src/parser.d.ts +45 -0
  280. package/build/types/src/pedalmarking.d.ts +69 -0
  281. package/build/types/src/registry.d.ts +40 -0
  282. package/build/types/src/rendercontext.d.ts +64 -0
  283. package/build/types/src/renderer.d.ts +35 -0
  284. package/build/types/src/repeatnote.d.ts +6 -0
  285. package/build/types/src/stave.d.ts +186 -0
  286. package/build/types/src/stavebarline.d.ts +28 -0
  287. package/build/types/src/staveconnector.d.ts +67 -0
  288. package/build/types/src/stavehairpin.d.ts +56 -0
  289. package/build/types/src/staveline.d.ts +54 -0
  290. package/build/types/src/stavemodifier.d.ts +44 -0
  291. package/build/types/src/stavenote.d.ts +154 -0
  292. package/build/types/src/staverepetition.d.ts +32 -0
  293. package/build/types/src/stavesection.d.ts +15 -0
  294. package/build/types/src/stavetempo.d.ts +25 -0
  295. package/build/types/src/stavetext.d.ts +25 -0
  296. package/build/types/src/stavetie.d.ts +59 -0
  297. package/build/types/src/stavevolta.d.ts +21 -0
  298. package/build/types/src/stem.d.ts +58 -0
  299. package/build/types/src/stemmablenote.d.ts +39 -0
  300. package/build/types/src/stringnumber.d.ts +27 -0
  301. package/build/types/src/strokes.d.ts +33 -0
  302. package/build/types/src/svgcontext.d.ts +131 -0
  303. package/build/types/src/system.d.ts +92 -0
  304. package/build/types/src/tables.d.ts +96 -0
  305. package/build/types/src/tabnote.d.ts +44 -0
  306. package/build/types/src/tabslide.d.ts +34 -0
  307. package/build/types/src/tabstave.d.ts +7 -0
  308. package/build/types/src/tabtie.d.ts +18 -0
  309. package/build/types/src/textbracket.d.ts +55 -0
  310. package/build/types/src/textdynamics.d.ts +39 -0
  311. package/build/types/src/textformatter.d.ts +109 -0
  312. package/build/types/src/textnote.d.ts +49 -0
  313. package/build/types/src/tickable.d.ts +140 -0
  314. package/build/types/src/tickcontext.d.ts +82 -0
  315. package/build/types/src/timesigglyph.d.ts +14 -0
  316. package/build/types/src/timesignature.d.ts +26 -0
  317. package/build/types/src/timesignote.d.ts +11 -0
  318. package/build/types/src/tremolo.d.ts +17 -0
  319. package/build/types/src/tuning.d.ts +23 -0
  320. package/build/types/src/tuplet.d.ts +105 -0
  321. package/build/types/src/typeguard.d.ts +99 -0
  322. package/build/types/src/util.d.ts +27 -0
  323. package/build/types/src/version.d.ts +3 -0
  324. package/build/types/src/vex.d.ts +18 -0
  325. package/build/types/src/vibrato.d.ts +29 -0
  326. package/build/types/src/vibratobracket.d.ts +33 -0
  327. package/build/types/src/voice.d.ts +108 -0
  328. package/build/types/src/web.d.ts +2 -0
  329. package/entry/vexflow-bravura.ts +3 -3
  330. package/entry/vexflow-core.ts +3 -3
  331. package/entry/vexflow-debug-with-tests.ts +16 -2
  332. package/entry/vexflow-debug.ts +11 -3
  333. package/entry/vexflow-gonville.ts +3 -3
  334. package/entry/vexflow-petaluma.ts +3 -3
  335. package/entry/vexflow.ts +3 -3
  336. package/package.json +1 -1
  337. package/src/annotation.ts +38 -6
  338. package/src/articulation.ts +8 -2
  339. package/src/beam.ts +53 -6
  340. package/src/easyscore.ts +11 -1
  341. package/src/factory.ts +16 -2
  342. package/src/flow.ts +35 -20
  343. package/src/font.ts +0 -4
  344. package/src/fonts/gonville_glyphs.ts +4 -4
  345. package/src/formatter.ts +24 -8
  346. package/src/glyph.ts +8 -0
  347. package/src/index.ts +2 -7
  348. package/src/note.ts +2 -1
  349. package/src/staveline.ts +2 -5
  350. package/src/stavenote.ts +13 -9
  351. package/src/stavetext.ts +3 -3
  352. package/src/system.ts +1 -7
  353. package/src/textnote.ts +9 -11
@@ -0,0 +1,371 @@
1
+ import { Font } from './font.js';
2
+ import { drawDot } from './rendercontext.js';
3
+ import { Tables } from './tables.js';
4
+ import { Tickable } from './tickable.js';
5
+ import { defined, RuntimeError } from './util.js';
6
+ export class Note extends Tickable {
7
+ constructor(noteStruct) {
8
+ super();
9
+ if (!noteStruct) {
10
+ throw new RuntimeError('BadArguments', 'Note must have valid initialization data to identify duration and type.');
11
+ }
12
+ const parsedNoteStruct = Note.parseNoteStruct(noteStruct);
13
+ if (!parsedNoteStruct) {
14
+ throw new RuntimeError('BadArguments', `Invalid note initialization object: ${JSON.stringify(noteStruct)}`);
15
+ }
16
+ this.keys = noteStruct.keys || [];
17
+ this.keyProps = [];
18
+ this.duration = parsedNoteStruct.duration;
19
+ this.noteType = parsedNoteStruct.type;
20
+ this.customTypes = parsedNoteStruct.customTypes;
21
+ if (noteStruct.duration_override) {
22
+ this.setDuration(noteStruct.duration_override);
23
+ }
24
+ else {
25
+ this.setIntrinsicTicks(parsedNoteStruct.ticks);
26
+ }
27
+ this.modifiers = [];
28
+ this.glyph = Tables.getGlyphProps(this.duration, this.noteType);
29
+ this.customGlyphs = this.customTypes.map((t) => Tables.getGlyphProps(this.duration, t));
30
+ this.playNote = undefined;
31
+ this.ignore_ticks = false;
32
+ this.width = 0;
33
+ this.leftDisplacedHeadPx = 0;
34
+ this.rightDisplacedHeadPx = 0;
35
+ this.x_shift = 0;
36
+ this.ys = [];
37
+ if (noteStruct.align_center) {
38
+ this.setCenterAlignment(noteStruct.align_center);
39
+ }
40
+ this.render_options = {
41
+ annotation_spacing: 5,
42
+ glyph_font_scale: 1,
43
+ stroke_px: 1,
44
+ scale: 1,
45
+ font: '',
46
+ y_shift: 0,
47
+ };
48
+ }
49
+ static get CATEGORY() {
50
+ return "Note";
51
+ }
52
+ static plotMetrics(ctx, note, yPos) {
53
+ const metrics = note.getMetrics();
54
+ const xStart = note.getAbsoluteX() - metrics.modLeftPx - metrics.leftDisplacedHeadPx;
55
+ const xPre1 = note.getAbsoluteX() - metrics.leftDisplacedHeadPx;
56
+ const xAbs = note.getAbsoluteX();
57
+ const xPost1 = note.getAbsoluteX() + metrics.notePx;
58
+ const xPost2 = note.getAbsoluteX() + metrics.notePx + metrics.rightDisplacedHeadPx;
59
+ const xEnd = note.getAbsoluteX() + metrics.notePx + metrics.rightDisplacedHeadPx + metrics.modRightPx;
60
+ const xFreedomRight = xEnd + (note.getFormatterMetrics().freedom.right || 0);
61
+ const xWidth = xEnd - xStart;
62
+ ctx.save();
63
+ ctx.setFont(Font.SANS_SERIF, 8);
64
+ ctx.fillText(Math.round(xWidth) + 'px', xStart + note.getXShift(), yPos);
65
+ const y = yPos + 7;
66
+ function stroke(x1, x2, color, yy = y) {
67
+ ctx.beginPath();
68
+ ctx.setStrokeStyle(color);
69
+ ctx.setFillStyle(color);
70
+ ctx.setLineWidth(3);
71
+ ctx.moveTo(x1 + note.getXShift(), yy);
72
+ ctx.lineTo(x2 + note.getXShift(), yy);
73
+ ctx.stroke();
74
+ }
75
+ stroke(xStart, xPre1, 'red');
76
+ stroke(xPre1, xAbs, '#999');
77
+ stroke(xAbs, xPost1, 'green');
78
+ stroke(xPost1, xPost2, '#999');
79
+ stroke(xPost2, xEnd, 'red');
80
+ stroke(xEnd, xFreedomRight, '#DD0');
81
+ stroke(xStart - note.getXShift(), xStart, '#BBB');
82
+ drawDot(ctx, xAbs + note.getXShift(), y, 'blue');
83
+ const formatterMetrics = note.getFormatterMetrics();
84
+ if (formatterMetrics.iterations > 0) {
85
+ const spaceDeviation = formatterMetrics.space.deviation;
86
+ const prefix = spaceDeviation >= 0 ? '+' : '';
87
+ ctx.setFillStyle('red');
88
+ ctx.fillText(prefix + Math.round(spaceDeviation), xAbs + note.getXShift(), yPos - 10);
89
+ }
90
+ ctx.restore();
91
+ }
92
+ static parseDuration(durationString) {
93
+ if (!durationString) {
94
+ return undefined;
95
+ }
96
+ const regexp = /(\d*\/?\d+|[a-z])(d*)([nrhms]|$)/;
97
+ const result = regexp.exec(durationString);
98
+ if (!result) {
99
+ return undefined;
100
+ }
101
+ const duration = result[1];
102
+ const dots = result[2].length;
103
+ const type = result[3] || 'n';
104
+ return { duration, dots, type };
105
+ }
106
+ static parseNoteStruct(noteStruct) {
107
+ const durationProps = Note.parseDuration(noteStruct.duration);
108
+ if (!durationProps) {
109
+ return undefined;
110
+ }
111
+ let type = noteStruct.type;
112
+ if (type && !Tables.validTypes[type]) {
113
+ return undefined;
114
+ }
115
+ const customTypes = [];
116
+ if (!type) {
117
+ type = durationProps.type || 'n';
118
+ if (noteStruct.keys !== undefined) {
119
+ noteStruct.keys.forEach((k, i) => {
120
+ const result = k.split('/');
121
+ customTypes[i] = (result && result.length === 3 ? result[2] : type);
122
+ });
123
+ }
124
+ }
125
+ let ticks = Tables.durationToTicks(durationProps.duration);
126
+ if (!ticks) {
127
+ return undefined;
128
+ }
129
+ const dots = noteStruct.dots ? noteStruct.dots : durationProps.dots;
130
+ if (typeof dots !== 'number') {
131
+ return undefined;
132
+ }
133
+ let currentTicks = ticks;
134
+ for (let i = 0; i < dots; i++) {
135
+ if (currentTicks <= 1)
136
+ return undefined;
137
+ currentTicks = currentTicks / 2;
138
+ ticks += currentTicks;
139
+ }
140
+ return {
141
+ duration: durationProps.duration,
142
+ type,
143
+ customTypes,
144
+ dots,
145
+ ticks,
146
+ };
147
+ }
148
+ getPlayNote() {
149
+ return this.playNote;
150
+ }
151
+ setPlayNote(note) {
152
+ this.playNote = note;
153
+ return this;
154
+ }
155
+ isRest() {
156
+ return false;
157
+ }
158
+ addStroke(index, stroke) {
159
+ stroke.setNote(this);
160
+ stroke.setIndex(index);
161
+ this.modifiers.push(stroke);
162
+ this.preFormatted = false;
163
+ return this;
164
+ }
165
+ getStave() {
166
+ return this.stave;
167
+ }
168
+ checkStave() {
169
+ return defined(this.stave, 'NoStave', 'No stave attached to instance.');
170
+ }
171
+ setStave(stave) {
172
+ this.stave = stave;
173
+ this.setYs([stave.getYForLine(0)]);
174
+ this.setContext(this.stave.getContext());
175
+ return this;
176
+ }
177
+ getLeftDisplacedHeadPx() {
178
+ return this.leftDisplacedHeadPx;
179
+ }
180
+ getRightDisplacedHeadPx() {
181
+ return this.rightDisplacedHeadPx;
182
+ }
183
+ setLeftDisplacedHeadPx(x) {
184
+ this.leftDisplacedHeadPx = x;
185
+ return this;
186
+ }
187
+ setRightDisplacedHeadPx(x) {
188
+ this.rightDisplacedHeadPx = x;
189
+ return this;
190
+ }
191
+ shouldIgnoreTicks() {
192
+ return this.ignore_ticks;
193
+ }
194
+ getLineNumber(isTopNote) {
195
+ return 0;
196
+ }
197
+ getLineForRest() {
198
+ return 0;
199
+ }
200
+ getGlyph() {
201
+ return this.glyph;
202
+ }
203
+ getGlyphWidth() {
204
+ if (this.glyph) {
205
+ if (this.glyph.getMetrics) {
206
+ return this.glyph.getMetrics().width;
207
+ }
208
+ else if (this.glyph.getWidth) {
209
+ return this.glyph.getWidth(this.render_options.glyph_font_scale);
210
+ }
211
+ }
212
+ return 0;
213
+ }
214
+ setYs(ys) {
215
+ this.ys = ys;
216
+ return this;
217
+ }
218
+ getYs() {
219
+ if (this.ys.length === 0) {
220
+ throw new RuntimeError('NoYValues', 'No Y-values calculated for this note.');
221
+ }
222
+ return this.ys;
223
+ }
224
+ getYForTopText(text_line) {
225
+ return this.checkStave().getYForTopText(text_line);
226
+ }
227
+ getVoice() {
228
+ if (!this.voice)
229
+ throw new RuntimeError('NoVoice', 'Note has no voice.');
230
+ return this.voice;
231
+ }
232
+ setVoice(voice) {
233
+ this.voice = voice;
234
+ this.preFormatted = false;
235
+ return this;
236
+ }
237
+ getTickContext() {
238
+ return this.checkTickContext();
239
+ }
240
+ setTickContext(tc) {
241
+ this.tickContext = tc;
242
+ this.preFormatted = false;
243
+ return this;
244
+ }
245
+ getDuration() {
246
+ return this.duration;
247
+ }
248
+ isDotted() {
249
+ return this.getModifiersByType('Dot').length > 0;
250
+ }
251
+ hasStem() {
252
+ return false;
253
+ }
254
+ getNoteType() {
255
+ return this.noteType;
256
+ }
257
+ getBeam() {
258
+ return this.beam;
259
+ }
260
+ checkBeam() {
261
+ return defined(this.beam, 'NoBeam', 'No beam attached to instance');
262
+ }
263
+ hasBeam() {
264
+ return this.beam != undefined;
265
+ }
266
+ setBeam(beam) {
267
+ this.beam = beam;
268
+ return this;
269
+ }
270
+ addModifier(modifier, index = 0) {
271
+ const signature = 'Note.addModifier(modifier: Modifier, index: number=0)';
272
+ if (typeof index === 'string') {
273
+ index = parseInt(index);
274
+ console.warn(signature + ' expected a number for `index`, but received a string.');
275
+ }
276
+ if (typeof modifier !== 'object' || typeof index !== 'number') {
277
+ throw new RuntimeError('WrongParams', 'Incorrect call signature. Use ' + signature + ' instead.');
278
+ }
279
+ modifier.setNote(this);
280
+ modifier.setIndex(index);
281
+ super.addModifier(modifier);
282
+ return this;
283
+ }
284
+ getModifiersByType(type) {
285
+ return this.modifiers.filter((modifier) => modifier.getCategory() === type);
286
+ }
287
+ getModifierStartXY(position, index, options) {
288
+ if (!this.preFormatted) {
289
+ throw new RuntimeError('UnformattedNote', "Can't call GetModifierStartXY on an unformatted note");
290
+ }
291
+ return {
292
+ x: this.getAbsoluteX(),
293
+ y: this.ys[0],
294
+ };
295
+ }
296
+ getRightParenthesisPx(index) {
297
+ const props = this.getKeyProps()[index];
298
+ return props.displaced ? this.getRightDisplacedHeadPx() : 0;
299
+ }
300
+ getLeftParenthesisPx(index) {
301
+ const props = this.getKeyProps()[index];
302
+ return props.displaced ? this.getLeftDisplacedHeadPx() - this.x_shift : -this.x_shift;
303
+ }
304
+ getFirstDotPx() {
305
+ let px = this.getRightDisplacedHeadPx();
306
+ if (this.checkModifierContext().getMembers('Parenthesis').length !== 0)
307
+ px += Tables.currentMusicFont().lookupMetric('parenthesis.default.width');
308
+ return px;
309
+ }
310
+ getMetrics() {
311
+ if (!this.preFormatted) {
312
+ throw new RuntimeError('UnformattedNote', "Can't call getMetrics on an unformatted note.");
313
+ }
314
+ const modLeftPx = this.modifierContext ? this.modifierContext.getState().left_shift : 0;
315
+ const modRightPx = this.modifierContext ? this.modifierContext.getState().right_shift : 0;
316
+ const width = this.getWidth();
317
+ const glyphWidth = this.getGlyphWidth();
318
+ const notePx = width -
319
+ modLeftPx -
320
+ modRightPx -
321
+ this.leftDisplacedHeadPx -
322
+ this.rightDisplacedHeadPx;
323
+ return {
324
+ width,
325
+ glyphWidth,
326
+ notePx,
327
+ modLeftPx,
328
+ modRightPx,
329
+ leftDisplacedHeadPx: this.leftDisplacedHeadPx,
330
+ rightDisplacedHeadPx: this.rightDisplacedHeadPx,
331
+ glyphPx: 0,
332
+ };
333
+ }
334
+ getAbsoluteX() {
335
+ const tickContext = this.checkTickContext(`Can't getAbsoluteX() without a TickContext.`);
336
+ let x = tickContext.getX();
337
+ if (this.stave) {
338
+ x += this.stave.getNoteStartX() + Tables.currentMusicFont().lookupMetric('stave.padding');
339
+ }
340
+ if (this.isCenterAligned()) {
341
+ x += this.getCenterXShift();
342
+ }
343
+ return x;
344
+ }
345
+ getStemDirection() {
346
+ throw new RuntimeError('NoStem', 'No stem attached to this note.');
347
+ }
348
+ getStemExtents() {
349
+ throw new RuntimeError('NoStem', 'No stem attached to this note.');
350
+ }
351
+ getTieRightX() {
352
+ let tieStartX = this.getAbsoluteX();
353
+ const note_glyph_width = this.glyph.getWidth();
354
+ tieStartX += note_glyph_width / 2;
355
+ tieStartX += -this.width / 2 + this.width + 2;
356
+ return tieStartX;
357
+ }
358
+ getTieLeftX() {
359
+ let tieEndX = this.getAbsoluteX();
360
+ const note_glyph_width = this.glyph.getWidth();
361
+ tieEndX += note_glyph_width / 2;
362
+ tieEndX -= this.width / 2 + 2;
363
+ return tieEndX;
364
+ }
365
+ getKeys() {
366
+ return this.keys;
367
+ }
368
+ getKeyProps() {
369
+ return this.keyProps;
370
+ }
371
+ }
@@ -0,0 +1,169 @@
1
+ import { BoundingBox } from './boundingbox.js';
2
+ import { Glyph } from './glyph.js';
3
+ import { Note } from './note.js';
4
+ import { Stem } from './stem.js';
5
+ import { Tables } from './tables.js';
6
+ import { defined, log, RuntimeError } from './util.js';
7
+ function L(...args) {
8
+ if (NoteHead.DEBUG)
9
+ log('Vex.Flow.NoteHead', args);
10
+ }
11
+ function drawSlashNoteHead(ctx, duration, x, y, stem_direction, staveSpace) {
12
+ const width = Tables.SLASH_NOTEHEAD_WIDTH;
13
+ ctx.save();
14
+ ctx.setLineWidth(Tables.STEM_WIDTH);
15
+ let fill = false;
16
+ if (Tables.durationToNumber(duration) > 2) {
17
+ fill = true;
18
+ }
19
+ if (!fill)
20
+ x -= (Tables.STEM_WIDTH / 2) * stem_direction;
21
+ ctx.beginPath();
22
+ ctx.moveTo(x, y + staveSpace);
23
+ ctx.lineTo(x, y + 1);
24
+ ctx.lineTo(x + width, y - staveSpace);
25
+ ctx.lineTo(x + width, y);
26
+ ctx.lineTo(x, y + staveSpace);
27
+ ctx.closePath();
28
+ if (fill) {
29
+ ctx.fill();
30
+ }
31
+ else {
32
+ ctx.stroke();
33
+ }
34
+ if (Tables.durationToFraction(duration).equals(0.5)) {
35
+ const breve_lines = [-3, -1, width + 1, width + 3];
36
+ for (let i = 0; i < breve_lines.length; i++) {
37
+ ctx.beginPath();
38
+ ctx.moveTo(x + breve_lines[i], y - 10);
39
+ ctx.lineTo(x + breve_lines[i], y + 11);
40
+ ctx.stroke();
41
+ }
42
+ }
43
+ ctx.restore();
44
+ }
45
+ export class NoteHead extends Note {
46
+ constructor(noteStruct) {
47
+ super(noteStruct);
48
+ this.custom_glyph = false;
49
+ this.stem_up_x_offset = 0;
50
+ this.stem_down_x_offset = 0;
51
+ this.index = noteStruct.index;
52
+ this.x = noteStruct.x || 0;
53
+ this.y = noteStruct.y || 0;
54
+ if (noteStruct.note_type)
55
+ this.noteType = noteStruct.note_type;
56
+ this.displaced = noteStruct.displaced || false;
57
+ this.stem_direction = noteStruct.stem_direction || Stem.UP;
58
+ this.line = noteStruct.line || 0;
59
+ this.glyph = Tables.getGlyphProps(this.duration, this.noteType);
60
+ defined(this.glyph, 'BadArguments', `No glyph found for duration '${this.duration}' and type '${this.noteType}'`);
61
+ this.glyph_code = this.glyph.code_head;
62
+ this.x_shift = noteStruct.x_shift || 0;
63
+ if (noteStruct.custom_glyph_code) {
64
+ this.custom_glyph = true;
65
+ this.glyph_code = noteStruct.custom_glyph_code;
66
+ this.stem_up_x_offset = noteStruct.stem_up_x_offset || 0;
67
+ this.stem_down_x_offset = noteStruct.stem_down_x_offset || 0;
68
+ }
69
+ this.style = noteStruct.style;
70
+ this.slashed = noteStruct.slashed || false;
71
+ this.render_options = Object.assign(Object.assign({}, this.render_options), { glyph_font_scale: noteStruct.glyph_font_scale || Tables.NOTATION_FONT_SCALE });
72
+ this.setWidth(this.glyph.getWidth(this.render_options.glyph_font_scale));
73
+ }
74
+ static get CATEGORY() {
75
+ return "NoteHead";
76
+ }
77
+ getWidth() {
78
+ return this.width;
79
+ }
80
+ isDisplaced() {
81
+ return this.displaced === true;
82
+ }
83
+ getGlyph() {
84
+ return this.glyph;
85
+ }
86
+ setX(x) {
87
+ this.x = x;
88
+ return this;
89
+ }
90
+ getY() {
91
+ return this.y;
92
+ }
93
+ setY(y) {
94
+ this.y = y;
95
+ return this;
96
+ }
97
+ getLine() {
98
+ return this.line;
99
+ }
100
+ setLine(line) {
101
+ this.line = line;
102
+ return this;
103
+ }
104
+ getAbsoluteX() {
105
+ const x = !this.preFormatted ? this.x : super.getAbsoluteX();
106
+ const displacementStemAdjustment = Stem.WIDTH / 2;
107
+ const musicFont = Tables.currentMusicFont();
108
+ const fontShift = musicFont.lookupMetric('notehead.shiftX', 0) * this.stem_direction;
109
+ const displacedFontShift = musicFont.lookupMetric('noteHead.displaced.shiftX', 0) * this.stem_direction;
110
+ return (x +
111
+ fontShift +
112
+ (this.displaced ? (this.width - displacementStemAdjustment) * this.stem_direction + displacedFontShift : 0));
113
+ }
114
+ getBoundingBox() {
115
+ if (!this.preFormatted) {
116
+ throw new RuntimeError('UnformattedNote', "Can't call getBoundingBox on an unformatted note.");
117
+ }
118
+ const spacing = this.checkStave().getSpacingBetweenLines();
119
+ const half_spacing = spacing / 2;
120
+ const min_y = this.y - half_spacing;
121
+ return new BoundingBox(this.getAbsoluteX(), min_y, this.width, spacing);
122
+ }
123
+ setStave(stave) {
124
+ const line = this.getLine();
125
+ this.stave = stave;
126
+ if (this.stave) {
127
+ this.setY(this.stave.getYForNote(line));
128
+ this.setContext(this.stave.getContext());
129
+ }
130
+ return this;
131
+ }
132
+ preFormat() {
133
+ if (this.preFormatted)
134
+ return this;
135
+ const width = this.getWidth() + this.leftDisplacedHeadPx + this.rightDisplacedHeadPx;
136
+ this.setWidth(width);
137
+ this.preFormatted = true;
138
+ return this;
139
+ }
140
+ draw() {
141
+ const ctx = this.checkContext();
142
+ this.setRendered();
143
+ let head_x = this.getAbsoluteX();
144
+ if (this.custom_glyph) {
145
+ head_x += this.stem_direction === Stem.UP ? this.stem_up_x_offset : this.stem_down_x_offset;
146
+ }
147
+ const y = this.y;
148
+ L("Drawing note head '", this.noteType, this.duration, "' at", head_x, y);
149
+ const stem_direction = this.stem_direction;
150
+ const glyph_font_scale = this.render_options.glyph_font_scale;
151
+ if (this.style) {
152
+ this.applyStyle(ctx);
153
+ }
154
+ const categorySuffix = `${this.glyph_code}Stem${stem_direction === Stem.UP ? 'Up' : 'Down'}`;
155
+ if (this.noteType === 's') {
156
+ const staveSpace = this.checkStave().getSpacingBetweenLines();
157
+ drawSlashNoteHead(ctx, this.duration, head_x, y, stem_direction, staveSpace);
158
+ }
159
+ else {
160
+ Glyph.renderGlyph(ctx, head_x, y, glyph_font_scale, this.glyph_code, {
161
+ category: this.custom_glyph ? `noteHead.custom.${categorySuffix}` : `noteHead.standard.${categorySuffix}`,
162
+ });
163
+ }
164
+ if (this.style) {
165
+ this.restoreStyle(ctx);
166
+ }
167
+ }
168
+ }
169
+ NoteHead.DEBUG = false;
@@ -0,0 +1,59 @@
1
+ import { Formatter } from './formatter.js';
2
+ import { Modifier } from './modifier.js';
3
+ import { Tables } from './tables.js';
4
+ import { Voice } from './voice.js';
5
+ export class NoteSubGroup extends Modifier {
6
+ constructor(subNotes) {
7
+ super();
8
+ this.preFormatted = false;
9
+ this.position = Modifier.Position.LEFT;
10
+ this.subNotes = subNotes;
11
+ this.subNotes.forEach((subNote) => {
12
+ subNote.setIgnoreTicks(false);
13
+ });
14
+ this.width = 0;
15
+ this.formatter = new Formatter();
16
+ this.voice = new Voice({
17
+ num_beats: 4,
18
+ beat_value: 4,
19
+ resolution: Tables.RESOLUTION,
20
+ }).setStrict(false);
21
+ this.voice.addTickables(this.subNotes);
22
+ }
23
+ static get CATEGORY() {
24
+ return "NoteSubGroup";
25
+ }
26
+ static format(groups, state) {
27
+ if (!groups || groups.length === 0)
28
+ return false;
29
+ let width = 0;
30
+ for (let i = 0; i < groups.length; ++i) {
31
+ const group = groups[i];
32
+ group.preFormat();
33
+ width += group.getWidth();
34
+ }
35
+ state.left_shift += width;
36
+ return true;
37
+ }
38
+ preFormat() {
39
+ if (this.preFormatted)
40
+ return;
41
+ this.formatter.joinVoices([this.voice]).format([this.voice], 0);
42
+ this.setWidth(this.formatter.getMinTotalWidth());
43
+ this.preFormatted = true;
44
+ }
45
+ setWidth(width) {
46
+ this.width = width;
47
+ return this;
48
+ }
49
+ getWidth() {
50
+ return this.width;
51
+ }
52
+ draw() {
53
+ const ctx = this.checkContext();
54
+ const note = this.checkAttachedNote();
55
+ this.setRendered();
56
+ this.alignSubNotesWithNote(this.subNotes, note);
57
+ this.subNotes.forEach((subNote) => subNote.setContext(ctx).drawWithStyle());
58
+ }
59
+ }