midge - Online nel cloud

PROGRAMMA:

NOME

midge - genera file midi dalla descrizione testuale della musica

SINOSSI

moscerino [opzioni] [nome file]

DESCRIZIONE

moscerino genera un file midi di tipo 1 da una descrizione testuale della musica. moscerino ci vuole
input da stdin a meno che Nome del file è specificato.

VERSIONI

-h or --Aiuto

Mostra il testo della guida.

--versione or --garanzia o --circa

Mostra le informazioni sulla versione e sulla licenza.

-v or --verboso

Stampa l'output dettagliato su stdout.

-d or - debug

Stampa l'output di debug su stdout (imposta automaticamente la modalità dettagliata).

-q or --silenzioso

Tranquillo. nessuno stdout.

-o filetto or --file di uscita filetto

Uscita midi su filetto. Altrimenti a.out.mid

-c or --dai un'occhiata

Controllare solo l'input; Nessuna uscita midi.

-u or --unroll-loop

Srotola tutti i blocchi di ripetizione prima dell'analisi e salva il codice sorgente srotolato in a
nuovo file (*.long.mg). Dovrebbe essere impostato automaticamente se necessario.

-U or --no-srotola-salva

Non salvare l'origine non srotolata su file.

-R or --nessun ripristino

Non inserire l'evento "reset all controllers" all'inizio delle tracce.

-t bpm or --tempo bpm

Imposta il tempo su bpm battiti al minuto, sovrascrivendo il valore impostato nel file di input.

-b passi or --piega-passi passi

Imposta il numero di passaggi per semiminima per la sintassi di piegatura semplice.

--non sicuro

Non utilizzare Safe.pm per eseguire codice Perl da %valuta blocchi.

-s numero or --seme numero

Usa il numero come seme per il generatore di numeri casuali.

-S [scala [radice]] or --scala dello spettacolo [scala [radice]]

Elenca le note in scala partendo da radice. Se radice viene omesso viene utilizzato c4. Se scala is
omesso, viene mostrato un elenco di scale supportate.

-I sentiero or --includere sentiero

Aggiungi sentiero per includere percorsi. Può essere specificato più volte o sentiero può essere una lista
separati da due punti o virgole.

INGRESSO LINGUA

File sorgente di esempio per riprodurre una scala di E.

================file iniziale======================

# questa riga è un commento

@testa { # ci deve essere esattamente 1 sezione @head

# imposta il tempo in chiave

$tempo_sig 4/4

# imposta il tempo in BPM

$tempo 120

} # fine della sezione @head

@corpo { # ci deve essere esattamente 1 sezione @body

# avvia una traccia musicale sul canale 1

# più tracce possono utilizzare lo stesso canale

@canale 1 {

# imposta la patch sul basso elettrico

$ patch 34

# Appunti. vedi sotto per la spiegazione.

/l4/e3 # semiminima mi in terza ottava

f+ # fa diesis stessa ottava stessa lunghezza

# usa `-'per appartamento

g+ ab # resto delle note

c+4 d+ e # cambia di ottava in do

} # fine della traccia

} # fine della sezione @body

========================fine file====================

Altri esempi sono inclusi nella directory degli esempi/ dell'archivio.

Nel seguente, è un parametro obbligatorio e [nome] è un parametro facoltativo.

Gli appunti.

Il formato di una nota è: [/opzioni/]<Nome>[+|-][ottava]

I /opzioni/ sezione può contenere quanto segue:

l[numeratore:]

Imposta la lunghezza della nota su (numeratore o uno) diviso per denominatore. cioè. l4 = quarto
nota, l1 = nota intera, l3:4 = nota da 3/4 (3 semiminime legate). Un ` . maiuscoloL' può essere
usato invece per distinguerlo da un `1'.

r

Imposta il numero di volte in cui ripetere la nota. Per esempio

/l8r16 /

imposta la durata della nota 1/8 e ripete la nota 16 volte.

a

