midge - Online na nuvem

PROGRAMA:

NOME

midge - gera arquivo midi a partir da descrição de texto da música

SINOPSE

midge [opções] [nome do arquivo]

DESCRIÇÃO

midge gera um arquivo midi tipo 1 a partir de uma descrição de texto da música. midge pega é
entrada de stdin a menos nome do arquivo é especificado.

OPÇÕES

-h or --Socorro

Mostra o texto de ajuda.

--versão or --garantia ou --sobre

Mostra a versão e as informações da licença.

-v or --verbose

Imprime saída detalhada para stdout.

-d or --depurar

Imprime a saída de depuração em stdout (define o modo detalhado automaticamente).

-q or --quieto

Tranquilo. sem stdout.

-o lima or --arquivo de saída lima

Saída Midi para lima. Caso contrário, para a.out.mid

-c or --Verifica

Verifique apenas a entrada; Sem saída midi.

-u or --unroll-loops

Desenrole todos os blocos de repetição antes de analisar e salve o código-fonte desenrolado em um
novo arquivo (* .long.mg). Deve ser definido automaticamente, se necessário.

-U or --no-unroll-save

Não salve a fonte desenrolada em um arquivo.

-R or --sem reset

Não insira o evento `reinicializar todos os controladores 'no início das trilhas.

-t bpm or --tempo bpm

Defina o tempo para bpm batidas por minuto, substituindo o valor definido no arquivo de entrada.

-b passos or --dobra-passos passos

Defina o número de etapas por semínima para a sintaxe de dobra simples.

--inseguro

Não use Safe.pm para executar o código Perl de % eval blocos.

-s número or --semente número

Use número como a semente para o gerador de números aleatórios.

-S [régua [raiz]] or --escala de exibição [régua [raiz]]

Listar notas em escada partindo raiz. Se raiz é omitido c4 é usado. Se escada is
omitido, uma lista de escalas suportadas é mostrada.

-I caminho or --incluir caminho

Adicionar caminho para incluir caminhos. Pode ser especificado várias vezes ou caminho pode ser uma lista
separados por dois pontos ou vírgulas.

INPUT IDIOMA

Exemplo de arquivo de origem para reproduzir uma escala de E.

================ arquivo inicial ======================

# esta linha é um comentário

@cabeça {# deve haver exatamente 1 seção @head

# definir fórmula de compasso

$ time_sig 4/4

# definir o tempo em BPM

$ tempo 120

} # fim da seção @head

@corpo {# deve haver exatamente 1 seção @body

# iniciar uma faixa de música no canal 1

# faixas múltiplas podem usar o mesmo canal

@canal 1 {

# definir patch para baixo elétrico

$ patch 34

# notas. veja abaixo a explicação.

/ l4 / e3 # semínima e na terceira oitava

f+ # f sustenido mesma oitava mesmo comprimento

# usa `-'para apartamento

g + ab # resto das notas

c+4 d + e # mudanças de oitava em c

} # fim da faixa

} # fim da seção @body

============================ arquivo final ====================

Mais exemplos estão incluídos no diretório de exemplos / do arquivo.

Na sequência, é um parâmetro obrigatório e [nome] é um parâmetro opcional.

Notas.

O formato de uma nota é: [/ options /]<nome>[+|-][oitava]

A / options / seção pode conter o seguinte:

l[numerador:]

Define a duração da nota para (numerador ou um) dividido por denominador. ou seja, l4 = quarto
nota, l1 = nota inteira, 3: 4 = nota 3/4 (3 semínimas amarradas). Um maiúsculo `L' pode ser
usado em vez disso para distingui-lo de um `1 '.

r

Define o número de vezes para repetir a nota. Por exemplo

/l8r16 /

torna a duração da nota 1/8 e repete a nota 16 vezes.

a

Define a nota da nota na velocidade (ataque)

d

Define a velocidade da nota da nota (decaimento)

z[+ | -] [%]

Compensa a nota em número cliques midi. Os valores positivos tocam a nota tarde e negativos
valores jogam cedo. Se número é seguido por um `%´ caractere é tomado como uma porcentagem
do comprimento da nota atual. Os valores de deslocamento são não herdado por notas subsequentes.

Z[+ | -] [%]

Como acima `z´ opção, mas um valor aleatório é usado. Se número é negativo ou positivo
(sinal de mais requeridos), um valor entre zero e número é usado. Se não houver sinal, um
valor entre mais e menos número é usado.

A opção de deslocamento não funcionará com o ropção de epeat note, mas o mesmo efeito pode ser
conseguido usando um %repita bloquear.

