moucheron - En ligne dans le Cloud

PROGRAMME:

Nom

midge - génère un fichier midi à partir de la description textuelle de la musique

SYNOPSIS

moucheron [options] [nom de fichier]

DESCRIPTION

moucheron génère un fichier midi de type 1 à partir d'une description textuelle de la musique. moucheron prend c'est
entrée de stdin à moins que nom de fichier est spécifié.

OPTIONS

-h or --Aidez-moi

Afficher le texte d'aide.

--version or --garantie ou --à propos

Afficher les informations sur la version et la licence.

-v or --verbeux

Imprimer la sortie détaillée sur stdout.

-d or --déboguer

Imprimer la sortie de débogage sur stdout (définit automatiquement le mode détaillé).

-q or --silencieux

Calmer. pas de sortie standard.

-o filet or --fichier de sortie filet

Sortie Midi vers filet. Sinon à a.out.mid

-c or --Chèque

Vérifier l'entrée uniquement ; Pas de sortie midi.

-u or --unroll-boucles

Déroulez tous les blocs de répétition avant d'analyser et enregistrez le code source déroulé dans un
nouveau fichier (*.long.mg). Doit être réglé automatiquement si nécessaire.

-U or --pas de déroulement-sauvegarde

N'enregistrez pas la source déroulée dans un fichier.

-R or --pas de réinitialisation

N'insérez pas l'événement `reset all controllers' au début des pistes.

-t bpm or --tempo bpm

Réglez le tempo sur bpm battements par minute, valeur prioritaire définie dans le fichier d'entrée.

-b mesures or --plier-étapes mesures

Définissez le nombre de pas par noire pour la syntaxe de bend simple.

--peu sûr

N'utilisez pas Safe.pm pour exécuter du code Perl à partir de %évaluation Blocs.

-s nombre or --la graine nombre

Utilisez nombre comme graine pour le générateur de nombres aléatoires.

-S [escalader [racine]] or --show-scale [escalader [racine]]

Liste des notes dans escaliers a partir de racine. Si racine est omis c4 est utilisé. Si escaliers is
omis, une liste d'échelles prises en charge s'affiche.

-I chemin or --comprendre chemin

Ajouter chemin pour inclure des chemins. Peut être spécifié plusieurs fois ou chemin peut être une liste
séparés par des deux points ou des virgules.

CONTRIBUTION LANGUAGE

Exemple de fichier source pour jouer une gamme de E.

================fichier de démarrage======================

# cette ligne est un commentaire

@diriger { # il doit y avoir exactement 1 section @head

# définir la signature rythmique

$time_sig 4/4

# définir le tempo en BPM

$tempo 120

} # fin de la section @head

@corps { # il doit y avoir exactement 1 section @body

# démarrer une piste musicale sur le canal 1

# plusieurs pistes peuvent utiliser le même canal

@canal 1 {

# régler le patch sur la basse électrique

$patch 34

# Remarques. voir ci-dessous pour l'explication.

/l4/e3 # noire mi en troisième octave

f+ # f dièse même octave même longueur

# utiliser `-' pour plat

g+ ab # reste des notes

c+4 d+ e # changements d'octave en c

} # fin de piste

} # fin de la section @body

========================Fichier de fin====================

D'autres exemples sont inclus dans le répertoire examples/ de l'archive.

Dans ce qui suit, est un paramètre obligatoire et [nom] est un paramètre facultatif.

Notes.

Le format d'une note est : [/options/]<prénom>[+|-][octave]

La /options/ La section peut contenir les éléments suivants :

l[numérateur:]

Règle la longueur de la note sur (numérateur ou un) divisé par dénominateur. c'est à dire. l4 = quart
note, l1 = note entière, l3:4 = 3/4 de note (3 noires liées). Une majuscule `L' peut être
utilisé à la place pour le distinguer d'un « 1 ».

r

Définit le nombre de répétitions de la note. Par exemple

/l8r16 /

fait la durée de la note 1/8 et répète la note 16 fois.

a

Définit la note de la note sur la vélocité (attaque)

d

Règle la vélocité (décroissance) de la note de la note

z[+|-] [%]

Décale la note de nombre clics midi. Les valeurs positives jouent la note tardivement et négatives
les valeurs y jouent tôt. Si nombre est suivi d'un `%´ caractère il est pris comme un pourcentage
de la longueur de note actuelle. Les valeurs de décalage sont ne sauraient hérité par les notes ultérieures.

