midge - Online en la nube

PROGRAMA:

NOMBRE

midge: genera un archivo midi a partir de la descripción de texto de la música

SINOPSIS

mosquito [opciones] [nombre de archivo]

DESCRIPCIÓN

mosquito genera un archivo midi de tipo 1 a partir de una descripción de texto de la música. mosquito toma es
entrada de stdin a menos que nombre de archivo está especificado.

CAMPUS

-h or --ayuda

Mostrar texto de ayuda.

--versión or --garantía o --Sobre Nosotros

Muestra la información de la versión y la licencia.

-v or --verboso

Imprime una salida detallada en stdout.

-d or --depurar

Imprime la salida de depuración en stdout (establece el modo detallado automáticamente).

-q or --tranquilo

Tranquilo. sin stdout.

-o presentar or --archivo de salida presentar

Salida midi a presentar. De lo contrario a a.out.mid

-c or --cheque

Verifique la entrada solamente; Sin salida midi.

-u or --desenrollar bucles

Desenrolle todos los bloques repetidos antes de analizar y guarde el código fuente desenrollado en un
nuevo archivo (* .long.mg). Debe configurarse automáticamente si es necesario.

-U or --no-desenrollar-guardar

No guarde la fuente no enrollada en el archivo.

-R or --no reinicio

No inserte el evento "restablecer todos los controladores" al comienzo de las pistas.

-t bpm or --tempo bpm

Establecer tempo en bpm latidos por minuto, valor primordial establecido en el archivo de entrada.

-b pasos or - pasos de flexión pasos

Establezca el número de pasos por negra para la sintaxis simple bend.

--inseguro

No use Safe.pm para ejecutar código Perl desde % eval Bloques

-s número or --semilla número

Uso número como semilla para el generador de números aleatorios.

-S [escala [raíz]] or --espectáculo a escala [escala [raíz]]

Lista de notas en escala a partir de raíz. Si raíz se omite c4 se utiliza. Si escala is
omitido, se muestra una lista de escalas admitidas.

-I camino or --incluir camino

Añada camino para incluir caminos. Puede especificarse varias veces o camino puede ser una lista
separados por dos puntos o comas.

ENTRADA IDIOMA

Archivo fuente de muestra para reproducir una escala de E.

================ archivo de inicio ======================

# esta línea es un comentario

@cabeza {# debe haber exactamente 1 sección @head

# establecer firma de tiempo

$ time_sig 4/4

# establecer tempo en BPM

$ tempo 120

} # final de la sección @head

@cuerpo {# debe haber exactamente 1 sección @body

# iniciar una pista de música en el canal 1

# varias pistas pueden usar el mismo canal

@canal 1 {

# establecer parche para bajo eléctrico

$ parche 34

# notas. consulte a continuación para obtener una explicación.

/ l4 / e3 # nota negra e en tercera octava

f+ # f sostenido misma octava misma longitud

# usar `-'para piso

g + ab # resto de notas

c+4 d + e # cambios de octava en c

} # final de la pista

} # final de la sección @body

======================== archivo final ====================

Se incluyen más ejemplos en el directorio examples / del archivo.

En el siguiente, es un parámetro obligatorio y [nombre] es un parámetro opcional.

Notas.

El formato de una nota es: [/ opciones /]<nombre >[+|-][octava]

El / opciones / La sección puede contener lo siguiente:

l[numerador:]

Establece la duración de la nota en (numerador o uno) dividido por denominador. es decir. l4 = cuarto
nota, l1 = nota completa, l3: 4 = nota 3/4 (3 notas negras atadas). Una mayúscula 'L' quizás
utilizado en su lugar para distinguirlo de un '1'.

r

Establece el número de veces que se repite la nota. Por ejemplo

/l8r16 /

hace que la duración de la nota sea de 1/8 y repite la nota 16 veces.

a

Establece la nota de la nota en velocidad (ataque)

d

Establece la velocidad de desactivación de la nota (caída)