As notas não podem ser compensadas para trás (ou seja, tocadas mais cedo), a menos que sejam precedidas por uma pausa. Para
contornar isso eu adicionei o $ encurtar palavra-chave, descrita abaixo. Veja também $ unquantise.

nome é o nome da nota, ou seja. [ag] requeridos.

+ afiado.

- plano.

oitava é a oitava midi, ou seja. [1-11]. Embora a maioria dos softwares midi use 0 para o mais baixo
oitava, usei 1 para consistência com os canais midi e nomes de instrumentos que
ambos contam a partir de 1.

Se não for especificado, o comprimento, oitava, ataque e decadência são herdados do anterior
nota.

Em uma trilha de bateria, em vez dos nomes das notas, podem ser usados ​​apelidos. Por exemplo, para obter um
aberto oi chapéu, em vez de `f + 3'você pode usar `hh_o'. Veja README.drums para uma lista completa de
apelido.

Descansa.

Os descansos são escritos como nota `r', com / options / o mesmo que para notas, mas com apenas o
opções de comprimento e repetição usadas. O valor do comprimento é herdado da nota para a pausa e vice
vice-versa.

Bares.

O símbolo de barra vertical (`| ') pode ser usado para denotar barras. Os comprimentos das barras não são verificados -
isso é apenas para permitir arquivos de origem mais legíveis. As barras podem ser numeradas anexando um
número ao símbolo do tubo. Eles podem ser separados por um sublinhado, mas não por espaços.

Exemplo de barra simples: | cdef | gabc

Exemplos de barras numeradas: | 1 cdef | 2 gabc

| _1 cdef | _2 gabc

A consistência das barras pode ser verificada usando o $ bar_strict palavra-chave no @cabeça
seção. Isso dá um erro ou aviso, a menos que todas as faixas tenham o mesmo número de compassos e
barras numeradas aparecem ao mesmo tempo em cada faixa:

$ bar_strict avisar # Imprime uma mensagem de aviso para barras inconsistentes.

$ bar_strict erro # Sai com uma mensagem de erro para barras inconsistentes.

Palavras-chave de nível superior.

@cabeça { contente }

Deve haver exatamente um @cabeça seção. Veja abaixo a descrição de conteúdo.

@corpo { contente }

Deve haver exatamente um @corpo seção. Veja abaixo a descrição de conteúdo.

Palavras-chave no @cabeça seção.

$ time_sig

A b o valor deve ser 4, 8, 16, 32, 64.

$ tempo

t é o tempo em BPM.

Ambos $ time_sig e $ tempo também são permitidos em um bloco @channel (descrito abaixo).

$ title

Define o título da música para título. Se título contém espaços, deve estar dentro do dobro
citações.

$ resolução

Define o número de cliques midi por semínima para n. O padrão é 96.

Palavras-chave no @corpo seção.

%definir { notas }

Defina uma sequência de notas, atribuindo-o a nome para ser lembrado em uma faixa de música. Definiram
sequências são usadas incluindo:

~[/transpor/]

dentro de uma faixa para incluir a sequência nome, transposto por transpor semitons. Anteriormente
sequências definidas podem ser usadas em %definir blocos. por exemplo:

%definir a_riff {a3 a c4 d}

%definir d_riff {d4 dfg}

%definir main_riff { ~um_riff ~d_riff}

Embora pudéssemos alcançar o mesmo resultado transpondo o primeiro riff para fazer o
segunda:

%definir a_riff {a3 a c4 d}

%definir main_riff { ~um_riff ~um_riff/ 5 / }

definir os blocos também podem conter blocos de repetição, blocos de bend e $ volume / patch / reverb etc.

@canal [nome] {conteúdo}

Comece uma faixa midi no canal número, opcionalmente, definindo o nome do instrumento para nome. Se
nome contém espaços, deve estar entre aspas duplas.

conteúdo pode incluir notas, pausas, sequências previamente definidas e as seguintes
Palavras-chave:

$ time_sig

Altera a fórmula de compasso da música (afeta todas as faixas). O b o valor deve ser um de
4, 8, 16, 32, 64.

$ tempo

Altera o andamento da música (afeta todas as faixas). t está em BPM.

$ patch [[bank_LSB,] bank_MSB,]

Defina o número do patch para este canal para número or nome. Onde número é de 1 a 128 e
nome é um alias conforme definido em README.patches. Opcionalmente, selecione o número do banco banco_MSB.
Opcionalmente, selecione o número LSB do banco banco_LSB (usado para teclados midi externos). Cada valor
deve estar no intervalo 1-128.