Imposta la nota della nota sulla velocità (attacco)

d

Imposta la nota off velocity (decay)

z[+|-] [%]

Compensa la nota di numero clic midi. I valori positivi suonano la nota in ritardo e in negativo
i valori giocano presto. Se numero è seguito da un `%´ carattere è preso in percentuale
della lunghezza della nota corrente. I valori di offset sono non ereditato da note successive.

Z[+|-] [%]

Come sopra `z´ ma viene utilizzato un valore casuale. Se numero è negativo o positivo
(segno più necessario), un valore compreso tra zero e numero si usa. Se non c'è nessun segno, a
valore tra più e meno numero viene utilizzato.

L'opzione offset non funzionerà con il rripetizione della nota, ma lo stesso effetto può essere
ottenuto utilizzando a %ripetere blocco.

Le note non possono essere spostate all'indietro (cioè suonate in anticipo) a meno che non siano precedute da una pausa. a
aggirare questo ho aggiunto il $accorcia parola chiave, descritta di seguito. Guarda anche $non quantizzare.

Nome è il nome della nota es. [ag] necessario.

+ acuto.

- piatto.

ottava è l'ottava midi es. [1-11]. Sebbene la maggior parte dei software midi utilizzi 0 per il più basso
ottava, ho usato 1 per coerenza con i canali midi e i nomi degli strumenti che
entrambi contano da 1.

Se non specificato, la lunghezza, l'ottava, l'attacco e il decadimento sono ereditati dal precedente
nota.

In una traccia di batteria, invece dei nomi delle note, possono essere usati degli alias. Ad esempio, per ottenere un
apri ciao cappello, invece di `f+3' puoi usare `hh_o'. Vedere README.drums per un elenco completo di
alias.

riposa.

Le pause sono scritte come nota `r', insieme a /opzioni/ come per le note, ma con il solo
opzioni di lunghezza e ripetizione utilizzate. Il valore della lunghezza viene ereditato dalla nota alla pausa e viceversa
versa.

Barre.

Il simbolo della barra verticale (`|') può essere utilizzato per indicare le barre. Le lunghezze delle barre non sono controllate --
questo è solo per consentire file di origine più leggibili. Le battute possono essere numerate aggiungendo a
numero al simbolo della pipa. Possono essere separati da un carattere di sottolineatura ma non da spazi.

Esempio di barra semplice: | cdef | gabc

Esempi di barre numerate: |1 cdef |2 gabc

|_1 cdef |_2 gabc

La consistenza delle barre può essere verificata utilizzando il $bar_rigor parola chiave nel @testa
sezione. Questo dà un errore o un avviso a meno che tutte le tracce non abbiano lo stesso numero di battute e
le barre numerate appaiono contemporaneamente in ogni traccia:

$bar_rigor avvertire # Stampa un messaggio di avviso per le barre inconsistenti.

$bar_rigor errore # Esci con un messaggio di errore per barre inconsistenti.

Parole chiave di primo livello.

@testa { contenuto }

Ce ne deve essere esattamente uno @testa sezione. Vedi sotto per la descrizione di contenuto.

@corpo { contenuto }

Ce ne deve essere esattamente uno @corpo sezione. Vedi sotto per la descrizione di contenuto.

Parole chiave nel @testa .

$tempo_sig

I b il valore deve essere uno tra 4, 8, 16, 32, 64.

$tempo

t è il tempo in BPM.

Entrambi $tempo_sig ed $tempo sono consentiti anche all'interno di un blocco @channel (descritto di seguito).

$titolo

Imposta il titolo della canzone su titolo. Se titolo contiene spazi deve essere all'interno double
citazioni.

$risoluzione

Imposta il numero di clic midi per nota da un quarto su n. Il valore predefinito è 96.

Parole chiave nel @corpo .

%definire { Appunti }

Definire una sequenza di note, assegnandolo a Nome per essere richiamato in un brano musicale. definito
sequenze vengono utilizzate includendo:

~[/trasporre/]