z[+ | -] [%]

Compensa la nota por número clics midi. Los valores positivos tocan la nota tarde y negativos
los valores juegan temprano. Si número va seguido de un `%´ carácter se toma como porcentaje
de la longitud de la nota actual. Los valores de compensación son no heredado por notas posteriores.

Z[+ | -] [%]

Como el anteriorz´ opción pero se utiliza un valor aleatorio. Si número es negativo o positivo
(Signo de más Requisitos), un valor entre cero y número se utiliza. Si no hay ninguna señal, un
valor entre más y menos número se utiliza.

La opción de compensación no funcionará con el rOpción de repetición de nota, pero el mismo efecto puede ser
logrado usando un %repetir bloquear.

Las notas no se pueden desplazar hacia atrás (es decir, tocar antes) a menos que estén precedidas por un silencio. Para
solucionar esto, he agregado el $ acortar palabra clave, que se describe a continuación. Ver también $ sin cuantificar.

nombre es el nombre de la nota, es decir. [ag] Requisitos.

+ agudo.

- plano.

octava es la octava midi, es decir. [1-11]. Aunque la mayoría del software midi usa 0 para la
octava, he usado 1 para mantener la coherencia con los canales midi y los nombres de los instrumentos que
ambos cuentan desde 1.

Si no se especifica, la longitud, la octava, el ataque y el decaimiento se heredan del anterior.
nota.

En una pista de batería, en lugar de los nombres de las notas, se pueden utilizar alias. Por ejemplo, para obtener un
hi hat abierto, en lugar de 'f + 3'puedes usar'hh_o'. Consulte README.drums para obtener una lista completa de
alias.

Descansos.

Los silencios se escriben como nota 'r', con / opciones / lo mismo que para las notas, pero con solo el
opciones de longitud y repetición utilizadas. El valor de la longitud se hereda de la nota al silencio y viceversa.
versa.

Barras.

El símbolo de barra vertical (`| ') se puede utilizar para indicar barras. No se comprueban las longitudes de las barras -
esto es solo para permitir archivos fuente más legibles. Las barras se pueden numerar agregando un
número al símbolo de la tubería. Pueden estar separados por un guión bajo pero no por espacios.

Ejemplo de barra simple: | cdef | gabc

Ejemplos de barras numeradas: | 1 cdef | 2 gabc

| _1 cdef | _2 gabc

La consistencia de las barras se puede comprobar utilizando el $ bar_strict palabra clave en el @cabeza
sección. Esto da un error o advertencia a menos que todas las pistas tengan el mismo número de barras y
Las barras numeradas aparecen al mismo tiempo en cada pista:

$ bar_strict advertir # Imprima un mensaje de advertencia para barras inconsistentes.

$ bar_strict error # Salir con un mensaje de error para barras inconsistentes.

Palabras clave de nivel superior.

@cabeza { contenido }

Debe haber exactamente uno @cabeza sección. Consulte a continuación para obtener una descripción de contenido.

@cuerpo { contenido }

Debe haber exactamente uno @cuerpo sección. Consulte a continuación para obtener una descripción de contenido.

Palabras clave en el @cabeza .

$ time_sig

El b El valor debe ser uno de 4, 8, 16, 32, 64.

$ tempo

t es el tempo en BPM.

Ambos $ time_sig y $ tempo también se permiten dentro de un bloque @channel (descrito a continuación).

$ título

Establece el título de la canción en título. Si título contiene espacios debe estar dentro del doble
citas.

$ resolución

Establece el número de clics midi por negra en n. El valor predeterminado es 96.

Palabras clave en el @cuerpo .

%definir {notas}

Definir una secuencia de reconoce, asignándolo a nombre para ser recuperado en una pista de música. Definido
Las secuencias se utilizan al incluir:

~[/transponer/]

dentro de una pista para incluir la secuencia nombre , transpuesto por transponer semitonos. Previamente
secuencias definidas se pueden utilizar en posteriores %definir bloques. por ejemplo:

