An apology. I’d hoped to β-test rather sooner but I was called in for an NHS operation! 😳 Seriously … 🙂 But its nature has me still on my couch, coding on an iPad. Sadly I’ll miss FolkEast, and Whitby too
Back to topic. The API is now mostly bug free 😉, and has been attached to a test page at
https://chrisryall.net/rodecs/ It’s termed a ‘playground’ because it offers interested parties a chance to digest the concept of Rodecs, which can describe
any melodeon layout in a standardised way. The playground is self documenting including an [explain syntax] button and a list of the importable API methods. The output is the same layout expressed as a JSON object in the lower text box. Both boxes may be copied, but only the input may be edited or CTRL-V ‘pasted’. It is then a matter for simulation developers to make that JSON do … whatever they choose. But they’ll all have access to a common library of layouts, not have to type them in, and eventually that library will be free of bugs too 👍
I’ve attached a gamut of test layouts to the framework, its access button is bottom left. Feel free to try them out. If you want to edit something suitable towards your own layout - go ahead. But keep a copy in your own text file. I’ve gone off the idea of saving within a browser as clearing its cashe, or several other mishaps can lose your work. Also, no way to transfer to another browser 🥴
I’d like to offer special thanks to Lester and take up his offer to ‘break’ the API. There
will be issues 🥴 `Meanwhile
1 [normalise] is not yet implemented and will be a nice test. It’ll take eg a C/G layout with “transpose: 7†semitones => D/G,
and actually
do that. Result a melodeon in D/G tonality, ‘transpose: 0’. Which might replace the one in the library 👍
2 The [explore …] button is disabled. A stub for me as I’m interested in an implementation to find chords and scales on
any layout, and so will use the API’s RDCgetObjectsPushOrPullNotes() method to display push and pull views of chords separately.
3 Other implementations might simply be “to playâ€, or a graphic generator for luthier diagrams, as in the melnet library.
Rodecs abandon the old C, C’, C’’ C’’’ notation in favour of piano tuner’s, in which C4 is ‘middle’. Octave of zero indicates a bass
A note name in lower case asks for a minor triad, as per usual. (Please note that 3rds are
developer dependent).
4. Anything else is limited … only by developer imagination. An implementation might be on the same site as its editor, but rodec
notation is concise enough to pass via a URL query string (eg. see the address box above this page). A central resource could
launch an application …,anywhere on the web.
Time for a whiskey.