all'interno di una traccia per includere la sequenza Nome, trasposto da trasporre semitoni. In precedenza
sequenze definite possono essere utilizzate in successivi %definire blocchi. ad esempio:

%definire a_riff { a3 a c4 d }

%definire d_riff { d4 dfg }

%definire riff_principale { ~a_riff ~d_riff }

Anche se potremmo ottenere lo stesso risultato trasponendo il primo riff per fare il
secondo:

%definire a_riff { a3 a c4 d }

%definire riff_principale { ~a_riff ~a_riff/ 5 / }

definire i blocchi possono anche contenere blocchi di ripetizione, blocchi di piega e $volume/patch/riverbero ecc.

@canale [nome] { contenuto }

Inizia una traccia midi sul canale numero, impostando facoltativamente il nome dello strumento su Nome. Se
Nome contiene spazi deve essere racchiuso tra virgolette.

contenuto può includere note, pause, sequenze precedentemente definite e quanto segue
parole chiave:

$tempo_sig

Modifica l'indicazione del tempo per il brano (influisce su tutte le tracce). Il b il valore deve essere uno di
4, 8, 16, 32, 64.

$tempo

Modifica il tempo del brano (influisce su tutte le tracce). t è in BPM.

$ patch [[bank_LSB,]bank_MSB,]

Imposta il numero di patch per questo canale su numero or Nome. Dove numero va da 1 a 128 e
Nome è un alias come definito in README.patches. Seleziona facoltativamente il numero della banca banca_MSB.
Seleziona facoltativamente il numero LSB della banca banca_LSB (usato per tastiere midi esterne). Ogni valore
deve essere compreso tra 1 e 128.

$banca [LSB,]

Seleziona il numero della banca MSB. Impostando opzionalmente il valore LSB (usato per midi . esterno
tastiere) a LSB. Entrambi i valori devono essere compresi nell'intervallo 1-128.

$lunghezza [n:]

Imposta la lunghezza della nota predefinita. Il valore è specificato nello stesso formato delle opzioni della nota.

$accorcia

Abbrevia ogni nota di numero clic midi, per consentire lo spostamento all'indietro dello spazio per le note.

$non quantizzare [+|-] [%]

Applicare un offset casuale a ciascuna nota. numero ha lo stesso significato di Z opzione nota
sopra.

$ottava

Imposta l'ottava predefinita su numero

$ di volume

Imposta il volume della traccia su numero

$attaccare

Imposta l'attacco della nota su numero

$decadimento

Imposta il decadimento della nota su numero

$riverbero

Imposta la profondità di riverbero su numero sul canale corrente.

$coro

Imposta la profondità del chorus su numero sul canale corrente.

$ padella

Imposta il valore del pan su numero. 0 è a sinistra 127 è a destra.

I valori di volume, attacco, decadimento, riverbero, chorus e pan devono essere numeri interi da 0 a 127.
Possono anche essere specificati come un intervallo (ad esempio `8-64'), nel qual caso un valore casuale all'interno di
viene utilizzata la gamma.

%pan_tutto { valore nota ... }

Imposta il valore del pan per ogni successiva istanza di Nota nella traccia corrente. Questo è
principalmente destinato al panning di un drum kit, ma potrebbe essere utilizzato su un'altra traccia. APPREZZIAMO può essere
un numero intero o un intervallo (ad es. `8-64'). multiplo Nota APPREZZIAMO sono ammesse le coppie. Se due note
con diversi valori di pan_all vengono riprodotti nello stesso momento in cui potrebbe accadere qualsiasi cosa.

Per influenzare ogni nota nel canale con un range, usa `*' o `in qualsiasi' per Nota.
/r4/il metodo di ripetizione delle note non funzionerà con questa opzione, ma lo stesso effetto
può essere ottenuto utilizzando un blocco di ripetizione.

$ marker

Aggiunge un evento marcatore con testo come è contenuto. Se testo contiene spazi deve essere quotato
utilizzando caratteri tra virgolette.

%ripetere { Appunti }

Ripetere note numero volte. note può includere note, pause, sequenze predefinite e altro
%ripetere blocchi.

%piegare { evento ... }

Giocare Nota e muovi la rotella del pitch nel modo descritto da multiple eventos, che hanno
il seguente formato:

[n:] <+|->

where n ed d specificare il tempo dall'inizio della nota o dall'evento precedente, in
lo stesso formato delle lunghezze delle note, e APPREZZIAMO è l'importo di cui piegare la nota (il più
o il segno meno è richiesto). Con la gamma di pitch wheel predefinita di +/- 2 semitoni un valore
di 32 equivale a un semitono. Notare che la quantità di piegatura è relativa. Il massimo
cumulativo l'importo della piegatura è più o meno 64.