%definir a_riff {a3 a c4 d}

%definir d_riff {d4 dfg}

%definir principal_riff { ~a_riff ~d_riff}

Aunque podríamos lograr el mismo resultado transponiendo el primer riff para hacer el
segundo:

%definir a_riff {a3 a c4 d}

%definir principal_riff { ~a_riff ~a_riff/ 5 / }

definir Los bloques también pueden contener bloques de repetición, bloques de flexión y $ volume / patch / reverb, etc.

@canal [nombre] {contenido}

Comenzar una pista midi en el canal número, configurando opcionalmente el nombre del instrumento en nombre . Si
nombre contiene espacios debe estar entre comillas dobles.

contenido puede incluir notas, silencios, secuencias previamente definidas y lo siguiente
palabras clave:

$ time_sig

Cambia el tipo de compás de la canción (afecta a todas las pistas). los b el valor debe ser uno de
4, 8, 16, 32, 64.

$ tempo

Cambia el tempo de la canción (afecta a todas las pistas). t está en BPM.

$ parche [[bank_LSB,] bank_MSB,]

Configure el número de parche para este canal número or nombre . Donde número es de 1 a 128 y
nombre es un alias como se define en README.patches. Opcionalmente, seleccione el número de banco banco_MSB.
Opcionalmente, seleccione el número LSB del banco banco_LSB (utilizado para teclados midi externos). Cada valor
debe estar en el rango de 1 a 128.

$ banco [LSB,]

Seleccionar número de banco MSB. Configuración opcional del valor LSB (utilizado para midi externo
teclados) a LSB. Ambos valores deben estar en el rango de 1 a 128.

$ longitud [norte:]

Establecer la longitud predeterminada de la nota. El valor se especifica en el mismo formato que en las opciones de nota.

$ acortar

Acorte cada nota en número clics midi, para dejar espacio para que las notas se desplacen hacia atrás.

$ sin cuantificar [+ | -] [%]

Aplica un desplazamiento aleatorio a cada nota. número tiene el mismo significado que para el Z opción de nota
anterior.

$ octava

Establecer octava predeterminada en número

$ volumen

Establezca el volumen de la pista en número

$ ataque

Establezca el ataque de la nota en número

$ decaimiento

Establezca la caída de la nota en número

$ reverberación

Establezca la profundidad de reverberación en número en el canal actual.

$ coro

Establezca la profundidad del coro en número en el canal actual.

$ pan

Establezca el valor de la sartén en número. 0 es la izquierda 127 es la derecha.