$ banco [LSB,]

Selecione o número do banco MSB. Opcionalmente, configurando o valor LSB (usado para midi externo
teclados) para LSB. Ambos os valores devem estar no intervalo 1-128.

$ comprimento [n:]

Defina o comprimento padrão da nota. O valor é especificado no mesmo formato das opções de nota.

$ encurtar

Encurte cada nota em número cliques midi, para permitir espaço para as notas serem deslocadas para trás.

$ unquantise [+ | -] [%]

Aplique um deslocamento aleatório a cada nota. número tem o mesmo significado que para o Z opção de nota
acima.

$ oitava

Definir oitava padrão para número

$ volume

Defina o volume da faixa para número

$ ataque

Defina o ataque da nota para número

$ decay

Defina o decaimento da nota para número

$ reverb

Defina a profundidade de reverberação para número no canal atual.

$ chorus

Defina a profundidade do refrão para número no canal atual.

$ pan

Defina o valor panorâmico para número. 0 é a esquerda, 127 é a direita.

Os valores de volume, ataque, decadência, reverberação, coro e panorâmica devem ser números inteiros de 0 a 127.
Eles também podem ser especificados como um intervalo (por exemplo, `8-64'), caso em que um valor aleatório dentro do
intervalo é usado.

% pan_all {valor da nota ...}

Define o valor panorâmico para cada instância subsequente de nota na faixa atual. Isto é
destina-se principalmente a panoramizar um kit de bateria, mas pode ser usado em outra faixa. valor pode ser
um número inteiro ou um intervalo (por exemplo, `8-64'). Múltiplo nota valor pares são permitidos. Se duas notas
com diferentes valores de pan_all são reproduzidos ao mesmo tempo que qualquer coisa pode acontecer.

Para afetar cada nota no canal com um intervalo, use `*'ou `qualquer' para nota. O
/ r4 /método de repetir notas não funcionará com esta opção, mas o mesmo efeito
pode ser alcançado usando um bloco de repetição.

$ marcador

Adiciona um evento de marcador com texto como é o conteúdo. Se texto contém espaços deve estar entre aspas
usando aspas duplas.

%repita { notas }

repetição notas número vezes. notas pode incluir notas, pausas, sequências predefinidas e outros
%repita blocos.

%dobrar {evento ...}

Jogar nota e mover a roda de passo da maneira descrita por múltiplos eventos, que tem
o seguinte formato:

[n:] <+ | ->

onde n e d especifique o tempo desde o início da nota ou do evento anterior, em
o mesmo formato que as durações das notas, e valor é a quantidade pela qual dobrar a nota (o sinal de mais
ou o sinal de menos é necessário). Com o intervalo padrão da roda de afinação de +/- 2 semitons, um valor
de 32 é igual a um semitom. Observe que o valor da dobra é relativo. O máximo
acumulativo a quantidade de dobra é mais ou menos 64.

Por exemplo, o seguinte:

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

Toca a nota a3 para 1/4 de nota, dobra um tom inteiro para 1/4, em seguida, retorna para a3 e
detém para 1/2 nota.

$ bend_range

Altera o intervalo da roda de afinação para +/- número. Isso define a dobra máxima para cima e para baixo, portanto, se
é definido como 4, um valor de curvatura de 64 irá dobrar para cima 4 semitons e -64 irá dobrar para baixo 4
semitons. O intervalo padrão para a maioria dos dispositivos midi é de 2 semitons.

$ pitch

Defina o valor do pitch wheel para onda. Isso pode ser usado em conjunto com uma nota separada sobre
e anote eventos (veja abaixo em `notas simultâneas ') para criar dobras complexas
efeitos. Ao contrário do %dobrar sintaxe acima, isso faz não redefinir a roda de passo para o neutro
posição (64)

Curvas de pitch mais simples podem ser criadas com esta sintaxe:

/ l8 / e4=>g4=>e4

Isso se curva de e4 até g4 e de volta para e4 em etapas lineares ao longo da duração de um
oitava nota. Por padrão, existem 16 etapas por duração de semínima (8 etapas neste
exemplo), mas um valor diferente pode ser definido usando a opção de linha de comando `-b '. Qualquer número
de notas pode ser usado, mas a primeira deve ter um valor de comprimento e cada uma delas deve
tem um valor de oitava.

%escolher [tempo] {item de ponderação ...}

onde o tempo é um valor de comprimento no formato [n:] o mesmo usado nas opções de comprimento,
com o `l 'omitido.

If tempo não é especificado:

Escolha um item de uma lista, onde cada item pode ser uma nota, pausa ou riff predefinido, e
cada item tem um ponderação que define a probabilidade de ser escolhido. Por exemplo:

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

dá a3 uma chance de 20%, c5 - 40%; e4 - 30% e g3 - 10% Cada item devo tem uma ponderação.
Veja também as escalas abaixo.

if tempo é especificado:

Escolha vários items da lista até um comprimento de tempo. Se todo o items são muito longos
para terminar o riff exatamente em tempo, o restante é preenchido com um descanso. Quando escolher é usado
desta forma, cada nota ou pausa deve ter um valor de comprimento e quaisquer riffs predefinidos usados ​​devem
têm um comprimento fixo (ou seja, a primeira nota deve ter um valor de comprimento), e o comprimento do
o riff inteiro deve ser especificado no bloco de escolha no mesmo formato das notas. por
exemplo:

% define riff_1 {/ l2 / a3 / l4 / b c4} # riff tem 1 barra de comprimento

%escolher 4:1 {# escolha 4 barras

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

}

If tempo is 0 or - então o midge procura um bloco do formulário:

ritmo {n [: d] ...}

que é tomado como uma série de valores de comprimento de nota para os quais os tons são escolhidos a partir do
Lista. Outros tokens são passados, então você pode inserir notas específicas, riffs predefinidos
ou descansos. Qualquer token no bloco que comece com um sublinhado será passado, com
o sublinhado removido. Veja example / tutorial / choose_scale.mg para um exemplo.

Outra forma de especificar a lista de notas / pesos é com o escada palavra-chave:

escada menor / l8 / g4-6 [peso ...]

Isso seleciona uma escala G menor da 4ª à 6ª oitavas (ou seja, g4 a g6). O valor do comprimento
é desnecessário se você estiver usando um bloco de ritmo. Se o -6 é omitido uma única oitava é
usava.

O bloco de peso especifica as ponderações das notas em ordem. Se omitido, todas as ponderações são
igual. Para engolir uma nota, use uma ponderação de 0, mas há devo ser uma ponderação para cada nota
se o bloco estiver presente.

A -S switch pode ser usado para mostrar as notas em uma escala ou uma lista de escalas suportadas.

%cadeia {
começar
nota 1 [nota de peso ...]
...
ritmo [comprimento do peso ...] or ritmo {comprimento ...}}

Defina uma estrutura em 'cadeia' onde para cada nota existe uma lista ponderada de notas que podem
Siga isso. Um ponto de partida é escolhido aleatoriamente de todas as notas usadas, ou especificado com
que o começo palavra-chave e, em seguida, as notas subsequentes são escolhidas na lista apropriada até um
comprimento total de tempo.

A ritmo palavra-chave tem duas formas: Usando colchetes `[] ', uma lista ponderada de notas
comprimentos podem ser definidos, que serão escolhidos aleatoriamente. Usando colchetes `{} ', uma lista de
podem ser definidos valores de comprimento que serão usados ​​em sequência (repetindo conforme necessário). Para
toque o bloco de ritmo apenas uma vez, defina o tempo para 0 or -. Neste caso, o ritmo
bloco é analisado da mesma maneira como descrito acima para %escolher com o tempo definido para zero. O
palavra chave vezes pode ser usado como sinônimo de ritmo.

A começo palavra-chave especifica a nota para começar ao usar a cadeia. Se começo is
omitido, a nota inicial é escolhida aleatoriamente.

Outra forma de definir as notas em um cadeia bloco é usar uma das escalas embutidas. Então
as ponderações são especificadas na forma de uma matriz, com uma linha para cada nota "de" (uma
para cada nota da escala) e uma coluna para cada nota "a". Um exemplo deste formulário pode
ser encontrado no arquivo examples / tutorial / chain_scale.mg

Para usar os blocos de escolha ou cadeia, o arquivo deve ser compilado com a opção unroll-loops
(é definido automaticamente quando um bloco de escolha ou cadeia é encontrado). Esta opção salva o
código-fonte desenrolado em um novo arquivo, então, se ele produz uma saída particularmente boa, você tem um
cópia exata na qual você pode fazer outras alterações sem perder a trilha gerada.

Observe que uma escolha e blocos de cadeia não podem estar dentro de uma% define ou dentro de outra escolha ou
bloqueio da cadeia.

% eval {Código Perl}

Execute um bloco de código Perl e substitua o bloco% eval pelo valor retornado do Perl
código.

% eval - {Código Perl}

Execute um bloco de código Perl sem ler o valor de retorno.

O código Perl é executado usando o módulo Safe se estiver presente, com: base_core,: base_math e
: base_mem permitido. Se Safe.pm não estiver disponível ou mais permissões forem necessárias, o --unsafe
opção faz com que o midge execute os blocos% eval em seu próprio processo perl.

Palavras-chave permitidas em qualquer ponto da fonte.

%incluir

Inclui o conteúdo de lima como se tivessem sido escritos naquele ponto da fonte
arquivo. Obrigação estar em uma linha própria no arquivo de origem.

Notas simultâneas.

A maneira mais flexível de tocar notas simultâneas é usando faixas separadas (você pode usar
no mesmo canal / patch), ou usando eventos separados de note on e note off (veja abaixo).
No entanto, existe uma maneira mais simples com algumas limitações. Por exemplo: ( c e g ) vai jogar
as notas c, eeg simultaneamente, formando um acorde C. O comprimento de todos os simultâneos
notas é o mesmo que o primeiro (determinado pelo seu próprio valor de comprimento ou aquele
herdado da nota anterior, pausa ou declaração $ length.

Uma maneira de usar isso para fazer acordes é a seguinte:

%definir menor { ( c e- g ) } # define menor como dó menor

%definir principal { ( c e g ) } # define maior como dó maior

%definir sec 7 { ( c e g b- ) } # define o 7º como um c-7º

Em seguida, você pode usar o em suas faixas de música:

$ length 4 $ octave 4 # define comprimento e oitava padrão

~ major # tocar um dó maior

~ menor / 9 / # tocar um menor

~ 7/5 / # joga um f-7º

Para fazer acordes soarem dedilhados, o dedilhar palavra-chave pode ser usada:

$ strum 5

Isso define o intervalo entre cada nota nos acordes subsequentes para 5 cliques midi.

Para criar padrões complexos de notas simultâneas em uma faixa, separe as notas e as notas
eventos off podem ser usados. Elas são especificadas da mesma forma que as notas normais, mas com um +
prefixado para nota e um - prefixado para nota desligada. As opções de comprimento e repetição não podem
ser usado. O comprimento das notas inseridas desta forma é controlado colocando pausas ou outros
notas entre os eventos note on e note off. por exemplo:

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

toca e segura c4, depois que uma nota de 1/4 toca e segura e4 e depois que outra nota de 1/4 é tocada
e segura g4, liberando todos os três após mais 1/2 nota.

Tuplos.

Embora seja possível criar tuplets escolhendo um comprimento de nota adequado, eles também podem
ser escrito de uma forma mais convencional usando o % tuplet palavra-chave:

% tuplet n: d {notas ...}

desempenha n notas no espaço de d. notas pode conter qualquer coisa permitida em um bloco @channel.
Os valores das notas são então alterados automaticamente para criar o tuplet. Por exemplo:

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

toca cinco notas colcheias no espaço de três. Os tuplets podem ser aninhados em qualquer profundidade. Ver
example / tutorial / tuplet.mg para um exemplo. Midge faz não verifique se a duração da música
dentro do bloco tuplet está correto.

Chaves.

Se você quiser importar seu arquivo midi para um editor de notação, você vai querer definir a chave.
Isso é feito com:

$ chave [+ | -] [m]

Onde nome é ag, + | - são agudos e planos e m é menor. Se a peça inteira permanecer em
a mesma chave, você pode defini-la na seção @head, caso contrário, ela pode aparecer em qualquer lugar em um
seção @canal, e afetará todas as faixas.

Se você está acostumado com a notação musical regular e deseja que as notas sejam nítidas ou planas automaticamente
dependendo da chave, use o $ key_strict palavra-chave em vez disso. Para obter uma nota natural, use o =
sinal, por exemplo, em G, f= joga um f natural. O $ key_strict palavra-chave só pode ser usada no
seção @head. A chave ainda pode ser alterada usando o padrão $ chave palavra chave.

$ ctrl

Definir o número do controlador Números para onda.

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

Defina o controlador rpn Números para onda

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

Defina o controlador nrpn Números para onda

% textualmente {byteval ...}

Insira uma string de bytes no arquivo midi. Cada Byteval pode ser em decimal (0-255)
ou hex (0x00-0xFF). A palavra-chave bytes pode ser usado em vez de textualmente.

$ print

Impressão texto para stdout. Se texto contém espaços, deve ser colocado entre aspas duplas (").

Use midge online usando serviços onworks.net