Ad esempio quanto segue:

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

Suona la nota la3 per 1/4 di nota, aumenta un tono intero per 1/4 e poi ritorna in la3 e
vale per 1/2 nota.

$ intervallo_bend

Modifica l'intervallo della rotella del pitch in +/- numero. Questo imposta la curvatura massima su e giù, quindi se
è impostato su 4, un valore di piegatura di 64 aumenterà di 4 semitoni e -64 si abbasserà di 4
semitoni. L'intervallo predefinito per la maggior parte dei dispositivi midi è di 2 semitoni.

$ passo

Imposta il valore della rotella del pitch su val. Questo può essere usato insieme a una nota separata su
e annota eventi (vedi sotto in `note simultanee') per creare piegature complesse
effetti. non mi piace il %piegare sintassi sopra, questo non non reimpostare la ruota del passo in posizione neutra
posizione (64)

Pitch bend più semplici possono essere creati con questa sintassi:

/l8/e4=>g4=>e4

Questo si piega da e4 fino a g4 e torna indietro fino a e4 in passi lineari per la durata di an
ottava nota. Per impostazione predefinita ci sono 16 step per durata di nota da un quarto (8 step in questo
esempio), ma è possibile impostare un valore diverso utilizzando l'opzione della riga di comando `-b'. Qualsiasi numero
di note possono essere utilizzate, ma la prima deve avere un valore di lunghezza e ciascuna di esse deve
hanno un valore di ottava.

%scegliere [tempo] { elemento di ponderazione ... }

dove tempo è un valore di lunghezza nel formato [n:] lo stesso utilizzato nelle opzioni di lunghezza,
con la `l' omessa.

If tempo non è specificato:

Scegline uno articolo da un elenco, dove ciascuno articolo può essere una nota, una pausa o un riff predefinito e
ogni articolo ha un ponderazione che definisce la probabilità di essere scelto. Per esempio:

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

dà a3 una probabilità del 20%, c5 - 40%; e4 - 30% e g3 - 10% ogni articolo devono obbligatoriamente: avere una ponderazione.
Vedi anche scale sotto.

if tempo è specificato:

Scegli più articolos dall'elenco fino a una lunghezza di tempo. Se tutti i articolosono troppo lunghe
per finire il riff esattamente a tempo, il resto è riempito con una pausa. Quando si usa scegliere
in questo modo ogni nota o pausa deve avere un valore di lunghezza ed eventuali riff predefiniti utilizzati devono
hanno una lunghezza fissa (cioè la prima nota deve avere un valore di lunghezza), e la lunghezza del
l'intero riff deve essere specificato nel blocco di scelta nello stesso formato delle note. per
esempio:

%define riff_1 { /l2/a3 /l4/b c4 } # il riff è lungo 1 misura

%scegliere 4:1 { # scegli 4 battute

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

}

If tempo is 0 or - quindi midge cerca un blocco della forma:

ritmo { n[:d] ... }

che viene preso come una serie di valori di lunghezza delle note per i quali le altezze sono scelte dal
elenco. Altri token vengono passati, quindi puoi inserire note specifiche, riff predefiniti
o riposa. Qualsiasi token nel blocco che inizia con un carattere di sottolineatura verrà passato, con
il trattino basso rimosso. Vedi example/tutorial/choose_scale.mg per un esempio.

Un altro modo per specificare l'elenco di note/ponderazioni è con scala parola chiave:

scala minore /l8/g4-6 [ peso ... ]

Seleziona una scala di sol minore dalla 4a alla 6a ottava (cioè da sol4 a sol6). Il valore della lunghezza
non è necessario se si utilizza un blocco ritmico. Se la -6 viene omessa una singola ottava è
Usato.

Il blocco peso specifica le ponderazioni delle note in ordine. Se omesso, tutte le ponderazioni sono
pari. Per inserire una nota usa una ponderazione di 0, ma c'è devono obbligatoriamente: essere una ponderazione per ogni nota
se il blocco è presente.

I -S l'interruttore può essere utilizzato per mostrare le note in una scala o in un elenco di scale supportate.

%catena {
inizio
nota1 [nota peso...]
...
ritmo [ lunghezza del peso ... ] or ritmo { lunghezza ... } }

Definire una struttura "a catena" dove per ogni nota c'è un elenco ponderato di note che possono
seguilo. Un punto di partenza viene scelto casualmente da tutte le note utilizzate o specificato con
, il inizia a parola chiave, quindi le note successive vengono scelte dall'elenco appropriato fino a a
lunghezza totale di tempo.

I ritmo la parola chiave ha due forme: usando le parentesi quadre `[]', un elenco ponderato di note
le lunghezze possono essere definite, che saranno scelte a caso. Usando le parentesi graffe `{}', un elenco di
si possono definire valori di lunghezza che verranno utilizzati in sequenza (ripetendo se necessario). a
riprodurre il blocco ritmico solo una volta, impostare il tempo a 0 or -. In questo caso il ritmo
blocco viene analizzato nello stesso modo descritto sopra per %scegliere con tempo azzerato. Il
parola chiave volte può essere usato come sinonimo di ritmo.

I inizia a parola chiave specifica la nota da cui iniziare quando si utilizza la catena. Se inizia a is
omesso, la nota di inizio viene scelta casualmente.

Un altro modo per definire le note in a catena blocco è quello di utilizzare una delle scale integrate. Poi
i pesi sono specificati sotto forma di matrice, con una riga per ogni nota "da" (uno
per ogni nota della scala) e una colonna per ogni nota "a". Un esempio di questo modulo può
si trova nel file example/tutorial/chain_scale.mg

Per utilizzare i blocchi select o chain, il file deve essere compilato con l'opzione unroll-loops
(viene impostato automaticamente quando viene trovato un blocco di scelta o catena). Questa opzione salva il
codice sorgente srotolato in un nuovo file, quindi se produce un output particolarmente buono hai un
copia esatta a cui puoi apportare altre modifiche senza perdere la traccia generata.

Nota che i blocchi select e chain non possono essere all'interno di %define o all'interno di un altro scegli o
blocco a catena.

%valuta { codice Perl }

Esegui un blocco di codice Perl e sostituisci il blocco %eval con il valore restituito dal Perl
codice.

%valuta - {Codice Perl}

Esegui un blocco di codice Perl senza leggere il valore restituito.

Il codice Perl viene eseguito utilizzando il modulo Safe se presente, con :base_core, :base_math e
:base_mem consentito. Se Safe.pm non è disponibile o sono necessarie più autorizzazioni il --unsafe
opzione fa in modo che midge esegua i blocchi %eval nel proprio processo perl.

Parole chiave consentite in qualsiasi punto della fonte.

%includere

Include il contenuto di filetto come se fossero stati scritti in quel punto della fonte
file. Mosto essere su una riga a parte nel file sorgente.

Note simultanee.

Il modo più flessibile per suonare note simultanee consiste nell'usare tracce separate (puoi usare
stesso canale/patch), o utilizzando eventi di note on e note off separati (vedi sotto).
Tuttavia, esiste un modo più semplice con alcune limitazioni. Per esempio: ( c e g ) Giocherà
le note do, mi e g contemporaneamente, formando un accordo di do. La lunghezza di tutti i simultanei
note è uguale alla prima (determinata dal proprio valore di lunghezza o da quello
ereditato dalla precedente dichiarazione di nota, pausa o $length.

Un modo per usarlo per creare accordi è il seguente:

%definire minore { ( c e- g ) } # definisci minore come un do minore

%definire maggiore { ( c e g ) } # definisci maggiore come do maggiore

%definire 7° { ( c e g b- ) } # definisci il settimo come un c-7th

Quindi puoi utilizzare nelle tue tracce musicali:

$lunghezza 4 $ottava 4 # imposta la lunghezza e l'ottava di default

~maggiore # suona un do maggiore

~minore/9/ # suona un la minore

~7/5/ # suona un f-7th

Per far suonare gli accordi strimpellati, il strimpellare si può usare la parola chiave:

$strumento 5

Questo imposta l'intervallo tra ogni nota negli accordi successivi a 5 clic midi.

Per creare pattern complessi di note simultanee su una traccia, separare note on e note
off eventi possono essere utilizzati. Queste sono specificate allo stesso modo delle note normali, ma con a +
anteposto per nota su e a - anteposto alla nota off. Le opzioni di lunghezza e ripetizione non possono
essere utilizzato. La lunghezza delle note immesse in questo modo è controllata inserendo pause o altro
note tra gli eventi note on e note off. per esempio:

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

suona e tiene do4, dopo una nota da 1/4 suona e tiene mi4 e dopo un'altra nota da 1/4
e tiene premuto G4, rilasciando tutti e tre dopo un'ulteriore nota da 1/2.

Gruppi irregolari.

Sebbene sia possibile creare gruppi irregolari scegliendo una lunghezza di nota adeguata, possono anche
essere scritto in modo più convenzionale usando il % gruppo irregolare parola chiave:

% gruppo irregolare n:d { note... }

gioca n note nello spazio di d. note può contenere tutto ciò che è consentito in un blocco @channel.
I valori delle note vengono quindi modificati automaticamente per creare il gruppo irregolare. Per esempio:

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

suona cinque crome nello spazio di tre. I gruppi irregolari possono essere nidificati a qualsiasi profondità. Vedere
esempi/tutorial/tuplet.mg per un esempio. il moscerino lo fa non controlla che la lunghezza della musica
all'interno del blocco irregolare è corretto.

Chiavi.

Se vuoi importare il tuo file midi in un editor di notazioni, dovrai impostare la chiave.
Questo è fatto con:

$chiave [+|-][m]

Dove Nome è ag, +|- sono diesis e bemolle e m è minore. Se l'intero pezzo rimane dentro
la stessa chiave puoi impostarla nella sezione @head, altrimenti può apparire ovunque in a
@channel e influenzerà tutte le tracce.

Se sei abituato alla normale notazione musicale e desideri che le note siano automaticamente acute o piatte
a seconda della chiave, utilizzare il $chiave_rigorosa parola chiave invece. Per ottenere una nota naturale usa il =
segno, ad es. in G, f= suona un fa naturale. Il $chiave_rigorosa la parola chiave può essere utilizzata solo nel
@head sezione. La chiave può ancora essere cambiata usando il normale $chiave parola chiave.

$ctrl

Imposta il numero del controller num a val.

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

Imposta il controller rpn num a val

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

Imposta il controller nrpn num a val

%letteralmente { valore byte... }

Inserisci una stringa di byte nel file midi. Ogni byte può essere in entrambi i decimali (0-255)
o esadecimale (0x00-0xFF). La parola chiave bytes può essere utilizzato al posto di Verbatim.

$stampa

Stampa testo a stdout. Se testo contiene spazi deve essere citato tra virgolette (").

Usa midge online utilizzando i servizi onworks.net