Los valores de volumen, ataque, caída, reverberación, coro y panorama deben ser números enteros de 0 a 127.
También se pueden especificar como un rango (por ejemplo, `8 - 64'), en cuyo caso un valor aleatorio dentro del
se utiliza el rango.

% pan_all {valor de nota ...}

Establece el valor de panorámica para cada instancia posterior de nota en la pista actual. Este es
diseñado principalmente para panoramizar un juego de batería, pero podría usarse en otra pista. propuesta de puede ser
un número entero o un rango (por ejemplo, `8 - 64'). Múltiple nota propuesta de se permiten parejas. Si dos notas
con diferentes valores de pan_all se reproducen al mismo tiempo, cualquier cosa podría suceder.

Para afectar a cada nota en el canal con un rango, use `*'o'cualquier' para nota.
/ r4 /El método de repetición de notas no funcionará con esta opción, pero el mismo efecto
se puede lograr usando un bloque de repetición.

$ marcador

Agrega un evento de marcador con texto como es contenido. Si texto contiene espacios debe ser citado
utilizando caracteres de comillas dobles.

%repetir {notas}

Repetición: reconoce número veces. reconoce puede incluir notas, silencios, secuencias predefinidas y otros
%repetir Bloques

%curva {evento ...}

Jugar nota y mueva la rueda de tono de la manera descrita por múltiples eventos, que tienen
el siguiente formato:

[norte:] <+ | ->

donde n y d especificar el tiempo desde el inicio de la nota o desde el evento anterior, en
el mismo formato que las longitudes de las notas, y propuesta de es la cantidad para doblar la nota (el más
o el signo menos). Con el rango predeterminado de la rueda de tono de +/- 2 semitonos un valor
de 32 equivale a un semitono. Tenga en cuenta que la cantidad de curvatura es relativa. El maximo
acumulativo La cantidad de plegado es más o menos 64.

Por ejemplo lo siguiente:

% bend a3 {4 + 32 4-32 2 + 0}

Reproduce la nota a3 para 1/4 de nota, dobla un tono completo para 1/4 y luego regresa a a3 y
se mantiene para 1/2 nota.

$ bend_range

Cambia el rango de la rueda de tono a +/- número. Esto establece la curva máxima hacia arriba y hacia abajo, por lo que si
está configurado en 4, un valor de curvatura de 64 se curvará 4 semitonos hacia arriba y -64 se curvará hacia abajo 4
semitonos. El rango predeterminado para la mayoría de los dispositivos midi es de 2 semitonos.

$ tono

Establezca el valor de la rueda de tono en val. Esto se puede utilizar junto con una nota separada sobre
y anote los eventos (ver más abajo en "notas simultáneas") para crear una flexión compleja
efectos. A diferencia del %curva sintaxis anterior, esto hace no restablecer la rueda de tono a neutral
posición (64)

Se pueden crear curvas de tono más simples con esta sintaxis:

/ l8 / e4=>g4=>e4

Esto se dobla desde e4 hasta g4 y vuelve a bajar a e4 en pasos lineales durante la duración de un
octava nota. Por defecto, hay 16 pasos por duración de negra (8 pasos en este
ejemplo), pero se puede establecer un valor diferente usando el modificador de línea de comando `-b '. Cualquier número
de notas se pueden utilizar, pero la primera debe tener un valor de longitud y cada una de ellas debe
tienen un valor de octava.

%escoger [tiempo] {elemento de ponderación ...}

donde el tiempo es un valor de longitud en el formato [n:] el mismo que se utiliza en las opciones de longitud,
con la 'l' omitida.

If equipo no se especifica:

Elige uno ít de una lista, donde cada ít puede ser una nota, silencio o riff predefinido, y
cada artículo tiene un ponderación que define la probabilidad de que se elija. Por ejemplo:

% elige {2 a3 4 c5 3 e4 1 g3}

le da a a3 un 20% de probabilidad, c5 - 40%; e4 - 30% y g3 - 10% Cada artículo debe tener una ponderación.
Consulte también las escalas a continuación.

if equipo está especificado:

Elija múltiples íts de la lista hasta una longitud de equipo. Si todo el ítson demasiado largas
para terminar el riff exactamente en equipo, el resto se llena con un descanso. Cuando se usa elegir
De esta manera, cada nota o silencio debe tener un valor de longitud y los riffs predefinidos utilizados deben
tener una longitud fija (es decir, la primera nota debe tener un valor de longitud), y la longitud de la
El riff completo debe especificarse en el bloque de elección en el mismo formato que para las notas. por
ejemplo:

% define riff_1 {/ l2 / a3 / l4 / b c4} # riff tiene 1 compás de longitud

%escoger 4:1 {# elige 4 barras

1 / l8 / d4 3 / l8 / e4 2 / l4 / g4 1 / l1 / ~ riff_1

}

If equipo is 0 or - luego midge busca un bloque de la forma:

ritmo {n [: d] ...}

que se toma como una serie de valores de longitud de nota para los cuales los tonos se eligen de la
lista. Se pasan otros tokens, por lo que puede insertar notas específicas, riffs predefinidos
o descansa. Cualquier token en el bloque que comience con un guión bajo se pasará, con
el subrayado eliminado. Consulte examples / tutorial / choose_scale.mg para ver un ejemplo.

Otra forma de especificar la lista de notas / ponderaciones es con el escala palabra clave:

escala minor / l8 / g4-6 [peso ...]

Esto selecciona una escala de sol menor de la cuarta a la sexta octava (es decir, g4 a g6). El valor de la longitud
es innecesario si está utilizando un bloque de ritmo. Si el -6 se omite una sola octava es
usado.

El bloque de peso especifica las ponderaciones de las notas en orden. Si se omite, todas las ponderaciones son
igual. Para ignorar una nota, use una ponderación de 0, pero no debe ser una ponderación para cada nota
si el bloque está presente en absoluto.

El -S El interruptor se puede utilizar para mostrar las notas en una escala o una lista de escalas compatibles.

%cadena {
comienzo
note1 [nota de peso ...]
...
ritmo [peso longitud ...] or ritmo {longitud ...}}

Defina una estructura de "cadena" donde para cada nota hay una lista ponderada de notas que pueden
Siguelo. Un punto de partida se elige al azar de todas las notas utilizadas, o se especifica con
las comienzo palabra clave, y luego las notas subsiguientes se eligen de la lista apropiada hasta un
longitud total de equipo.

El ritmo La palabra clave tiene dos formas: utilizando corchetes `[] ', una lista ponderada de notas
Se pueden definir longitudes, que se elegirán de forma aleatoria. Usando llaves `{} ', una lista de
Se pueden definir valores de longitud que se utilizarán en secuencia (repitiendo según sea necesario). Para
tocar a través del bloque de ritmo solo una vez, ajuste el equipo a 0 or -. En este caso el ritmo
bloque se analiza de la misma manera que se describe anteriormente para %escoger con el tiempo puesto a cero. los
keyword veces se puede utilizar como sinónimo de ritmo.

El comienzo palabra clave especifica la nota desde la que comenzar cuando se usa la cadena. Si comienzo is
omitido, la nota de inicio se elige al azar.

Otra forma de definir las notas en un cadena bloque es utilizar una de las escalas integradas. Luego
las ponderaciones se especifican en forma de matriz, con una fila para cada nota "desde" (una
para cada nota de la escala) y una columna para cada nota "a". Un ejemplo de este formulario puede
se puede encontrar en el archivo examples / tutorial / chain_scale.mg

Para usar los bloques elegir o encadenar, el archivo debe compilarse con la opción unroll-loops
(se establece automáticamente cuando se encuentra un bloque de elección o cadena). Esta opción guarda el
código fuente desenrollado en un nuevo archivo, por lo que si produce un resultado particularmente bueno, tiene una
copia exacta a la que puede realizar otros cambios sin perder la pista generada.

Tenga en cuenta que los bloques de elección y cadena no pueden estar dentro de un% define o dentro de otra elección o
bloque de cadena.

% eval {Código Perl}

Ejecute un bloque de código Perl y reemplace el bloque% eval con el valor devuelto por Perl
código.

% eval - {Código Perl}

Ejecute un bloque de código Perl sin leer el valor de retorno.

El código Perl se ejecuta usando el módulo Safe si está presente, con: base_core,: base_math y
: base_mem permitido. Si Safe.pm no está disponible o se necesitan más permisos, el --unsafe
La opción hace que midge ejecute los bloques% eval en su propio proceso de Perl.

Palabras clave permitidas en cualquier punto de la fuente.

%incluir

Incluye el contenido de presentar como si hubieran sido escritos en ese punto de la fuente
archivo. Debe estar en una línea propia en el archivo fuente.

Notas simultáneas.

La forma más flexible de tocar notas simultáneas es mediante el uso de pistas independientes (puede utilizar
el mismo canal / parche), o usando eventos separados de activación y desactivación de nota (ver más abajo).
Sin embargo, existe una forma más sencilla con algunas limitaciones. Por ejemplo: ( c e g ) jugará
las notas c, e y g simultáneamente, formando un acorde de C. La duración de todos los simultáneos
notas es el mismo que el primero (determinado por su propio valor de longitud o el
heredado de la declaración anterior de nota, silencio o $ length.

Una forma de usar esto para hacer acordes es la siguiente:

%definir menor de edad { ( c e- g ) } # definir menor como do menor

%definir gran { ( c e g ) } # definir mayor como do mayor

%definir 7 { ( c e g b- ) } # definir 7mo como un c-7mo

Entonces puedes usar el en tus pistas de música:

$ longitud 4 $ octava 4 # establecer la longitud y la octava predeterminadas

~ mayor # tocar un do mayor

~ menor / 9 / # jugar un menor

~ 7º / 5 / # jugar un séptimo

Para hacer que los acordes suenen rasgados, rasguear se puede utilizar la palabra clave:

$ rasgueo 5

Esto establece el intervalo entre cada nota en los acordes posteriores en 5 clics midi.

Para crear patrones complejos de notas simultáneas en una pista, separe una nota y una nota
Se pueden utilizar eventos desactivados. Se especifican de la misma forma que las notas normales, pero con un +
antepuesto para una nota y un - antepuesto para nota desactivada. Las opciones de duración y repetición no pueden
ser usado. La longitud de las notas introducidas de esta manera se controla poniendo silencios u otros
notas entre los eventos de nota activada y nota desactivada. p.ej:

+c4 / l4 / r +r +g / l2 / r -c -e -g

toca y mantiene presionado c4, después de que se reproduce una nota de 1/4 y se mantiene presionado e4 y después de que se reproduce otra nota de 1/4
y mantiene g4, soltando los tres después de 1/2 nota adicional.

tullizos.

Si bien es posible crear grupos irregulares eligiendo una longitud de nota adecuada, también pueden
estar escrito de una manera más convencional utilizando el % tuplet palabra clave:

% tuplet n: d {notas ...}

juega n notas en el espacio de d. reconoce puede contener cualquier cosa permitida en un bloque @channel.
Los valores de las notas se modifican automáticamente para crear el grupo irregular. Por ejemplo:

% tuplet 5: 3 {/ l8 / e4 fgfe}

toca cinco octavas notas en el espacio de tres. Los grupos irregulares se pueden anidar a cualquier profundidad. Ver
examples / tutorial / tuplet.mg para ver un ejemplo. Midge hace no comprueba que la duración de la música
dentro del bloque tuplet es correcto.

Llaves.

Si desea importar su archivo midi a un editor de notación, querrá establecer la clave.
Esto se hace con:

$ clave [+ | -] [m]

Dónde nombre es ag, + | - son agudos y planos, y m es menor. Si toda la pieza se queda en
la misma clave que puede configurar en la sección @head, de lo contrario, puede aparecer en cualquier lugar en un
@channel, y afectará a todas las pistas.

Si está acostumbrado a la notación musical normal y desea que las notas sean nítidas o planas automáticamente
dependiendo de la clave, utilice el $ key_strict palabra clave en su lugar. Para obtener una nota natural, utilice el =
firmar, por ejemplo, en G, f= juega un f natural. los $ key_strict La palabra clave solo se puede utilizar en el
@Sección principal. La clave aún se puede cambiar usando el $ clave palabra clave.

$ ctrl

Establecer número de controlador número a val.

$ rpn [num-msb,] [, val-lsb]

Configurar el controlador rpn número a val

$ nrpn [num-msb,] [, val-lsb]

Configurar el controlador nrpn número a val

%literal {byteval ...}

Inserte una cadena de bytes en el archivo midi. Cada byteval puede estar en decimal (0-255)
o hexadecimal (0x00-0xFF). La palabra clave bytes se puede usar en lugar de literal.

$ imprimir

Imprimir texto a stdout. Si texto contiene espacios debe estar entre comillas dobles (").

Use midge en línea usando los servicios de onworks.net