File: doc.html

package info (click to toggle)
songwrite 0.12b-4
links: PTS
area: main
in suites: sarge
size: 984 kB
ctags: 989
sloc: python: 6,321; xml: 850; makefile: 10
file content (778 lines) | stat: -rw-r--r-- 34,091 bytes
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
            "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD><TITLE></TITLE>

<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.06">
</HEAD>
<BODY >
<!--HEVEA command line is: hevea -o ./doc/fr/doc.html /tmp/@3615.0.hva ./doc/fr/doc.tex -->
<!--HTMLHEAD-->
<!--ENDHTML-->
<!--PREFIX <ARG ></ARG>-->
<!--CUT DEF section 1 -->


<H1 ALIGN=center>Documentation de Songwrite</H1>

<H3 ALIGN=center><FONT COLOR=navy>Jean-Baptiste ``Jiba'' LAMY (jiba@tuxfamily.org)</FONT></H3>
Copyright (c) 2002-2003 Lamy Jean-Baptiste.<BR>
<BR>
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation; with
the Invariant Sections being this foreword part.<BR>
<BR>
<!--TOC section Table of Contents-->

<H2>Table of Contents</H2><!--SEC END -->

<UL><LI>
<A HREF="#htoc1">1&nbsp;&nbsp;Introduction</A>
<UL><LI>
<A HREF="#htoc2">1.1&nbsp;&nbsp;Formats de fichier supports</A>
<LI><A HREF="#htoc3">1.2&nbsp;&nbsp;Liste de diffusion</A>
<LI><A HREF="#htoc4">1.3&nbsp;&nbsp;Un peu d'histoire  propos de SongWrite et GTablature...</A>
<LI><A HREF="#htoc5">1.4&nbsp;&nbsp;Visions futures</A>
</UL>
<LI><A HREF="#htoc6">2&nbsp;&nbsp;Configuration</A>
<LI><A HREF="#htoc7">3&nbsp;&nbsp;Crer une chanson</A>
<UL><LI>
<A HREF="#htoc8">3.1&nbsp;&nbsp;Proprits de la chanson</A>
<LI><A HREF="#htoc9">3.2&nbsp;&nbsp;Rythme</A>
<LI><A HREF="#htoc10">3.3&nbsp;&nbsp;Rptition / liste de lecture</A>
<LI><A HREF="#htoc11">3.4&nbsp;&nbsp;Menu <FONT COLOR=purple>Fichier</FONT></A>
<LI><A HREF="#htoc12">3.5&nbsp;&nbsp;Menu <FONT COLOR=purple>Edition</FONT></A>
<LI><A HREF="#htoc13">3.6&nbsp;&nbsp;Zoom</A>
</UL>
<LI><A HREF="#htoc14">4&nbsp;&nbsp;Les partitions</A>
<UL><LI>
<A HREF="#htoc15">4.1&nbsp;&nbsp;Proprits des partition</A>
<LI><A HREF="#htoc16">4.2&nbsp;&nbsp;Ajouter des partitions</A>
</UL>
<LI><A HREF="#htoc17">5&nbsp;&nbsp;Tablature</A>
<UL><LI>
<A HREF="#htoc18">5.1&nbsp;&nbsp;Notes</A>
<LI><A HREF="#htoc19">5.2&nbsp;&nbsp;Proprits des notes</A>
<LI><A HREF="#htoc20">5.3&nbsp;&nbsp;Effets speciaux</A>
<LI><A HREF="#htoc21">5.4&nbsp;&nbsp;Accordage</A>
<LI><A HREF="#htoc22">5.5&nbsp;&nbsp;Raccourcis au clavier</A>
</UL>
<LI><A HREF="#htoc23">6&nbsp;&nbsp;Porte</A>
<LI><A HREF="#htoc24">7&nbsp;&nbsp;Batterie</A>
<UL><LI>
<A HREF="#htoc25">7.1&nbsp;&nbsp;``Accorder'' sa batterie</A>
</UL>
<LI><A HREF="#htoc26">8&nbsp;&nbsp;Paroles</A>
<UL><LI>
<A HREF="#htoc27">8.1&nbsp;&nbsp;Mlodie</A>
<LI><A HREF="#htoc28">8.2&nbsp;&nbsp;Paroles</A>
<LI><A HREF="#htoc29">8.3&nbsp;&nbsp;Conversion</A>
</UL>
<LI><A HREF="#htoc30">9&nbsp;&nbsp;Selection et copier/coller</A>
<LI><A HREF="#htoc31">10&nbsp;&nbsp;Impression</A>
<UL><LI>
<A HREF="#htoc32">10.1&nbsp;&nbsp;Configuration</A>
<LI><A HREF="#htoc33">10.2&nbsp;&nbsp;Imprimer!</A>
</UL>
<LI><A HREF="#htoc34">11&nbsp;&nbsp;Livre de chansons</A>
<LI><A HREF="#htoc35">12&nbsp;&nbsp;Les entrailles de Songwrite</A>
<UL><LI>
<A HREF="#htoc36">12.1&nbsp;&nbsp;Intro  la prog dynamique</A>
<LI><A HREF="#htoc37">12.2&nbsp;&nbsp;Reprsentation</A>
<LI><A HREF="#htoc38">12.3&nbsp;&nbsp;Vues</A>
</UL>
<LI><A HREF="#htoc39">13&nbsp;&nbsp;Comment t'aider  raliser ce magnifique logiciel qu'est SongWrite?</A>
</UL>