Z[+|-] [%]

Comme ci-dessus `z´ option mais une valeur aléatoire est utilisée. Si nombre est négatif ou positif
(signe plus conditions), une valeur comprise entre zéro et nombre est utilisé. S'il n'y a aucun signe, un
valeur entre plus et moins nombre est utilisé.

L'option de décalage ne fonctionnera pas avec le roption de répétition de note, mais le même effet peut être
obtenu à l'aide d'un %répéter bloque.

Les notes ne peuvent pas être décalées vers l'arrière (c'est-à-dire jouées tôt) à moins qu'elles ne soient précédées d'un silence. À
contourner cela, j'ai ajouté le $raccourcir mot-clé, décrit ci-dessous. Voir également $déquantifier.

prénom est le nom de la note, c'est-à-dire. [ag] conditions.

+ tranchant.

- appartement.

octave est l'octave midi c'est à dire. [1-11]. Bien que la plupart des logiciels midi utilisent 0 pour le plus bas
octave, j'en ai utilisé 1 par souci de cohérence avec les canaux midi et les noms d'instruments qui
les deux comptent à partir de 1.

Si non spécifié, la longueur, l'octave, l'attaque et le déclin sont hérités du précédent
note.

Dans une piste de batterie, au lieu des noms de notes, des alias peuvent être utilisés. Par exemple, pour obtenir un
ouvrir salut chapeau, au lieu de `f+3' vous pouvez utiliser 'hh_o'. Voir README.drums pour une liste complète des
alias.

Reste.

Les silences sont écrits comme note `r', avec /options/ la même chose que pour les notes, mais avec seulement le
options de longueur et de répétition utilisées. La valeur de la longueur est héritée de la note au silence et vice-versa
versa.

Bars.

Le symbole pipe (`|') peut être utilisé pour désigner des barres. Les longueurs des barres ne sont pas vérifiées --
c'est uniquement pour permettre des fichiers source plus lisibles. Les barres peuvent être numérotées en ajoutant un
numéro au symbole du tuyau. Ils peuvent être séparés par un trait de soulignement mais pas par des espaces.

Exemple de barre simple : | cdef | gabc

Exemples de barres numérotées : |1 cdef |2 gabc

|_1 cdef |_2 gabc

La cohérence des barres peut être vérifiée en utilisant le $bar_strict mot-clé dans le @diriger
section. Cela donne une erreur ou un avertissement à moins que toutes les pistes aient le même nombre de mesures et
des barres numérotées apparaissent en même temps dans chaque piste :

$bar_strict prévenir # Imprime un message d'avertissement pour les barres incohérentes.

$bar_strict erreur # Sortie avec un message d'erreur pour les barres incohérentes.

Mots-clés de haut niveau.

@diriger { teneur }

Il doit y en avoir exactement un @diriger section. Voir ci-dessous pour la description de contenu.

@corps { teneur }

Il doit y en avoir exactement un @corps section. Voir ci-dessous pour la description de contenu.

Mots-clés dans le @diriger .

$time_sig

La b la valeur doit être l'une des 4, 8, 16, 32, 64.

$tempo

t est le tempo en BPM.

Les deux $time_sig ainsi que $tempo sont également autorisés dans un bloc @channel (décrit ci-dessous).

$titre

Définit le titre de la chanson sur titre. Si titre contient des espaces, il doit être à l'intérieur double
citations.

$résolution

Définit le nombre de clics midi par noire à n. La valeur par défaut est 96.

Mots-clés dans le @corps .

%définir { Remarques }

Définir une séquence de note, l'attribuant à prénom à rappeler dans une piste musicale. Défini
les séquences sont utilisées en incluant :

