Documentation/fr/application/converters.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
   2
   3 @ignore
   4     Translation of GIT committish: e2070eadd7d3d7a87450aab195a48945ee0b144a
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @c \version "2.12.0"
  11
  12 @c Translators: Jean-Charles Malahieude
  13
  14 @node Converting from other formats
  15 @chapter Converting from other formats
  16
  17 La musique peut aussi être récupérée par importation d'un autre
  18 format.  Ce chapitre passe en revue les différents outils prévus à cet
  19 effet et inclus dans la distribution.  Il existe d'autres outils qui
  20 permettent de générer du code LilyPond, comme par exemple des
  21 séquenceurs en mode graphique ou des convertisseurs XML.  Pour plus
  22 de détails, rendez-vous sur le @uref{http://@/lilypond@/.org,site}.
  23
  24 Il s'agit de programmes distincts de @command{lilypond} qui se lancent
  25 en ligne de commande.  Pour plus de précisions, reportez-vous au
  26 chapitre @ref{Command-line usage}.  Si vous utilisez MacOS 10.3 ou 10.4
  27 et recontrez quelque problème avec l'un de ces scripts, comme
  28 @code{convert-ly}, reportez-vous au chapitre @ref{Setup for MacOS X}.
  29
  30 @knownissues
  31
  32 Les développeurs ne sont malheureusement pas suffisament nombreux et
  33 disponibles pour maintenir à jour ces programmes, considérez-les donc
  34 @emph{en l'état}.  Nous acceptons les patches avec plaisir, mais il y a
  35 peu de chance pour que nous soyons en mesure de résoudre les bogues de
  36 ces programmes.
  37
  38 @menu
  39 * Invoking midi2ly::            importation de musique au format MIDI.
  40 * Invoking musicxml2ly::        importation de partitions au format MusicXML.
  41 * Invoking abc2ly::             importation de partitions au format ABC.
  42 * Invoking etf2ly::             importation de partitions Finale.
  43 * Generating LilyPond files::   interfaces graphiques, outils de
  44                                 transcription et de composition algorithmique.
  45 @end menu
  46
  47
  48
  49 @node Invoking midi2ly
  50 @section Invoking @command{midi2ly}
  51
  52 @cindex MIDI
  53
  54 @command{midi2ly} traduit un fichier MIDI de Type@tie{}1 en un fichier
  55 source LilyPond.
  56
  57 MIDI (Music Instrument Digital Interface) constitue un standard pour
  58 les instruments. Il spécifie le cablage, un protocole série et un
  59 format de fichier.  Le format de fichier MIDI est de ce fait un format
  60 standard pour exporter de la musique à partir d'autres programmes, et
  61 cette faculté prend tout son intérêt lorsqu'un programme dispose d'un
  62 convertisseur capable d'importer directement un fichier.
  63
  64 @command{midi2ly} convertit les pistes en contextes de portée
  65 (@rinternals{Staff}) et les canaux en contextes de voix
  66 (@rinternals{Voice}).  Les hauteurs sont rendues en mode relatif, et
  67 les durées spécifiées lorsque nécessaire.
  68
  69 Vous pouvez enregistrer un fichier MIDI grâce à un clavier
  70 électronique et ensuite le convertir en fichier @file{.ly}.  Néanmoins
  71 le rythme humain n'a pas une précision suffisante pour qu'une
  72 conversion MIDI à ly ne se fasse sans surprise.  En le couplant à une
  73 quantisation (options @code{-s} et @code{-d}), @command{midi2ly} tente
  74 de compenser dans la mesure du possible ces problèmes de
  75 temporisation.  C'est la raison pour laquelle le recours à
  76 @command{midi2ly} n'est pas recommandé pour des fichiers midi générés
  77 manuellement.
  78
  79
  80 Pour le lancer en ligne de commande, procédez ainsi :
  81 @example
  82 midi2ly [@var{option}]@dots{} @var{fichier-midi}
  83 @end example
  84
  85 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
  86 commande du système.  Pour plus de précisions, reportez-vous à
  87 @ref{Command-line usage}.
  88
  89 @command{midi2ly} accepte les options suivantes :
  90
  91 @table @code
  92 @item -a, --absolute-pitches
  93 Rendu en hauteurs absolues.
  94
  95 @item -d, --duration-quant=@var{DUR}
  96 Quantiser les durées à partir de @var{DUR}.
  97
  98 @item -e, --explicit-durations
  99 Rendu explicite des durées.
 100
 101 @item -h,--help
 102 Afficher un résumé des utilisations.
 103
 104 @item -k, --key=@var{acc}[:@var{minor}]
 105 Déterminer la tonalité par défaut.  @math{@var{acc} > 0} fixe le
 106 nombre de dièses ; @math{@var{acc} < 0} le nombre de bémols.  Une
 107 tonalité mineure est spécifiée par l'emploi de @code{:1}.
 108
 109 @item -o, --output=@var{file}
 110 Générer le résultat dans le fichier @var{file}.
 111
 112 @item -s, --start-quant=@var{DUR}
 113 Quantiser le début des notes sur @var{DUR}.
 114
 115 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
 116 Accepter des n-olets de valeur @var{DUR}*@var{NUM}/@var{DEN}.
 117
 118 @item -V, --verbose
 119 Mode verbeux.
 120
 121 @item -v, --version
 122 Afficher le numéro de version.
 123
 124 @item -w, --warranty
 125 Afficher les mentions de garantie et de copyright.
 126
 127 @item -x, --text-lyrics
 128 Interpréter le texte comme des paroles.
 129 @end table
 130
 131
 132 @knownissues
 133
 134 Le tuilage en arpège ne sera pas rendu correctement.  La première note
 135 sera lue et les suivantes ignorées.  Affectez-leur une durée unique et
 136 ajoutez une indication de phrasé ou de pédale.
 137
 138
 139 @node Invoking musicxml2ly
 140 @section Invoking @code{musicxml2ly}
 141
 142 @cindex MusicXML
 143
 144 @uref{http://@/www.@/musicxml@/.org/,MusicXML} est un
 145 dialecte XML pour représenter la notation musicale.
 146
 147 @command{musicxml2ly} extrait, à partir d'un fichier MusicXML, les
 148 notes, articulations, structure de la partition, paroles, etc.
 149 et les écrit dans un fichier @var{.ly}.  Il se lance en ligne de
 150 commande.
 151
 152 Pour le lancer en ligne de commande, procédez ainsi :
 153 @example
 154 musicxml2ly [@var{option}]@dots{} @var{fichier-xml}
 155 @end example
 156
 157 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
 158 commande du système.  Pour plus de précisions, reportez-vous à
 159 @ref{Command-line usage}.
 160
 161 Si le nom du fichier est @file{-}, @command{musicxml2ly} lira
 162 directement à partir de la ligne de commande.
 163
 164 @command{musicxml2ly} accepte les options suivantes :
 165
 166 @table @code
 167 @item -a, --absolute
 168 Rendu en hauteurs absolues.
 169
 170 @item -h,--help
 171 Afficher un résumé des utilisations.
 172
 173 @item -l, --language=LANG
 174 Utiliser un autre fichier de définition liguistique @file{LANG.ly}
 175 et les noms de notes correspondants, comme par exemple
 176 @var{deutsch} pour @file{deutsch.ly} et noms de notes en allemand.
 177
 178 @item --lxml
 179 Utiliser le paquetage Python lxml.etree, moins gourmand en mémoire et
 180 temps de calcul, pour effectuer l'annalyse XML.
 181
 182 @item --nd --no-articulation-directions
 183 Ne pas convertir la direction (@code{^}, @code{_} ou @code{-}) des
 184 articulations, nuances, etc.
 185
 186 @item --no-beaming
 187 Ne pas convertir les informations de ligature ; laisser LilyPond gérer
 188 les ligatures automatiquement.
 189
 190 @item -o,--output=@var{fichier}
 191 Générer le résultat dans le fichier @var{fichier}.  S'il n'est pas
 192 déterminé, ce sera @var{fichier-xml}@file{.ly} ; @file{-} produira le
 193 résultat sur la sortie standard (@var{stdout}).
 194
 195 @item -r,--relative
 196 Rendu en hauteurs relatives (mode par défaut).
 197
 198 @item -v,--verbose
 199 Mode verbeux.
 200
 201 @item --version
 202 Afficher le numéro de version.
 203
 204 @item -z,--compressed
 205 Le fichier d'entrée est un fichier MusicXML zippé.
 206 @end table
 207
 208
 209 @node Invoking abc2ly
 210 @section Invoking @code{abc2ly}
 211
 212 @cindex ABC
 213
 214 ABC est un format relativement simple basé sur l'ASCII.  Sa
 215 description est disponible sur le
 216 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html,site
 217 d'ABC}.
 218
 219 @command{abc2ly} traduit du format ABC au format LilyPond.
 220
 221 Pour le lancer en ligne de commande, procédez ainsi :
 222 @example
 223 abc2ly [@var{option}]@dots{} @var{fichier-abc}
 224 @end example
 225
 226 @command{abc2ly} accepte les options suivantes :
 227
 228 @table @code
 229 @item -b,--beams=None
 230 Préserver la notion de lien de croches propre à ABC.
 231 @item -h,--help
 232 Afficher un résumé des utilisations.
 233 @item -o,--output=@var{file}
 234 Générer le résultat dans le fichier @var{file}.
 235 @item -s,--strict
 236 Être strict sur la réussite.
 237 @item --version
 238 Afficher le numéro de version.
 239 @end table
 240
 241 Il est possible d'ajouter des bribes de code LilyPond dans un fichier
 242 source ABC.  Ainsi, l'assertion
 243
 244 @example
 245 %%LY voices \set autoBeaming = ##f
 246 @end example
 247
 248 aura pour conséquence d'insérer le texte qui suit le mot-clé @qq{voices}
 249 dans la voix correspondante du fichier LilyPond.
 250
 251 De la même manière,
 252
 253 @example
 254 %%LY slyrics more words
 255 @end example
 256
 257 placera le texte suivant le mot-clé @qq{slyrics} dans une ligne de paroles.
 258
 259
 260 @knownissues
 261
 262 Le standard ABC n'est pas si @qq{standard} que cela.  Pour des
 263 fonctionnalités étendues, comme la polyphonie, existent différentes
 264 conventions.
 265
 266 Un fichier comportant plusieurs morceaux ne peut être converti.
 267
 268 ABC synchronise paroles et musique en début de ligne ;
 269 @command{abc2ly} ne le fait pas.
 270
 271 @command{abc2ly} ignore les ligatures ABC.
 272
 273
 274 @node Invoking etf2ly
 275 @section Invoking @command{etf2ly}
 276
 277 @cindex ETF
 278 @cindex Enigma
 279 @cindex Finale
 280 @cindex Coda Technology
 281
 282 ETF (Enigma Transport Format) est l'un des formats utilisés par le
 283 logiciel Finale, édité par Coda Music Technology.  @command{etf2ly}
 284 convertit partiellement les fichiers ETF en fichiers source LilyPond.
 285
 286
 287 Pour le lancer en ligne de commande, procédez ainsi :
 288 @example
 289 etf2ly [@var{option}]@dots{} @var{fichier-etf}
 290 @end example
 291
 292 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
 293 commande du système.  Pour plus de précisions, reportez-vous à
 294 @ref{Command-line usage}.
 295
 296 @command{etf2ly} accepte les options suivantes :
 297
 298 @table @code
 299 @item -h,--help
 300 Afficher cette aide.
 301 @item -o, --output=@var{file}
 302 Générer le résultat dans le fichier @var{file}.
 303 @item --version
 304 Afficher le numéro de version.
 305 @end table
 306
 307
 308 @knownissues
 309
 310 La liste des scripts d'articulation est incomplète.  Les mesures vides
 311 perturbent @command{etf2ly}.  Les séquences de notes d'ornement ne se
 312 terminent pas de manière satisfaisante.
 313
 314
 315
 316 @node Generating LilyPond files
 317 @section Generating LilyPond files
 318
 319 @cindex programmes externes générant des fichiers LilyPond
 320
 321 LilyPond ne prend pas en charge d'autre format. Cependant, certains
 322 outils indépendants permettent de générer des fichiers LilyPond.
 323
 324 Nous citerons entre autres
 325
 326 @itemize
 327 @item
 328 @uref{http://@/denemo@/.org,Denemo}, une interface
 329 graphique pour l'édition de partition.
 330 @item
 331 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, un
 332 convertisseur temps-réel de MIDI monophonique à LilyPond.
 333 @item
 334 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, un
 335 mode majeur pour Emacs.
 336 @item
 337 @uref{http://@/www@/.nongnu@/.org/@/xml2ly/, xml2ly}, qui importe du
 338 @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}.
 339 @item
 340 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit}
 341 qui importe du @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}.
 342 @item
 343 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
 344 qui importe du MIDI.
 345 @item
 346 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
 347 une bibliothèque LISP pour générer de la notation musicale.
 348 @item
 349 @uref{http://@/vsr@/.informatik@/.tu-chemnitz@/.de/staff/jan/nted/nted.xhtml,NtEd}
 350 assure, de manière expérimentale, un export vers LilyPond.
 351 @item
 352 @uref{http://@/www@/.tuxguitar@/.com@/.ar/,TuxGuitar} peut exporter au
 353 format LilyPond.
 354 @item
 355 @uref{http://@/musescore@/.org,MuseScore} peut exporter au format LilyPond.
 356 @end itemize
 357