New VHV feature: URL with embedded data

[Craig Sapp]

Hello **HUGers,

Here is an interesting recent feature added to VHV:  There is now a menu option to copy a short musical score into a URL.  This means that you can send a URL to someone with a short example rather than sending them the data only, requiring them to open VHV and copy the contents.   Also the URLs can be given as links on a webpage to open small examples in VHV without having to host the data somewhere on the web.

Example:

Here is a C melodic minor scale in VHV:

To create the URL containing the Humdrum data, go to the File menu and then select the "Copy MIME URL" at the bottom of the menu:

This will copy to the system clipboard the following URL:

https://verovio.humdrum.org?t=ISEhT1RMOiBDIG1lbG9kaWMgbWlub3Igc2NhbGUKKiprZXJuCSoqa2Vybgoqa1tiLWUtYS1dCSprW2ItZS1hLV0KNEMJNGMKNEQJNGQKNEUtCTRlLQo0Rgk0Zgo0Rwk0Zwo0QQk0YQo0Qgk0Ygo0Ywk0Y2MKNEItCTRiLQo0QS0JNGEtCjRHCTRnCjRGCTRmCjRFLQk0ZS0KNEQJNGQKNEMJNGMKPQk9CiotCSot

The contents of the t parameter in the URL is MIME encoded contents from the editor.

If you paste that URL into a web browser, you can see the same text displayed in VHV that is extracted from the URL:

You can also use some setup parameters to simplify the interface using the "k" url parameter:

k = E   hide the menu/toolbar when loading VHV

k = y    hide the text editor when loading VHV

k = b   hide the VHV logo when loading VHV

k = e   suppress the splash music when loading VHV

Here is an example using all of the settings:

https://verovio.humdrum.org?k=Ebey&t=ISEhT1RMOiBDIG1lbG9kaWMgbWlub3Igc2NhbGUKKiprZXJuCSoqa2Vybgoqa1tiLWUtYS1dCSprW2ItZS1hLV0KNEMJNGMKNEQJNGQKNEUtCTRlLQo0Rgk0Zgo0Rwk0Zwo0QQk0YQo0Qgk0Ygo0Ywk0Y2MKNEItCTRiLQo0QS0JNGEtCjRHCTRnCjRGCTRmCjRFLQk0ZS0KNEQJNGQKNEMJNGMKPQk9CiotCSot

Which will give a minimal display with only the title on the left and a play button on the right:

Filters can also be used with the embedded score.  In the following case the scale is encoded in C minor, but the filter command transposed to F minor and changes the text from C minor to F minor in the text above the staff:

https://verovio.humdrum.org?filter=shed%20-e%20s%2FC%2FF%2FL%7Ctranspose%20-kf&t=ISEhT1RMOiBNZWxvZGljIG1pbm9yIHNjYWxlCioqa2VybgkqKmtlcm4KKmNsZWZGNAkqY2xlZkcyCiprW2ItZS1hLV0JKmtbYi1lLWEtXQoqYzoJKmM6CiEJIUxPOlRYOkI6dD1DIG1lbG9kaWMgbWlub3IKNEMJNGMKNEQJNGQKNEUtCTRlLQo0Rgk0Zgo0Rwk0Zwo0QQk0YQo0Qgk0Ygo0Ywk0Y2MKNEItCTRiLQo0QS0JNGEtCjRHCTRnCjRGCTRmCjRFLQk0ZS0KNEQJNGQKNEMJNGMKPQk9CiotCSot

Transposing the same data to G minor using the same data and modifying with filters:

https://verovio.humdrum.org?filter=shed%20-e%20s%2FC%2FG%2FL%7Ctranspose%20-kg&t=ISEhT1RMOiBNZWxvZGljIG1pbm9yIHNjYWxlCioqa2VybgkqKmtlcm4KKmNsZWZGNAkqY2xlZkcyCiprW2ItZS1hLV0JKmtbYi1lLWEtXQoqYzoJKmM6CiEJIUxPOlRYOkI6dD1DIG1lbG9kaWMgbWlub3IKNEMJNGMKNEQJNGQKNEUtCTRlLQo0Rgk0Zgo0Rwk0Zwo0QQk0YQo0Qgk0Ygo0Ywk0Y2MKNEItCTRiLQo0QS0JNGEtCjRHCTRnCjRGCTRmCjRFLQk0ZS0KNEQJNGQKNEMJNGMKPQk9CiotCSot

URL lengths are usually limited to around 2000 characters in many web browsers, so data creating a URL longer than 2083 characters will generate a warning message when copying the link to the system clipboard.

-=+Craig