~[/transposer/]

dans une piste pour inclure la séquence prénom, transposé par transposer demi-tons. Précédemment
les séquences définies peuvent être utilisées dans les %définir blocs. par exemple:

%définir a_riff { a3 une c4 d }

%définir d_riff { d4 dfg }

%définir riff_principal { ~un_riff ~d_riff }

Bien qu'on puisse arriver au même résultat en transposant le premier riff pour faire le
seconde:

%définir a_riff { a3 une c4 d }

%définir riff_principal { ~un_riff ~un_riff/ 5 / }

Vous permet de définir les blocs peuvent également contenir des blocs de répétition, des blocs de courbure et $volume/patch/reverb etc.

@canal [nom] { contenu }

Commencer une piste midi sur le canal nombre, en définissant éventuellement le nom de l'instrument sur prénom. Si
prénom contient des espaces, il doit être entre guillemets doubles.

contenu peut inclure des notes, des silences, des séquences préalablement définies et les éléments suivants
Mots-clés:

$time_sig

Modifie la signature rythmique du morceau (affecte toutes les pistes). Les b la valeur doit être l'une des
4, 8, 16, 32, 64.

$tempo

Modifie le tempo du morceau (affecte toutes les pistes). t est en BPM.

$patch [[bank_LSB,]bank_MSB,]

Réglez le numéro de patch de ce canal sur nombre or prénom. Où nombre est de 1 à 128 et
prénom est un alias tel que défini dans README.patches. Sélectionnez éventuellement le numéro de banque banque_MSB.
Sélectionnez éventuellement le numéro de banque LSB banque_LSB (utilisé pour les claviers midi externes). Chaque valeur
doit être compris entre 1 et 128.

$ banque [LSB,]

Sélectionnez le numéro de banque MSB. Réglage optionnel de la valeur LSB (utilisée pour le midi externe
claviers) à LSB. Les deux valeurs doivent être comprises entre 1 et 128.

$longueur [n :]

Définir la longueur de note par défaut. La valeur est spécifiée dans le même format que dans les options de note.

$raccourcir

Raccourcir chaque note de nombre clics midi, pour laisser de l'espace pour que les notes soient décalées vers l'arrière.

$déquantifier [+|-] [%]

Appliquez un décalage aléatoire à chaque note. nombre a le même sens que pour le Z Remarque
au dessus.

$ octave

Définir l'octave par défaut sur nombre

$ volume

Réglez le volume de la piste sur nombre

$attaque

Réglez l'attaque de la note sur nombre

$pourriture

Réglez la décroissance de la note sur nombre

$réverbération

Réglez la profondeur de réverbération sur nombre sur la chaîne en cours.

$refrain

Réglez la profondeur de chorus sur nombre sur la chaîne en cours.

$pan

Réglez la valeur de panoramique sur nombre. 0 est à gauche 127 est à droite.

