Las URLs pueden incluir parámetros que se pasan a la página web de VHV. Los parámetros se añaden a la dirección URL principal después del carácter ``. Cada parámetro está separado del siguiente por & y cada parámetro consiste en un par de clave y valor que están separados entre sí por =. A continuación se muestra un ejemplo de URL que contiene todas estas características:
Las piezas de la URL completa son:
https://verovio.humdrum.org- La parte principal de la URL.
?- El inicio de la lista de parámetros.
k=Ebey- El primer parámetro, siendo
kel nombre del parámetro yEbeyel valor del parámetrok. &- Carácter separador de parámetros.
file=beethoven/sonatas/sonata01-1.krn- El segundo parámetro de la URL llamado
filecon un valor debeethoven/sonatas/sonata01-1.krn.
El orden de los parámetros es indiferente, por lo que k puede ir, de forma equivalente, después de file:
Ten también en cuenta que ciertos caracteres no están permitidos dentro de los valores de los parámetros, como &, obviamente. En su lugar, estos caracteres deben escaparse utilizando codificación de porcentaje. Además de la lista de esa página, las nuevas líneas deben escaparse como los caracteres %0A, los tabuladores como %09 y los espacios como %20. La codificación porcentual es un valor hexadecimal para los códigos de bytes ASCII (o generalmente UTF-8) del carácter.
Parámetros de configuración
k/keys
El parámetro k (forma larga keys) se puede utilizar para emular los atajos de teclado que se ejecutan inmediatamente después de cargar VHV. Los caracteres de la siguiente tabla se dan en una cadena al parámetro. Aquí hay un ejemplo de uso para mostrar los controles mínimos en VHV:
https://verovio.humdrum.org/?k=Ebey&file=beethoven/sonatas/sonata01-1.krn
La cadena Ebey equivale a escribir
alt-shift-E,
alt-b,
alt-e,
alt-y después de la carga de VHV. El orden de las letras no importa, por lo que Ebey y bEey son equivalentes.
| Carácter | Atajo VHV | Significado | |
|---|---|---|---|
B |
alt-shift-B | Ocultar la barra de herramientas. | |
b |
alt-b | Suprimir el logotipo de VHV en la parte superior izquierda de la ventana de VHV. | |
d |
alt-d | Ocultar el menú de la cabecera de la VHV. | |
E |
alt-shift-E | Ocultar tanto el menú como las áreas de la barra de herramientas. | |
e |
alt-e | “Borrar”: Suprimir la música de bienvenida al abrir VHV (o cualquier contenido anterior de la última visita). | |
w |
alt-w | Amplía el espaciado de la notación. Se pueden utilizar varios caracteres w para aumentar más el espaciado. |
|
W |
alt-shift-W | Disminuye el espaciado de la notación. Se pueden utilizar varios caracteres W para disminuir más el espaciado. |
|
y |
alt-y | Ocultar el editor de texto. |
Parámetros de datos
Los parámetros t y f pueden utilizarse para precargar una partitura digital desde la URL.
t/text
El parámetro t (o la forma larga text) se utiliza para cargar el texto del valor del parámetro en el editor de texto mientras se carga VHV. Se pueden cargar dos formas de datos utilizando este parámetro: texto sin procesar o texto codificado MIME. Este método es muy útil para cargar partituras cortas de ejemplo en VHV. La longitud total de la URL, incluyendo los datos del parámetro t, no debe exceder de unos 2000 caracteres, aunque algunos navegadores web permiten URLs más largas, con el máximo real dependiendo del navegador web específico.
Datos de texto sin procesar para el parámetro t
En el caso del texto en bruto, los caracteres especiales de la URL deben escaparse utilizando codificación por defecto. Además, las nuevas líneas deben codificarse como %0A, los tabuladores como %09 y los espacios como %20. Escriba un texto en el siguiente cuadro, y debajo aparecerá una URL con el texto en bruto codificado en el parámetro t.
Aquí hay una URL que contiene el contenido anterior en el parámetro t (haz clic para ver en VHV):
Datos codificados MIME para el parámetro t
Este es un ejemplo de texto codificado en MIME:
https://verovio.humdrum.org/?t=KiprZXJuCjFjCj0KKi0
La cadena KiprZXJuCjFjCj0KKi0 es el siguiente texto codificado MIME:
**kern
1c
=
*-
Esto será decodificado e insertado en el editor de texto VHV cuando se haga clic en el enlace anterior.
Puedes añadir algún texto en el cuadro de abajo y se mostrará una URL a VHV con el parámetro t rellenado con el texto codificado MIME:
f/file
El parámetro f (o la forma larga file) se utiliza para cargar una partitura digital en el editor. El valor puede ser una partitura del repertorio incorporado, o una URL arbitraria a una partitura disponible en la web. Si carga una partitura utilizando http:// (HTTP no seguro), entonces debes utilizar la dirección no segura de VHV (http://verovio.humdrum.org); de lo contrario, las partituras cargadas con https:// pueden cargarse desde http://verovio.humdrum.org o https://verovio.humdrum.org.
Repertorios
Se puede cargar un archivo repertorio en el editor si no hay un prefijo https:// en el valor del parámetro archivo. Esto también colocará los botones de navegación del repertorio en la parte superior izquierda de la barra de navegación en VHV. A continuación se muestran ejemplos de carga de archivos de repertorio. Puede hacer clic en la flecha hacia arriba del repertorio para ver un índice de otras partituras en el mismo repertorio.
- Beethoven, Sonata para piano nº 1 en Fa mayor, mvmt. 1:
- https://verovio.humdrum.org/?k=ey&file=beethoven/sonatas/sonata01-1.krn
- Mozart, Sonata para piano nº 1 en Do mayor, K 279/189d, mvmt. 1:
- https://verovio.humdrum.org/?k=ey&file=mozart/sonatas/sonata01-1.krn
- Scarlatti, Sonata para teclado en Do mayor, L.1/K.514:
- https://verovio.humdrum.org/?k=ey&file=scarlatti/sonatas/L001K514.krn
- Chopin, Estudio en Do sostenido menor, op. 10, no. 3 del Instituto Fryderyk Chopin:
- https://verovio.humdrum.org/?k=ey&file=chopin-first-editions/010_1-6-1b-KI-004.krn
- J.S. Bach, Coral Aus meines Herzens Grunde, BWV 269:
- https://verovio.humdrum.org/?k=ey&file=chorales/chor001.krn
- Givaonnelli, Non è questa la mano, (1588) madrigal del proyecto Tasso in Music.
- https://verovio.humdrum.org/?k=ey&file=tasso/Trm/Trm0047m-Non_e_questa_la_mano--Giovannelli_1588.krn
Observa que cuando carga una partitura del repertorio, hay botones de navegación del repertorio en la esquina superior izquierda de VHV que le permiten navegar por otros archivos del repertorio o ver un índice de todas las partituras del repertorio.
Índices de repertorio
Puedes abrir VHV con la lista de todas las obras del repertorio enumerando la ruta del repertorio sin un nombre de archivo:
A continuación, puedes elegir un archivo específico del repertorio para verlo en VHV. También puede pulsar la tecla esc para cerrar el índice del repertorio sin elegir una partitura para cargar.
URLs de archivos
VHV sabe dónde se encuentran los archivos de repertorio incorporados en la web, pero si necesitas cargar un archivo que desconoce, puedes dar la dirección URL completa del archivo digital.
Por ejemplo, la ubicación del repertorio del ejemplo del movimiento de la sonata de Beethoven dado anteriormente es:
Esto puede ampliarse hasta convertirse en una URL completa que indique la ubicación real del archivo en la web:
que carga la partitura desde este enlace:
Atajos
Varios repertorios y sitios web tienen métodos de acceso directo para evitar especificar un nombre de archivo o una URL completos.
Atajos de Github
Github URLs can be long:
Estas URLs de Github se pueden condensar en esta forma para el parámetro file:
github:username/repository/path-to-file/filename
Observa que el nombre del directorio master se omite ya que es el directorio raíz real de los archivos del repositorio y no un nombre de directorio dentro del repositorio. La URL completa de la partitura digital de Beethoven en Github se puede condensar en:
github:craigsapp/beethoven-piano-sonatas/kern/sonata01-1.krn
El resultado es que el enlace directo de la VHV a esa partitura se acorta a:
Accesos directos al repertorio
Varios repertorios tienen nombres largos para los archivos que consisten en un número de catálogo para el procesamiento computacional, seguido del título de la obra para la legibilidad humana. VHV tiene un acceso directo que permite cargar la partitura del repertorio basándose en un número de catálogo en lugar de en el nombre completo del archivo y la ruta de acceso al mismo en el repositorio.
Por ejemplo, el enlace del repertorio para el ejemplo Tasso en el proyecto musical funciona:
Puede tener la ruta completa del repertorio y el nombre reducido de:
tasso/Trm/Trm0047m-Non_e_questa_la_mano--Giovannelli_1588.krn
to:
tasso:Trm0047m
en el enlace VHV a la partitura:
Las partituras del Josquin Research Project también pueden cargarse desde un acceso directo al repertorio. Los nombres completos del repertorio para estos archivos pueden ser condensados desde:
jrp/Ock/Ock2002-Ave_Maria.krn
to:
jrp:Ock2002
lo que resulta en una URL VHV más corta:
Parámetros de búsqueda
Los tres parámetros p, r e i pueden utilizarse para buscar tonos, ritmos y/o intervalos. Estos parámetros se cargarán en la barra de herramientas de búsqueda cuando se cargue VHV, y la herramienta de búsqueda se activará y se realizará una búsqueda tan pronto como se haya cargado la partitura.
p/pitch (altura, tono)
Este es un ejemplo de búsqueda del tema inicial de la sonata para piano nº 1 de Beethoven. 1, mvmt. 1:
Esto busca la secuencia de clase de nota diatónica C F A C F A G F E F.
r/ritmo
Busca el patrón rítmico 16 8 16 8 16 en The Entertainer de Joplin:
i/intervalo
Buscar la secuencia de intervalos diatónicos 8 -2 2 -8 (subir una octava, bajar un tono, subir un tono, bajar una octava) en la sonata para piano nº 1 de Mozart. 1, mvmt. 1:
F/filtro
El parámetro filter puede utilizarse para procesar una partitura de entrada con uno o más filtros después de que la partitura se haya cargado en VHV. Ten en cuenta que, al igual que con todos los valores de los parámetros, algunos caracteres deben estar codificados.
Filtro único
He aquí un ejemplo de transposición del movimiento de la sonata para piano de Beethoven de Fa menor a La menor:
El filtro es transpose -ka, que significa transponer la partitura a la tonalidad de La (menor en este caso, ya que se conserva la modalidad). Los caracteres %20 es la codificación porcentual de un carácter de espacio.
Varios filtros
Se pueden serializar filtros separados en el parámetro de filtro separándolos con un carácter de tubería (|). Los filtros se aplicarán en el orden en que estén colocados en la cadena de filtros. He aquí un ejemplo de visualización de un coral de Bach en formato de gran pentagrama y luego colorear las sonoridades triádicas:
satb2gs|colortriads
El carácter de tubería es %7C en codificación porcentual.
Filtrado y búsqueda
El parámetro filter puede mezclarse con las búsquedas musicales. Este es un ejemplo de extracción de las notas superiores de los acordes antes de buscar el ritmo 16 8 16 8 16 en The Entertainer de Jopin.
Compara con la misma búsqueda sin el filtro:
tb/Toolbar (Barra de herramientas)
Establecer la barra de herramientas visible.