<!--TOC section Introduction-->

<H2><A NAME="htoc1">1</A>&nbsp;&nbsp;Introduction</H2><!--SEC END -->

Songwrite est un diteur de tablature, destin plus particulirement
aux guitaristes Linuxiens. Il est crit en langage Python, et utilise
Timidity (ou autre) pour jouer les tablatures, et GNU Lilypond (Lilypond <A HREF="http://www.lilypond.org">)</A>
pour les imprimer.<BR>
<BR>
Pour l'installation et les pr-requis, voir le fichier README.<BR>
<BR>
Songwrite est un logiciel libre Free Software, disponible sous licence
GNU GPL (cette doc est sous GNU FDL; voyez le fichier LICENSE pour
plus d'info!).<BR>
<BR>
Fates plaisir  l'auteur, ne confondez pas ``Logiciels Libres''
et ``Freeware''! En plus d'tre "Freeware",
un Logiciel Libre est disponible sous forme de code source, qu'il
est permis de modifier et de redistribuer librement.<BR>
<BR>
<!--TOC subsection Formats de fichier supports-->

<H3><A NAME="htoc2">1.1</A>&nbsp;&nbsp;Formats de fichier supports</H3><!--SEC END -->
<BR>
<TABLE BORDER=1 CELLSPACING=0 CELLPADDING=1>
<TR><TD ALIGN=center NOWRAP>Format</TD>
<TD ALIGN=center NOWRAP>lecture</TD>
<TD ALIGN=center NOWRAP>criture</TD>
<TD ALIGN=center NOWRAP>commentaires</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>Format SongWrite</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>Format XML</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>Ancien format</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
<TD ALIGN=center NOWRAP>Srialization Python (<TT>pickle</TT>)</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>Midi</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>Rich Midi Tablature</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
<TD ALIGN=center NOWRAP>E</TD>
<TD ALIGN=center NOWRAP>Midi avec des meta-vnement pour les numros de frets</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>Tablature Ascii</TD>
<TD ALIGN=center NOWRAP>E</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>Test uniquement avec les tab Ascii de SongWrite</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>Guitar pro 3 et 4</TD>
<TD ALIGN=center NOWRAP>E</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>Lilypond</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>Pas de paroles</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>L<sup>A</sup>T<sub>E</sub>X et LyliPond</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>Tablature avec Lilypond, paroles avec L<sup>A</sup>T<sub>E</sub>X</TD>
</TR>
<TR><TD ALIGN=center NOWRAP>PostScript</TD>
<TD ALIGN=center NOWRAP>&nbsp;</TD>
<TD ALIGN=center NOWRAP>X</TD>
<TD ALIGN=center NOWRAP>Pour impression</TD>
</TR></TABLE><BR>
``E'' signifie EXPERIMENTAL (pas ou insuffisamment test), et
``X'' entirement supports.<BR>
<BR>
L'importation Midi a t teste avec des fichier Midi en provenance
de Songwrite, GNU Lilypond, Tabledit et NoteWorthy Composer.<BR>
<BR>
Depuis la version 0.9, Songwrite utilise un nouveau format de fichier
en XML, comprhensible par l'tre humain (voir le fichier <TT>songwrite.schema.xml</TT>,
pour l'instant non test faute d'avoir trouver un module de schema
XML en Python...). Les fichiers enregistrs dans l'ancien format peuvent
tre convertis au nouveau format simplement en les ouvrant dans Songwrite
et en les enregistrant, ou bien  l'aide du script <TT>convert_to_xml</TT>.
Ce script reoit comme argument une liste de fichier  convertir (exemple:
<TT>convert_to_xml /tablatures/*</TT>).<BR>
<BR>
<!--TOC subsection Liste de diffusion-->

<H3><A NAME="htoc3">1.2</A>&nbsp;&nbsp;Liste de diffusion</H3><!--SEC END -->

Pour s'inscrire  la liste de diffusion de Songwrite, il suffit d'envoyer
un ml  Songwrite-subscribe@oomadness.tuxfamily.org. Pour se dsabonner,
envoyer un ml  Songwrite-unsubscribe@oomadness.tuxfamily.org.<BR>
<BR>
<!--TOC subsection Un peu d'histoire  propos de SongWrite et GTablature...-->

<H3><A NAME="htoc4">1.3</A>&nbsp;&nbsp;Un peu d'histoire  propos de SongWrite et GTablature...</H3><!--SEC END -->

Il tait une poque recule o Songwrite s'appelait ``GTablature''.
Le nom a t chang depuis qu'il n'appartient plus au projet Gnome,
et que Gtk a t remplac par Tk.<BR>
<BR>
Les utilisateurs de GTablature reconnatront sans doute l'interface,
et le format de fichier est compatible!<BR>
<BR>
En rsum, voici mes raisons pour quitter le projet Gnome:
<UL><LI>
La nouvelle version de Gnome (Gnome 2) a de nombreuses incompatibilits
avec la prcdente. En particulier, le portages Python de Gtk 1 et
2 sont totalement incompatibles, et (contrairement au reste de Gnome)
ne peuvent pas tre installs en mme temps.<BR>
Comme je ne suis pas prt  r-crire l'interface de mon appli
 chaque nouvelle version de Gnome, j'ai prfr Tk.
<LI>Le spectre noir de .net flotte au-dessus de Gnome. Mon langage prfr
est Python, et Python.net n'est PAS Python. C'est .net, exactement
comme C++.net est .net et pas C++ (la diffrence? par exemple l'hritage
multiple, que d'ailleurs j'utilise beaucoup en Python).
</UL>
<!--TOC subsection Visions futures-->

<H3><A NAME="htoc5">1.4</A>&nbsp;&nbsp;Visions futures</H3><!--SEC END -->

Voir le fichier TODO pour plus d'info.<BR>
<BR>
<!--TOC section Configuration-->

<H2><A NAME="htoc6">2</A>&nbsp;&nbsp;Configuration</H2><!--SEC END -->

La premire fois que vous lancez Songwrite, la bote de dialogue
de configuration apparat. La configuration par dfaut devrait
convenir pour la pluppart des distributions Linux; il peut cependant
tre intressant d'utiliser un lecteur Midi diffrent de Timidity
(comme ``playmidi %s'' si votre carte son supporte le Midi).<BR>
<BR>
Pour changer la configuration a posteriori, prendre le menu <FONT COLOR=purple>edition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;prfrences...</FONT><BR>
<BR>
<!--TOC section Crer une chanson-->

<H2><A NAME="htoc7">3</A>&nbsp;&nbsp;Crer une chanson</H2><!--SEC END -->

<!--TOC subsection Proprits de la chanson-->

<H3><A NAME="htoc8">3.1</A>&nbsp;&nbsp;Proprits de la chanson</H3><!--SEC END -->

Songwrite est fait pour diter des ``chansons'' (dsol pour ceux
qui jouent de la guitare sans chanter :-). Au dmarrage, une nouvelle
chanson est cre et affiche.<BR>
<BR>
<IMG SRC="startup.png"><BR>
<BR>
Une chanson se compose d'une ou plusieurs partitions. Le mot ``partitions''
doit tre pris dans un sens trs large, puisqu'il comprend les
tablatures, mais aussi la batterie, et mme les paroles!<BR>
<BR>
Une chanson dispose aussi de diverses informations, comme le titre
ou les noms des auteurs. Ces info peuvent tre modifies dans
la bote de dialogue des propits de la chanson (que l'on obtient
par le menu <FONT COLOR=purple>chanson&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;proprits...</FONT>). Le titre,
le nom de l'auteur et les commentaires sont affichs en haut de la
fentre.<BR>
<BR>
La proprit langage de la chanson est utilise pour les paroles,
notamment lors de la conversion en source L<sup>A</sup>T<sub>E</sub>X  l'impression<BR>
<BR>
<IMG SRC="songprop.png"><BR>
<BR>
la bote de dialogue des propits de la chanson se compose
en haut d'une vue arborescente qui affiche les differentes partitions
(cliquer sur les triangles violet pour replier ou dvelopper l'arbre).
Le reste de la fentre liste les proprit de l'objet slectionn
dans l'arbre (par dfaut, la chanson).<BR>
<BR>
<!--TOC subsection Rythme-->

<H3><A NAME="htoc9">3.2</A>&nbsp;&nbsp;Rythme</H3><!--SEC END -->

Le menu <FONT COLOR=purple>chanson</FONT> propose diffrentes fonctions de lecture,
et le menu <FONT COLOR=purple>chanson&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;rythme</FONT> permet de changer le
rythme et le tempo des mesures slectionnes (ou de toutes les mesures
si aucune n'est slectionne). Seul les rythmes x/4 et y/8 (avec y
multiple de 3) sont supports.<BR>
<BR>
<!--TOC subsection Rptition / liste de lecture-->

<H3><A NAME="htoc10">3.3</A>&nbsp;&nbsp;Rptition / liste de lecture</H3><!--SEC END -->

Cliquez le menu <FONT COLOR=purple>chanson&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;rptitions...</FONT> pour faire
apparatre la bote de dialogue des rptitions. Pour ajouter un lment,
slectionner les notes des mesures  jouer (au moins une par mesure),
et cliquez sur <FONT COLOR=purple>Ajouter...</FONT>. Les boutons <FONT COLOR=purple>Supprimer</FONT>,
<FONT COLOR=purple>haut</FONT> et <FONT COLOR=purple>bas</FONT> permettent d'enlever ou de dplacer
les lments de la liste de lecture. Il est aussi possible de le modifier
un lment en le slectionnant, puis en changeant ses valeurs, ou
en slectionnant de nouvelles mesures puis en cliquant le bouton <FONT COLOR=purple>faire</FONT>.
La premire mesure est la mesure 0.<BR>
<BR>
<IMG SRC="repeat.png">
<DL COMPACT=compact><DT>
<B>Bogue</B><DD>Seules les listes de lectures qui peuvent tre traduites en
symboles musicaux sont affiches et imprimes correctement.
</DL>
<!--TOC subsection Menu <FONT COLOR=purple>Fichier</FONT>-->

<H3><A NAME="htoc11">3.4</A>&nbsp;&nbsp;Menu <FONT COLOR=purple>Fichier</FONT></H3><!--SEC END -->

Le menu <FONT COLOR=purple>fichier</FONT> propose les fonctions habituelles (ouvrir,
...) ainsi que l'import/export vers divers format.<BR>
<BR>
<!--TOC subsection Menu <FONT COLOR=purple>Edition</FONT>-->

<H3><A NAME="htoc12">3.5</A>&nbsp;&nbsp;Menu <FONT COLOR=purple>Edition</FONT></H3><!--SEC END -->

Ce menu permet notamment d'annuler ou de rpter les dernires oprations.
Le nombre d'annulation est rglable (20 par dfaut).<BR>
<BR>
<!--TOC subsection Zoom-->

<H3><A NAME="htoc13">3.6</A>&nbsp;&nbsp;Zoom</H3><!--SEC END -->

Les boutons - et +  droite de la barre d'outil permettent de changer
le zoom de l'axe temporel horizontal.<BR>
<BR>
<!--TOC section Les partitions-->

<H2><A NAME="htoc14">4</A>&nbsp;&nbsp;Les partitions</H2><!--SEC END -->

<!--TOC subsection Proprits des partition-->

<H3><A NAME="htoc15">4.1</A>&nbsp;&nbsp;Proprits des partition</H3><!--SEC END -->

Les diffrentes partitions sont affiches les unes en dessous des
autres. Au dmarrage, Songwrite affiche une seule partition: une tablature
de guitare.<BR>
<BR>
Chaque partition est en deux parties: un en-tte (le texte ``guitare''
par exemple) et le contenu de la partition elle-mme. L'en-tte
permet d'afficher des commentaires sur la partition, sur celui qui
la joue, ...<BR>
<BR>
Les partitions peuvent tre masque en cliquant avec le bouton
droit sur leur en-tte. Cliquez de nouveau pour la dmasquer.<BR>
<BR>
Cliquez sur le lien ``proprits'' en bleu  droite de l'en-tte
d'une partition pour accder  la bote de dialogue de ses proprits
(ou prenez le menu <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;proprits...</FONT>). Diffrents
paramtres sont disponibles, selon les types de partitions:
<UL><LI>
volume
<LI>muet: aucun son
<LI>chorus
<LI>reverb
<LI>en-tte
<LI>instrument: les diffrents intruments Midi sont dispos, ainsi que
la batterie.
<LI>tonalit
<LI>vue: permet de changer l'affichage de la partition. Principalement
utile pour convertir des tablatures en porte, et <EM>vice versa</EM>.
</UL>
<!--TOC subsection Ajouter des partitions-->

<H3><A NAME="htoc16">4.2</A>&nbsp;&nbsp;Ajouter des partitions</H3><!--SEC END -->

Le menu <FONT COLOR=purple>partition</FONT> propose diffrent type de partitions. Si
le vtre n'y est pas, mlez-moi son accordage!<BR>
<BR>
Le nombre de partition n'est pas limit, mais le format Midi utilis
pour la lecture est limit  16 ``channel'', dont 1 pour la batterie.
Dans SongWrite, chaque partition (sauf les paroles!) utilise 1 ``channel'',
ou 2 si elle comprend des effets spciaux (hammer, ...). On peut donc
utiliser au moins 7 instrument  la fois sans problme.<BR>
<BR>
Cliquer sur une partition permet de la slectionner. Les menus <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;monter</FONT>,
<FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;descendre</FONT> et <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;supprimer</FONT>
permettent de dplacer ou de supprimer les partitions.<BR>
<BR>
<!--TOC section Tablature-->

<H2><A NAME="htoc17">5</A>&nbsp;&nbsp;Tablature</H2><!--SEC END -->

Les tablatures sont cres par le sous-menu <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;nouvel
instrument  corde</FONT>&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;...<BR>
<BR>
SongWrite affiche une ligne pour chaque corde de l'instrument; comme
sur une vrai guitare les cordes les plus graves sont les plus grosses!
Les lines verticales correspondent aux barres de mesure; elles sont
aujoutes automatiquement.<BR>
<BR>
<!--TOC subsection Notes-->

<H3><A NAME="htoc18">5.1</A>&nbsp;&nbsp;Notes</H3><!--SEC END -->

La souris (clic gauche) ou les flches du curseur permettent de se
dplacer au sein de la tablature. Pour ajouter une note, il suffit
de tapper le (ou les) numros correspondant  la fret. Si le lecteur
Midi est bien configur, Songwrite jouera les notes au fur et  mesure
qu'elles sont entres.<BR>
<BR>
La dure des notes peut tre modifies  l'aide des boutons correspondant
dans la barre d'outil. La largeur de la slection correspond  la
dure de la note, ainsi que le pas de dplacement.<BR>
<BR>
Le bouton ``accentuation'' permet d'accentuer certaines notes
(qui sont affiches en rouge).<BR>
<BR>
Le menu <FONT COLOR=purple>note&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;arranger  la case...</FONT> permet de rorganiser
toutes les notes slectionnes sur les cordes de sorte  ce qu'elles
soient jou au-del de la case choisie. Pratique aprs une importation
Midi!<BR>
<BR>
<!--TOC subsection Proprits des notes-->

<H3><A NAME="htoc19">5.2</A>&nbsp;&nbsp;Proprits des notes</H3><!--SEC END -->

Double-cliquez sur une note (ou un groupe de notes) pour afficher
la bote de dialogue de proprits des notes. Les proprits
sont les suivantes:
<UL><LI>
valeur: la hauteur de la note
<LI>dure
<LI>volume (le contrle est ici plus fin que ce qu'offre le bouton
``accentuation'')
<LI>effet spcial (voir ci-dessous)
<LI>pitch: la hauteur (pour les bends)
</UL>
<!--TOC subsection Effets speciaux-->

<H3><A NAME="htoc20">5.3</A>&nbsp;&nbsp;Effets speciaux</H3><!--SEC END -->

Songwrite supporte la pluppart des effets spciaux ralisable avec
une guitare: hammer/pull/legato, slide, dead notes, bend, tremolo,
roll... sont tous prsents! Les effets qui lient deux notes entre
elles (hammers et slides) doivent tre appliqus sur la premire
des deux notes. Le rolldoit tre appliqu sur <EM>toutes</EM> les
notes de l'accord, et pas seulement sur la basse.<BR>
<BR>
<IMG SRC="special.png">
<DL COMPACT=compact><DT>
<B>Bogue</B><DD>Il n'est pas possible de mettre plus d'un effet spcial par
note :-(
<DT><B>Bogue</B><DD>Les combinaisons de slide et de hammer de plus de 5 semi-tons
ne peuvent pas tre joues en Midi.
</DL>
<!--TOC subsection Accordage-->

<H3><A NAME="htoc21">5.4</A>&nbsp;&nbsp;Accordage</H3><!--SEC END -->

La bote de dialogue d'une partition de type tablature permet
de changer l'accordage ou le nombre de corde. Et si vous tes
adepte d'un instrument qui n'est pas encore dans le menu <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;nouvel
instrument  corde</FONT> (banjo, mandolin, ...), n'oubliez pas de m'envoyer
son accordage afin de l'ajouter dans la prochaine version!<BR>
<BR>
<IMG SRC="tuning.png"><BR>
<BR>
Songwrite permet aussi de choisir pour chaque corde si les tiges des
notes doivent tre dirig vers le haut ou vers le bas de la tablature.
Pour ajouter une corde, il faut slectionner la bonne partition et
cliquer sur le bouton <FONT COLOR=purple>Ajjouter...</FONT> Pour supprimer une corde,
slectionnez-l et cliquez sur <FONT COLOR=purple>remove</FONT>. Les boutons <FONT COLOR=purple>haut</FONT>
et <FONT COLOR=purple>bas</FONT> permettent de changer l'ordre des cordes.<BR>
<BR>
<!--TOC subsection Raccourcis au clavier-->

<H3><A NAME="htoc22">5.5</A>&nbsp;&nbsp;Raccourcis au clavier</H3><!--SEC END -->

<DL COMPACT=compact><DT>
 
 
 
curseur<DD>dplacer la position en cours
<DT>tab,&nbsp;shift&nbsp;tab<DD>aller  la note suivante / prcdente (sur la mme
corde)
<DT>page&nbsp;suivante,&nbsp;prcdente<DD>aller  la mesure suivante / prcdente
<DT>dbut,&nbsp;fin<DD>aller au dbut /  la fin de la chanson
<DT>+,&nbsp;-<DD>augmenter ou diminuer la hauteur des notes slectionnes
<DT>/,&nbsp;*<DD>augmenter ou diminuer la dure des notes slectionnes
<DT>.<DD>note pointe
<DT>return<DD>note accentue
<DT>suppr<DD>supprime les notes slectionnes
<DT>n<DD>normal (pas d'effet special)
<DT>s<DD>slide
<DT>h<DD>hammer, pull ou legato
<DT>b<DD>bend
<DT>t<DD>tremolo
<DT>d<DD>dead note
<DT>r<DD>roll
<DT>espace<DD>joue depuis la position en cours
</DL>
<!--TOC section Porte-->

<H2><A NAME="htoc23">6</A>&nbsp;&nbsp;Porte</H2><!--SEC END -->

SongWrite permet aussi l'insertion de porte. Le support des porte
est cependant assez limit; il satisfera un guitariste mais sans doute
pas un pianiste! Le menu <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;nouvelle porte&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;...</FONT>
permet d'ajouter une nouvelle porte. La bote de dialogue des proprits
de la partition permet de choisir la tonalit.<BR>
<BR>
<IMG SRC="staff.png"><BR>
<BR>
Pour insrer des notes, cliquez avec le bouton droit de la souris
 l'endroit voulu, ou appuyer sur les touches ``+'' ou ``-''.
Ces deux touches permettent aussi de monter ou de descendre les notes
slectionnes d'un demi-ton. Pour ajouter des lignes au-dessus ou
en-dessous de la porte, placez une note  la limite suprieure ou
infrieure, et appuyez sur ``+'' ou ``-''.<BR>
<BR>
<!--TOC section Batterie-->

<H2><A NAME="htoc24">7</A>&nbsp;&nbsp;Batterie</H2><!--SEC END -->

Le menu <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;nouvelle batterie&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;...</FONT>
permet d'ajouter de nouveau instrument  percussion. Si quelqu'un
connat les patches qui sont dispos sur une batterie ``normale'',
je suis preneur!<BR>
<BR>
Les partitions de percu n'utilise pas les notations officiel (que
je ne connat pas), mais plutt un systme proche des tablatures.
Songwrite trace une ligne pour chaque patch; le nom du patch midi
est indiqu  gauche. Un clic droit (ou ``+'') sur une ligne y
ajoute un coup, visualis par un ``X''. Un nouveau clic droit
(ou ``-'') permet de l'enlever.<BR>
<BR>
<IMG SRC="drums.png"><BR>
<BR>
<!--TOC subsection ``Accorder'' sa batterie-->

<H3><A NAME="htoc25">7.1</A>&nbsp;&nbsp;``Accorder'' sa batterie</H3><!--SEC END -->

Comme les tablatures, les partitions de batterie peuvent tre
``accordes'' afin de modifier les patch proposs.
<DL COMPACT=compact><DT>
<B>Bogue</B><DD>Utiliser plusieurs fois le mme patch dans la mme
partition peut donner des rsultats bizarres...
</DL>
<!--TOC section Paroles-->

<H2><A NAME="htoc26">8</A>&nbsp;&nbsp;Paroles</H2><!--SEC END -->

<!--TOC subsection Mlodie-->

<H3><A NAME="htoc27">8.1</A>&nbsp;&nbsp;Mlodie</H3><!--SEC END -->

Tout d'abord, entrez la mlodie de la chanson,  l'aide d'une porte
ou, pourquoi pas, d'une tablature (pour ceux qui comme moi ne savent
pas lire une porte ;-).<BR>
<BR>
<!--TOC subsection Paroles-->

<H3><A NAME="htoc28">8.2</A>&nbsp;&nbsp;Paroles</H3><!--SEC END -->

Les paroles sont ajoutes grce au menu <FONT COLOR=purple>partition&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;nouvelles
paroles</FONT>. Elles doivent tre plac <EM>juste en-dessous</EM> la
mlodie (sans aucune autre partition entre la mlodie et les paroles).
Typiquement, on utilise un groupe de parole diffrent pour chaque
couplet et refrain.<BR>
<BR>
Ensuite, cliquez sur le rectangle des paroles et entrez le texte.
SongWrite aligne automatiquement les syllabes sur la mlodie, et les
repositionne correctement si la mlodie est modifie par la suite.
Les touches suivantes ont une fonction spciale:
<DL COMPACT=compact><DT>
 
 
 
espace,&nbsp;tab<DD>passer  la syllabe suivante
<DT>-<DD>passer  la syllabe suivante, en coupant le mot
<DT>_<DD>passer  la syllabe suivante, en poursuivant la syllabe prcdente
sur la note en cours
<DT>deux&nbsp;antislash<DD>fin d'un vers (retour  la ligne  l'impression)
<DT>entre<DD>nouvelle phrase sur la mme mlodie. Si plusieurs phrase
doivent tre chante sur la mme mlodie, ne recopiez pas
celle-ci inutilement!
</DL>
L'exemple suivant rcapitule assez bien tout a, et prsente deux
couplet d'une clbre chanson hacker (que vous trouverez dans le rpertoire
dmo de SongWrite).<BR>
<BR>
<IMG SRC="lyrics.png"><BR>
<BR>
Enfin, l'impression finale tant ralise par Lilypond et L<sup>A</sup>T<sub>E</sub>X,
il est possible d'utiliser des codes L<sup>A</sup>T<sub>E</sub>X dans les paroles!<BR>
<BR>
<!--TOC subsection Conversion-->

<H3><A NAME="htoc29">8.3</A>&nbsp;&nbsp;Conversion</H3><!--SEC END -->

A partir de la version 0.8, SongWrite dispose d'un nouveau systme
de paroles, qui permet d'entrer les paroles pour chaque note de la
mlodie. Le systme prcdent associait la parole aux mesures. Un
lien (en bleu) est propos pour convertir les anciennes paroles au
nouveau format; cependant la conversion n'est pas entirement automatique
:-( Il vous faudra en particulier couper les mots  la main (avec
``-'').<BR>
<BR>
<!--TOC section Selection et copier/coller-->

<H2><A NAME="htoc30">9</A>&nbsp;&nbsp;Selection et copier/coller</H2><!--SEC END -->

Songwrite dispose d'un systme de copier coller assez avanc. Pour
slectionner plusieurs notes, il suffit de tracer un rectangle autour
 la souris en maintenant le bouton gauche enfonc; les selections
htrognes sont possibles. Ensuite il est possible de cliquer sur
l'une des notes slectionnes pour dplacer l'ensemble de la slection.
Un clic droit lors du dplacement permet de l'interrompre.<BR>
<BR>
Songwrite utilise un copier-coller `` la Linux'': slectionner
c'est aussi copier, et un clic avec le bouton du milieu de la souris
permet de coller. Il est possible d'ajuster la position exacte du
collage en maintenant le bouton du milieu enfonc et en dplaant
la souris.<BR>
<BR>
Songwrite utilise la dure des notes pour les aligner horizontalement.<BR>
<BR>
<!--TOC section Impression-->

<H2><A NAME="htoc31">10</A>&nbsp;&nbsp;Impression</H2><!--SEC END -->

L'impression est encore experimental, bien qu'elle puisse dj produire
des rsultats assez impressionnant! Les tablatures sont imprimes
par Lilypond, grce au patch tablature que j'ai dvelopp, et
les paroles sont sous la responsabilit de L<sup>A</sup>T<sub>E</sub>X. Il n'est cependant
pas ncessaire de matriser ces deux logiciels pour imprimer
dans Songwrite!<BR>
<BR>
<!--TOC subsection Configuration-->

<H3><A NAME="htoc32">10.1</A>&nbsp;&nbsp;Configuration</H3><!--SEC END -->

Lilypond et L<sup>A</sup>T<sub>E</sub>X sont ncessaires pour l'impression. Une version
rcente de Lilypond est requise: suprieur ou gale  1.7. Lilypond
est dispo  cette adresse: <A HREF="www.lilypond.org">.</A> A la fin de l'installation
de Lilypond, il ne faudra pas oublier de placer les scripts d'initialisation
des polices TeX comme demand. Voir la fin de la sortie du ``make
install'' de Lilypond, reproduite ci-dessous:
<DIV ALIGN=left><DL COMPACT=compact><DT><DD><TT>
***&nbsp;Before&nbsp;running,&nbsp;buildscripts/out/lilypond-{profile,login}<BR>
<BR>
***&nbsp;must&nbsp;be&nbsp;run.&nbsp;You're&nbsp;advised&nbsp;to&nbsp;source&nbsp;these&nbsp;scripts&nbsp;from&nbsp;your<BR>
<BR>
***&nbsp;login&nbsp;scripts.&nbsp;For&nbsp;more&nbsp;information,&nbsp;see&nbsp;Invoking&nbsp;LilyPond&nbsp;in&nbsp;the&nbsp;manual.
</TT></DL></DIV>
<!--TOC subsection Imprimer!-->

<H3><A NAME="htoc33">10.2</A>&nbsp;&nbsp;Imprimer!</H3><!--SEC END -->

Pour l'instant, l'impression ne supporte pas:
<UL><LI>
les effets speciaux autres que les hammers/pulls, qui sont rendus
comme des legato.
<LI>les triolets ne sont supports  l'impression que s'ils sont prsents
par groupe de 3 (les notes lies sont permises).
<LI>plus de 2 notes en mme temps, mais pas dans un accord (=avec
des dures diffrentes). Ce cas ne devrait pas se produire dans une
``vrai'' tablature.
</UL>
<!--TOC section Livre de chansons-->

<H2><A NAME="htoc34">11</A>&nbsp;&nbsp;Livre de chansons</H2><!--SEC END -->

<IMG SRC="songbook.png"><BR>
<BR>
Un livre de chansons permet de regrouper plusieurs chansons pour les
imprimer ensembles et pour y accder plus facilement.<BR>
<BR>
Le menu <FONT COLOR=purple>Fichier&nbsp;<FONT FACE=symbol>|></FONT>&nbsp;Nouveau livre de chanson...</FONT> permet
de crer un nouveau livre. Le bouton <FONT COLOR=purple>Ajouter...</FONT> permet ensuite
d'ajouter des chansons dedans (il n'est possible d'ajouter que des
chansons qui sont enregistrs). Attention, SongWrite n'enregistre
pas les chansons dans le livre, mais seulement le nom du fichier de
la chanson, vous devez donc conserver les fichiers des chansons!<BR>
<BR>
Un clic sur une chansons du livre permet de l'ouvrir dans une nouvelle
fentre.<BR>
<BR>
Pour imprimer le livre, cliquez sur le bouton <FONT COLOR=purple>(Aperu avant)
impression</FONT>.<BR>
<BR>
<!--TOC section Les entrailles de Songwrite-->

<H2><A NAME="htoc35">12</A>&nbsp;&nbsp;Les entrailles de Songwrite</H2><!--SEC END -->

<!--TOC subsection Intro  la prog dynamique-->

<H3><A NAME="htoc36">12.1</A>&nbsp;&nbsp;Intro  la prog dynamique</H3><!--SEC END -->

Songwrite est crit en Python, et utilise au maximum les (nombreuses)
capacits dynamiques du langage, ainsi que certaines techniques issues
de la programmation par aspect<SUP><A NAME="text1" HREF="#note1"><FONT SIZE=2>1</FONT></A></SUP>. Oui, c'est bourr de hacks, mais  quoi sert un langage dynamic
sinon? Ici, j'essaieraie d'expliquer pourquoi cette faon de cod
est celle que je prfre<SUP><A NAME="text2" HREF="#note2"><FONT SIZE=2>2</FONT></A></SUP>. Et puis c'est beau :-P<BR>
<BR>
Je pense que la politique, et la vision que l'on a de la socit ``idale'',
influence notre manire de programmer. Aprs tout, un programme orient
objet n'est rien d'autre qu'une socit d'objet. Etant hacker et un
peu anarchiste, il est normal que mon code est cette allure.<BR>
<BR>
Beaucoup (trop) de gens ont (ou essaient d'avoir) une vision globale
de ce qu'il programme. Erreur! Car plus le projet sur lequel on travaille
est gros, plus cette vision est complexe! D'o la ncessit de se
perdre dans des mthodes tordues et peu utiles, comme UML... Ma mthode
 moi est simple: il suffit de dsigner une socit d'objets, chacun
ayant un rle et l'accomplissant de manire indpendante. Chaque
objet a sa propre vie. Quand tous les objets sont l, le boulot est
fait. Pas besoin de comprendre comment fonctionne l'ensemble, du moment
que chaque objet fait bien son job!<BR>
<BR>
Et si le projet est plus gros, et bien, il suffit d'y mettre plus
d'objets!<BR>
<BR>
<!--TOC subsection Reprsentation-->

<H3><A NAME="htoc37">12.2</A>&nbsp;&nbsp;Reprsentation</H3><!--SEC END -->

SongWrite spare les donnes d'un ct (les notes, ...) et leur
vue/reprsentation de l'autre (tablature, batterie, paroles,...).<BR>
<BR>
Le module Python <TT>song.py</TT> dfinie les classes pour les donnes:
Song, Partition et Note. Il est indpendant du reste de Songwrite
et peut tre r-utilis dans d'autres programmes (sous GPL) pour
gnrer des fichiers Midi.<BR>
<BR>
L'objet <TT>song</TT> a une liste de partitions appele <TT>partitions</TT>.
Cette liste contient des partitions, des lyrics,...des instances de
sous-classes de <TT>TemporalData</TT> (<TT>Partition</TT>, <TT>Lyrics</TT>,...).
Un <TT>TemporalData</TT> se compose d'une liste de sous-lments,
appel <TT>notes</TT>.<BR>
<BR>
Les effets speciaux sont des sous-classes de <TT>Note</TT>. La classe
<TT>LinkedNote</TT> est la classe des notes lies (en tant que source
et/ou destination), et <TT>HammerNote</TT> et <TT>SlideNote</TT> sont
de sous-classes de <TT>LinkedNote</TT>.<BR>
<BR>
La batterie est traite exactement comme une partition normale, sauf
qu'elle utilise l'instrument ``batterie'' n128 (valeur non utilise
par le format Midi).<BR>
<BR>
<!--TOC subsection Vues-->

<H3><A NAME="htoc38">12.3</A>&nbsp;&nbsp;Vues</H3><!--SEC END -->

La classe <TT>View</TT> est dfinie dans le module <TT>view.py</TT>.
Importer ce module modifie la classe <TT>TemporalData</TT> et lui
ajouteune proprit <TT>view</TT>, qui correspond  la vue associe
 la partition.<BR>
<BR>
Le module <TT>view.py</TT> dfinie aussi les classes <TT>View</TT>
et <TT>GraphicNote</TT>, qui servent de classes de base pour les diffrentes
vues et les lments quelles affichent (1 <TT>GraphicNote</TT> pour
chaque <TT>Note</TT>). Les <TT>GraphicNote</TT> crent des lment
de canvas Tkinter afin de reprsenter la note correspondante.<BR>
<BR>
<!--TOC section Comment t'aider  raliser ce magnifique logiciel qu'est SongWrite?-->

<H2><A NAME="htoc39">13</A>&nbsp;&nbsp;Comment t'aider  raliser ce magnifique logiciel qu'est SongWrite?</H2><!--SEC END -->

<UL><LI>
Envoyez vos suggestions!
<LI>Ainsi que les accordages de vos intrument!
<LI>Traduisez Songwrite dans une autre langue (Songwrite utilise le standard
GNU Gettext)
<LI>Amliorez cette doc.
<LI>Portez Songwrite vers d'autres OS. Comme la GUI est maintenant en
Tk, les portage devrait tre facile. Timidity peut tre
remplac par un autre lecteur Midi; pour Lilypond c'est plus difficile...
<LI>De nouveau filtre d'import/export: assez facile  raliser (voyez
le module <TT>song.py</TT>).
<LI>Pour les hackers: codez de nouveaux types de partitions!
<LI>Voir le fichier TODO pour d'autres suggestions!</UL>
<!--BEGIN NOTES document-->
<HR WIDTH="50%" SIZE=1><DL><DT><A NAME="note1" HREF="#text1"><FONT SIZE=5>1</FONT></A><DD><A HREF="http://aopd.net">V</A>oir par exemple comment le module <TT>view</TT>
ajoute une classe mre supplmentaire  la classe <TT>song.TemporalData</TT>,
ou le module <TT>editobj.eventobj</TT> (dans EditObj).
<DT><A NAME="note2" HREF="#text2"><FONT SIZE=5>2</FONT></A><DD>On pourrait en faire un bouquin... qui changerait des mthodes UML
et compagnie!
</DL>
<!--END NOTES-->
<!--HTMLFOOT-->
<!--ENDHTML-->
<!--FOOTER-->
<HR SIZE=2>
<BLOCKQUOTE><EM>This document was translated from L<sup>A</sup>T<sub>E</sub>X by
</EM><A HREF="http://pauillac.inria.fr/~maranget/hevea/index.html"><EM>H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A</EM></A><EM>.
</EM></BLOCKQUOTE>
</BODY>
</HTML>