Les valeurs de volume, d'attaque, de décroissance, de réverbération, de chorus et de panoramique doivent être des entiers compris entre 0 et 127.
Ils peuvent également être spécifiés sous forme de plage (par exemple `8-64'), auquel cas une valeur aléatoire dans le
gamme est utilisée.

%pan_all { noter la valeur ... }

Définit la valeur de panoramique pour chaque instance suivante de noter dans la piste en cours. C'est
principalement destiné au panoramique d'un kit de batterie, mais pourrait être utilisé sur une autre piste. Plus-value peuvent être
un entier ou une plage (par exemple `8-64'). Plusieurs noter Plus-value les paires sont autorisées. Si deux notes
avec des valeurs pan_all différentes sont jouées en même temps, tout peut arriver.

Pour affecter chaque note du canal avec une plage, utilisez `*' ou 'tous' pour noterL’
/r4/la méthode de répétition des notes ne fonctionnera pas avec cette option, mais le même effet
peut être obtenu à l'aide d'un bloc de répétition.

$ marqueur

Ajoute un événement marqueur avec texte comme c'est le contenu. Si texte contient des espaces il doit être cité
en utilisant des guillemets doubles.

%répéter { Remarques }

Répéter note nombre fois. note peut inclure des notes, des silences, des séquences prédéfinies et d'autres
%répéter Blocs.

%pliez { un événement ... }

Jouez noter et déplacez la molette de pitch de la manière décrite par plusieurs un événements, qui ont
le format suivant:

[n :] <+|->

De n ainsi que d préciser l'heure depuis le début de la note ou depuis l'événement précédent, en
le même format que les longueurs de note, et Plus-value est la quantité pour plier la note (le plus
ou le signe moins est requis). Avec la plage de molette de pitch par défaut de +/- 2 demi-tons une valeur
de 32 équivaut à un demi-ton. Notez que la quantité de courbure est relative. Le maximum
accumulé le montant du pli est de plus ou moins 64.

Par exemple ce qui suit :

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

Joue la note a3 pour 1/4 de note, plie un ton entier pour 1/4 puis revient à a3 et
tient pour 1/2 note.

$bend_range

Modifie la plage de la molette de pitch à +/- nombre. Ceci définit la courbure maximale de haut en bas, donc si
il est réglé sur 4, une valeur de bend de 64 augmentera de 4 demi-tons et -64 baissera de 4
demi-tons. La plage par défaut pour la plupart des appareils midi est de 2 demi-tons.

emplacement $

Réglez la valeur de la molette de pitch sur vague. Ceci peut être utilisé en conjonction avec une note séparée sur
et notez les événements (voir ci-dessous sous « notes simultanées ») pour créer des flexions complexes
effets. Contrairement au %pliez syntaxe ci-dessus, cela fait ne sauraient remettre la molette de pitch au neutre
poste (64)

Des pitch bends plus simples peuvent être créés avec cette syntaxe :

/l8/e4=>g4=>e4

Cela passe de e4 à g4 et redescend à e4 par étapes linéaires sur la durée d'un
Huitième note. Par défaut, il y a 16 pas par durée de noire (8 pas dans ce
exemple), mais une valeur différente peut être définie à l'aide du commutateur de ligne de commande « -b ». N'importe quel chiffre
de notes peuvent être utilisées, mais la première doit avoir une valeur de longueur et chacune d'elles doit
avoir une valeur d'octave.

%choisir [heure] { élément de pondération ... }

où time est une valeur de longueur au format [n:] le même que celui utilisé dans les options de longueur,
avec le "l" omis.

If fiable n'est pas précisé :

Choisissez-en un questions d'examen à partir d'une liste, où chaque questions d'examen peut être une note, un silence ou un riff prédéfini, et
chaque élément a un pondération qui définit la probabilité qu'il soit choisi. Par exemple:

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

donne à a3 20% de chance, c5 - 40% ; e4 - 30% et g3 - 10% Chaque article must avoir une pondération.
Voir aussi les échelles ci-dessous.

if fiable est spécifié:

Choisissez plusieurs questions d'examens de la liste jusqu'à une longueur de fiable. Si tous les questions d'examenc'est trop long
pour terminer le riff exactement à fiable, le reste est rempli d'un silence. Quand choisir est utilisé
de cette façon, chaque note ou silence doit avoir une valeur de longueur et tous les riffs prédéfinis utilisés doivent
ont une longueur fixe (c'est-à-dire que la première note doit avoir une valeur de longueur), et la longueur de la
le riff entier doit être spécifié dans le bloc de choix dans le même format que pour les notes. pour
Exemple:

%define riff_1 { /l2/a3 /l4/b c4 } # riff fait 1 mesure

%choisir 4:1 { # choisissez 4 barres

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

}

If fiable is 0 or - puis moucheron cherche un bloc de la forme :

rythme { n[:d] ... }

qui est pris comme une série de valeurs de longueur de note dont les hauteurs sont choisies dans le
liste. D'autres jetons sont passés à travers, vous pouvez donc insérer des notes spécifiques, des riffs prédéfinis
ou se repose. Tout jeton dans le bloc commençant par un trait de soulignement sera transmis, avec
le trait de soulignement a été supprimé. Voir examples/tutorial/choose_scale.mg pour un exemple.

Une autre façon de spécifier la liste des notes/pondérations est d'utiliser le escaliers mot-clé:

escaliers mineur /l8/g4-6 [ poids ... ]

Cela sélectionne une gamme de sol mineur de la 4e à la 6e octaves (c'est-à-dire g4 à g6). La valeur de longueur
est inutile si vous utilisez un bloc rythmique. Si la -6 est omis une seule octave est
utilisé.

Le bloc de poids spécifie les pondérations des notes dans l'ordre. En cas d'omission, toutes les pondérations sont
égal. Pour ingérer une note, utilisez une pondération de 0, mais il must être une pondération pour chaque note
si le bloc est présent du tout.

La -S peut être utilisé pour afficher les notes dans une gamme ou une liste de gammes prises en charge.

%chaîne {
début
note1 [ note de poids ... ]

rythme [ poids longueur ... ] or rythme { longueur ... } }

Définir une structure de « chaîne » où pour chaque note il y a une liste pondérée de notes qui peuvent
suis le. Un point de départ est choisi au hasard parmi toutes les notes utilisées, ou spécifié avec
le Commencer mot-clé, puis les notes suivantes sont choisies dans la liste appropriée jusqu'à un
la longueur totale de fiable.

La rythme le mot-clé a deux formes : En utilisant des crochets `[]', une liste pondérée de notes
des longueurs peuvent être définies, qui seront choisies au hasard. En utilisant des accolades '{}', une liste de
des valeurs de longueur peuvent être définies qui seront utilisées dans l'ordre (en répétant si nécessaire). À
jouez une seule fois dans le bloc rythmique, réglez le fiable à 0 or -. Dans ce cas, le rythme
bloc est analysé de la même manière que décrit ci-dessus pour %choisir avec le temps mis à zéro. Les
mot-clé fois peut être utilisé comme synonyme de rythme.

La Commencer mot-clé spécifie la note à partir de laquelle commencer lors de l'utilisation de la chaîne. Si Commencer is
omis, la note de départ est choisie au hasard.

Une autre façon de définir les notes dans un chaîne bloc est d'utiliser l'une des échelles intégrées. Puis
les pondérations sont précisées sous forme de matrice, avec une ligne pour chaque note "depuis" (une
pour chaque note de la gamme) et une colonne pour chaque note "à". Un exemple de ce formulaire peut
se trouve dans le fichier examples/tutorial/chain_scale.mg

Pour utiliser les blocs choose ou chain, le fichier doit être compilé avec l'option unroll-loops
(il est défini automatiquement lorsqu'un bloc de choix ou de chaîne est trouvé). Cette option enregistre le
code source déroulé dans un nouveau fichier, donc s'il produit une sortie particulièrement bonne, vous avez un
copie exacte à laquelle vous pouvez apporter d'autres modifications sans perdre la piste générée.

Notez qu'un bloc de choix et de chaîne ne peut pas être à l'intérieur d'un %define ou à l'intérieur d'un autre choix ou
bloc de chaîne.

%évaluation { Code Perl }

Exécutez un bloc de code Perl et remplacez le bloc %eval par la valeur renvoyée par Perl
code.

%évaluation - { Code Perl }

Exécutez un bloc de code Perl sans lire la valeur de retour.

Le code Perl est exécuté en utilisant le module Safe s'il est présent, avec :base_core, :base_math et
:base_mem autorisé. Si Safe.pm n'est pas disponible ou si des autorisations supplémentaires sont nécessaires, l'option --unsafe
L'option fait que Midge exécute les blocs %eval dans son propre processus perl.

Mots-clés autorisés à tout moment dans la source.

%comprendre

Comprend le contenu de filet comme s'ils avaient été écrits à ce moment-là dans la source
fichier. Must être sur sa propre ligne dans le fichier source.

Notes simultanées.

La manière la plus flexible de jouer des notes simultanées est d'utiliser des pistes séparées (vous pouvez utiliser
le même canal/patch), ou en utilisant des événements note on et note off séparés (voir ci-dessous).
Cependant, il existe un moyen plus simple avec quelques limitations. Par exemple: ( c e g ) jouera
les notes c, e et g simultanément, formant un accord de do. La durée de toutes les séquences simultanées
notes est la même que la première (déterminée par sa propre valeur de longueur ou celle
hérité de la déclaration précédente de note, de silence ou de $length.

Une façon de l'utiliser pour créer des accords est la suivante :

%définir mineur { ( c e- g ) } # définit le mineur comme étant un c-mineur

%définir majeur { ( c e g ) } # définir le majeur comme étant un do majeur

%définir 7ème { ( c e g b- ) } # définir le 7e comme un c-7e

Ensuite, vous pouvez utiliser le dans vos morceaux de musique :

$length 4 $octave 4 # définir la longueur et l'octave par défaut

~majeur # jouer un do majeur

~mineur/9/ # jouer un a-mineur

~7/5/ # jouer un f-7e

Pour que les accords sonnent grattés, le gratter le mot-clé peut être utilisé :

$strum 5

Cela définit l'intervalle entre chaque note dans les accords suivants à 5 clics midi.

Pour créer des motifs complexes de notes simultanées sur une piste, séparez note on et note
les événements off peuvent être utilisés. Celles-ci sont spécifiées de la même manière que les notes normales, mais avec un +
préfixé pour la note et un - préfixé pour note off. Les options de longueur et de répétition ne peuvent pas
être utilisé. La longueur des notes saisies de cette manière est contrôlée en mettant des silences ou d'autres
notes entre les événements note on et note off. par exemple:

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

joue et maintient c4, après qu'un 1/4 de note joue et maintient e4 et après qu'un autre 1/4 de note joue
et maintient g4, relâchant les trois après une autre 1/2 note.

Nuplets.

S'il est possible de créer des tuplets en choisissant une longueur de note appropriée, ils peuvent également
être écrit d'une manière plus conventionnelle en utilisant le % nuplet mot-clé:

% nuplet n:d { remarques... }

joue n notes dans l'espace de d. note peut contenir tout ce qui est autorisé dans un bloc @channel.
Les valeurs de note sont ensuite automatiquement modifiées pour créer le n-olet. Par exemple:

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

joue cinq croches en l'espace de trois. Les n-uplets peuvent être imbriqués à n'importe quelle profondeur. Voir
exemples/tutorial/tuplet.mg pour un exemple. Midge fait ne sauraient vérifier que la durée de la musique
à l'intérieur du bloc tuplet est correct.

Les clés.

Si vous souhaitez importer votre fichier midi dans un éditeur de notation, vous devrez définir la clé.
Cela se fait avec :

$clé [+|-][m]

Où prénom est ag, +|- sont dièse et plat, et m est mineur. Si la pièce entière reste dans
la même clé, vous pouvez la définir dans la section @head, sinon elle peut apparaître n'importe où dans un
@channel, et affectera toutes les pistes.

Si vous êtes habitué à la notation musicale régulière et que vous souhaitez que les notes soient automatiquement nettes ou plates
selon la clé, utilisez le $key_strict mot-clé à la place. Pour obtenir une note naturelle, utilisez le =
signe, par exemple en G, f= joue un f naturel. Les $key_strict le mot-clé ne peut être utilisé que dans le
section @head. La clé peut toujours être changée en utilisant le $clé mot-clé.

$ctrl

Définir le numéro de contrôleur num à vague.

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

Réglez le contrôleur rpn num à vague

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

Définir le contrôleur nrpn num à vague

%textuellement { octet... }

Insérez une chaîne d'octets dans le fichier midi. Chaque octet peut être dans l'une ou l'autre décimale (0-255)
ou hexadécimal (0x00-0xFF). Le mot-clé octets peut être utilisé à la place de mot pour mot.

$imprimer

Imprimé texte à la sortie standard. Si texte contient des espaces, il doit être entre guillemets (").

Utiliser le moucheron en ligne à l'aide des services onworks.net