<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&krec;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title
>Manuel de &krec;</title>

<authorgroup>
<author
><firstname
>Arnold</firstname
> <surname
>Krille</surname
> <affiliation
> <address
><email
>arnold@arnoldarts.de</email
></address>
</affiliation>
</author>
</authorgroup>

&traducteurLudovicGrossard; 

<copyright>
<year
>2002</year>
<holder
>Arnold Krille</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-08-20</date>
<releaseinfo
>0.01.00</releaseinfo>

<abstract>
<para
>&krec; est une interface d'enregistrement pour &arts;. Il peut être utilisé pour enregistrer des fichiers uniques ou toute des sessions d'enregistrement entières. Quelques effets dynamiques sont implémentés ainsi que la possibilité de lire ce que vous enregistrez (à partir du moemnt ou vous n'enregistrez pas ce que vous entendez). </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>KRec</keyword>
<keyword
>aRts</keyword>
<keyword
>enregistrement</keyword>
<keyword
>interface</keyword>
</keywordset>

</bookinfo>
 
<chapter id="introduction">
<title
>Introduction</title>

<sect1 id="why-krec">
<title
>Pourquoi j'ai écrit &krec;</title>

<para
>Après avoir travaillé avec &arts;, je me suis rendu compte qu'il n'y avait pas d'interface d'enregistrement à part l'outil en ligne de commande <command
>artsrec</command
>. Je devais enregistrer quelque chose à la radio que je devait ensuite mixer pour des amis, et je voulais utiliser &Linux; pour enregistrer. J'ai donc commencé à écrire &krec;. </para>
</sect1>

<sect1 id="what-krec-does">
<title
>Ce que fait &krec;</title>

<para
>La fonction de &krec; est plutôt simple. Il se connecte au serveur &arts; et enregistre ce qui est acheminé vers lui dans un fichier. </para>
<para
> Pour l'instant, il n'écrit que des fichiers raw, qui sont des fichiers Wave sans l'en-tête wav (<application
>sox</application
> est votre amis). </para>
</sect1>

</chapter>

<chapter id="using-krec">
<title
>Utilisation de &krec;</title>

<para
>Ce chapitre décrit l'utilisation de &krec;. Il y a plusieurs façons d'utilisez &krec;, donc j'ai créé des sections semblables à des <quote
>HOWTO</quote
> décrivants les possibilités d'utilisation. Lisez simplement le premier paragraphe de chaque section et décidez ce que vous devez lire. Vous pouvez aussi tout lire et découvrir les fantastiques possibilités de &krec;.</para>

<screenshot>
<screeninfo
>Voici une capture d'écran de &krec;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="krec-hicolor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Voici une capture d'écran de &krec;, bien après son démarrage.</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect1 id="simple-usage">
<title
>Enregistrer un simple fichier</title>

<para
>Si vous entendez quelque chose à la radio et souhaitez l'enregistrer (et que votre radio est reliée à votre carte son), il y a un moyen (relativement) rapide d'enregistrer. </para>

<orderedlist>
<listitem>
<para
>Tout d'abord, vous devez sélectionner la source d'enregistrement dans votre carte son. Vous avez besoin ici de votre table de mixage favorite (&kmix;) dans laquelle vous devez sélectionner la source que vous souhaitez enregistrer. Vous devez également configurer le serveur &arts; pour le full-duplex (votre carte son et vos pilotes doivent gérer ce mode également). Si vous devez redémarrer &arts;, redémarez &krec; également. </para>
</listitem>
<listitem>
<para
>Vous devez ensuite ouvrir &arts;-Control et son gestionnaire audio. Il montre deux nouveaux éléments : &krec;::In et &krec;::Out, le dernier est utilisé pour la lecture et n'intervient pas ici. Concentrons-nous sur le premier, il doit être connecté au bus <emphasis
>in_soundcard</emphasis
>. Si vous ne pouvez pas le sélectionner, quelque chose est probablement mal configuré (pas de full-duplex ou quelque chose comme ça).</para>
</listitem>
<listitem>
<para
>Si tout a fonctionné, vous devriez voir maintenant quelque chose de déplacer dans &krec; &mdash; le VU-mètre affichant le niveau d'enregistremenr. Pour de bons enregistrements, sans écrétage, il doit être jaune ou orange, mais pas rouge. La glissière à droite du VU-mètre contrôle le volume.</para>
</listitem>
<listitem>
<para
>Maintenant, vous avez besoin d'un fichier dans lequel enregistrer. Utilisez <menuchoice
><guimenu
>Fichier</guimenu
><guimenuitem
>Nouveau fichier</guimenuitem
></menuchoice
> ou le symbole correspondant dans la barre d'outils pour le créer. Après ceci, vous devez dire à &krec; d'enregistrer dans ce fichier. Ceci se fait dans le menu contextuel de l'élément fichier.</para>
</listitem>
<listitem>
<para
>Vous pouvez maintenant commencer l'enregistrement. Utilisez le gros bouton rouge dans la barre d'outils ou <guimenu
>Lire</guimenu
><guimenuitem
>Enregistrer</guimenuitem
> ou appuyez simplement sur <keycap
>R</keycap
>. Pour arrêter l'enregistrement, utilisez le bouton d'arrêt ou l'entrée dans le menu <guimenu
>Lire</guimenu
> (ou la touche <keycap
>S</keycap
>).</para>
</listitem>
</orderedlist>

<para
>Bon, ce n'est pas aussi rapide que d'appuyer sur la touche d'enregistremenr de votre lecteur de cassettes, mais &krec; à plus de caractéristiques que votre magnétophone, croyez-moi.</para>

<tip>
<para
>Vous voudrez probablement enregistrer d'autres choses. Pour tester, vous pouvez prendre le signal de sortie de &noatun;. Réglez &krec;::In à <emphasis
>out_soundcard</emphasis
> (ou à tout autre bus dans lequel &noatun; vous permet de lire). Ceci fonctionne même si le mode full-duplex n'est pas activé dans &arts;.</para>
</tip>
</sect1>

<sect1 id="advanced-usage">
<title
>Enregistrer plusieurs fichiers</title>

<para
>Pour cette section, nous partons du principe que vous souhaitez enregistrer plusieurs parties plus ou moins grosses dans plusieurs fichiers. Par exemple, vous voulez enregistrer des scènes pour la radio ou quelque chose du genre (c'est la raison pour laquelle j'ai écrit &krec;). </para>

<para
>Je suppose que vous avez déjà utilisé &arts; avant et en savez un peu sur l'<quote
>enregistremenr automatique</quote
>. Votre microphone, ou tout ce que vous voulez enregistrer, doit être relié à votre ordinateur et vous devriez savoir comment le configurer (en dehors de &krec;) pour enregistrer le signal d'entrée. </para>

<para
>Ce tutoriel utilise une émission de radio comme exemple. Nous devons décider si nous voulons nommer tous les enregistrements de la même manière ou si seulement une partie des enregistrement doit avoir le même nom, différenciés par un numéro. Tout d'abord, suivez les instructions dans <xref linkend="simple-usage"/> et gardez à l'esprit que vous pouvez ouvrir plusieurs fichiers simultanément et ensuite choisir dans lequel enregistrer. La suite est décrite ici&etc; </para>

<orderedlist>
<listitem
><para
>Avant de commencer, assurez-vous que tout est configuré correctement, en particulier que vous enregistrez réellement ce que vous voulez. Vous avez une confirmation que tout est correct si le VU-mètre de &krec; bouge. Si vous n'enregistrez pas depuis <emphasis
>out_soundcard</emphasis
>, vous pouvez sélectionner <guimenu
>Lire</guimenu
><guimenuitem
>Lecture simultanée</guimenuitem
> de façon que le signal enregistré soit acheminé à la sortie de la carte son. Je vous recommande de procéder ainsi plutôt que d'utiliser la table de mixage de la carte son car vous pouvez entendre si le son est trop fort ou pas assez.</para
></listitem>
<listitem
><para
>Pour plusieurs fichiers avec le même nom, vous avez besoin d'une session. Utilisez <guimenu
>Fichier</guimenu
><guimenuitem
>Nouvelle session</guimenuitem
>. Sélectionnez le chemin et saisissez le nom du fichier que sera étendu avec le numéro et le suffixe de l'enregistrement.</para
></listitem>
<listitem
><para
>Vous avez encore besoin de fichiers pour enregistrer, mais cette fois vous les créez en sélectionnant <guimenuitem
>Nouveau fichier</guimenuitem
> depuis le menu contextuel. Vous pouvez créer autant de fichier que vous voulez.</para
></listitem>
<listitem
><para
>Le reste est simple. Sélectionnez le fichier dans lequel vous voulez enregistrer puis enregistrez...</para
></listitem>
</orderedlist>

<note
><para
>Une session n'est pas un autre type MIME, ou même un fichier. C'est juste un objet interne pour organiser la numérotation. Vous ne pouvez donc pas réouvrir une session plus tard et continuer d'enregistrer de nouveaux fichiers... </para
></note>
</sect1>

<sect1 id="more-usage">
<title
>Astuces et recommandations d'utilisation</title>

<para
>Il y a certaines choses à dire et quelques éléments à expliquer.</para>

<sect2 id="usage-play-through">
<title
>Utilisation de la lecture simultanée</title>

<para
>Pour ceux qui souhaitent entendre ce qu'ils enregistrent, il y a une option très utile nommée <quote
>lecture simultanée</quote
>. Elle se trouve dans le menu <guimenu
>Lire</guimenu
>. Je vous conseille de l'utiliser autant que possible tout particulièrement si vous faites d'autres choses comme utiliser le compresseur ou d'autres effets. Voyez <xref linkend="internals"/> pour plus de détails sur les connexions.</para>

<caution>
<para
>Assurez-vous de ne pas construire une boucle à contre réaction en enregistrant depuis <emphasis
>out_soundcard</emphasis
> et en activant la <quote
>lecture simultanée</quote
>. Une telle boucle est beaucoup trop pour ce pauvre &arts;, et elle ralentira votre système. Vous devrez probablement tuer &arts;...</para>
</caution>

</sect2>

<sect2 id="using-compressor">
<title
>Utilisation du compresseur</title>

<para
>Si vous enregistrez avec un microphone, vous avez peut-être remarqué que le niveau est parfois écrété, et parfois très bas, tout spécialement lorsque l'on enregistre la voix. Pour corriger ceci, vous pouvez utiliser le compresseur. Il réduit simplement tous les sons qui sont au-dessus d'un certain seuil par un certain facteur. Comme ceci réduit le niveau sonore, il y a un potentiomètre rotatif pour amplifier ou atténuer le son. L'attaque et le relachement vous permettent de contrôler le temps de réponde du compresseur (le temps s'écoulant après que le signal ait passé le seuil) et le temps pendant lequel le compresseur réagit toujours après que le son soit passé en dessous du seuil. </para>
<tip
><para
>Testez-le pendant que vous parlez dans le microphone en activant la <quote
>lecture simultanée</quote
>, et vous entendrez la différence.</para
></tip>
</sect2>

<sect2 id="usage-switching-file">
<title
>Basculer entre plusieurs fichiers</title>

<para
>Puisque vous pouvez ouvrir plusieurs fichier pour enregistrer, vous pouvez aussi basculer entre eux. Ceci peut être fait pas seulement après que vous ayez arrêté l'enregistremenr, mais aussi alors que vous enregistrez. Notez que certains paquets de données peuvent être perdus lorsque vous faites ceci. Le nombre d'informations sonores concernées par ces pertes dépend de la taille de la mémoire tampon audio configuré dans le &centreConfiguration; pour &arts;. Cela ne doit pas être tant que ça, mais si vous lisez les fichiers directement les uns à la suite des autres (par exemple avec <command
>artscat file*.raw</command
>), vous pourrez entendre de petits <quote
>sauts</quote
>.</para>
</sect2>

</sect1>
 
<sect1 id="internals">
<title
>Fonctionnement interne</title>

<para
>Laissez-moi vous parler des connexions du son dans &krec;. </para>
<para
>Il y a des éléments nécessaires pour enregistrer avec &arts; : un synth_AMAN_RECORD, un convertisseur AudioToByteStream et un ByteStreamReceiver. Les deux premiers sont construit à l'intérieur même du serveur &arts;. Le dernier se trouve dans l'application. Ce ne sont que les bases. Si vous voulez écouter les fichiers, vous avez besoin d'un ByteStreamSender dans votre application, et d'un convertisseur ByteStreamToAudio et d'un synth_AMAN_PLAY dans le serveur. </para>
<para
>Et les effets ? Entre les éléments AMAN_RECORD et AutioToByteStream, j'ai relié un StereoEffectStack dans lequel j'ai placé le compresseur  (synth_STEREO_COMPRESSOR) et un contrôleur de volume (StereoVolumeControl). </para>
<para
>Si vous activez la <quote
>lecture simultanée</quote
>, la pile d'effets sera également connectée avec l'élément AMAN_PLAY. Donc tout se passe dans le serveur &arts;... </para>
</sect1>

</chapter>

<chapter id="commands">
<title
>référence des commandes</title>

<sect1 id="krec-mainwindow">
<title
>La fenêtre principale de &krec;</title>

<sect2>
<title
>Le menu <guimenu
>Fichier</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Nouveau fichier</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Crée un nouveau fichier simple afin d'enregistrer dedans</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Nouvelle session</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Crée une nouvelle session pour des enregistrements multiples</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fichier</guimenu
> <guimenuitem
>Quitter</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Quitte</action
> &krec;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title
>Le menu <guimenu
>Lire</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Lire</guimenu
> <guimenuitem
>Lire</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lit le fichier sélectionné.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Lire</guimenu
> <guimenuitem
>Enregistrer</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Débute l'enregistremenr dans le fichier sélectionné.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Lire</guimenu
> <guimenuitem
>Arrêter</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Arrête l'enregistrement</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Lire</guimenu
> <guimenuitem
>Lecture simultanée</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Connecte l'entrée avec la sortie pour que vous puissiez entendre ce que vous enregistrez</action
> (&krec;::In et &krec;::Out dans le gestionnaire autio de &arts;-Control)</para>
<caution
><para
>N'utilisez jamais ceci lorsque vous enregistrez ce que vous entendez (depuis out_soundcard). Ceci créerait une boucle que &arts; est incapable de gérer (il ne le fait pas car &arts; est plus rapide que la boucle de votre machine vers le microphone).</para
></caution>
</listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
>Le menu <guimenu
>Configuration</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Afficher la fenêtre de démarrage</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche ou non la fenêtre de démarrage contenant un didacticiel rapide.</action
></para
></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
>Le menu <guimenu
>Aide</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="startupwindow">
<title
>La fenêtre de démarrage</title>

<para
>Cette fenêtre de démarrage ressemble à la boîte de dialogue de &ktip;. </para>
</sect1>

</chapter>

<chapter id="faq">
<title
>Questions et réponses</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>J'ai enregistré des fichiers avec &krec;, mais je ne peux pas les relire avec mon lecteur favori</para>
</question>
<answer>
<para
>&krec; n'enregistre pour l'instant que dans des fichiers raw qui ne sont pas de vrais fichiers wav. Pour les convertir, vous pouvez utiliser par exemple sox.</para>
<example id="converting-with-sox">
<title
>Conversion des fichiers raw en véritables fichiers wav avec sox</title>
<para
>Pour convertir un fichier raw enregistré avec &krec;, utilisez la ligne de commande suivante dans une console (&konsole;), en supposant que <command
>sox</command
> est installé. Dans l'exemple, le fichier est appelé test.raw et nous souhaitons le convertir en test.wav. Utilisez vos propres noms de fichiers pour cela. </para>
<para
><screen
><prompt
>&percnt;</prompt
><command
>sox -r 44100 -c 2 -s -w test.raw 
test.wav</command
>
</screen
></para>
<para
>Les options <option
>-r 44100 -c 2 -s -w</option
> indiquent à <command
>sox</command
> que vous avez enregistré à la fréquence de 44100 kHz, sur deux cannaux (stéréo), encodé en signé linéaire et sur 16 bits. Vous serez peut-être amené à utiliser d'autres options - regardez la page de manuel de <command
>sox</command
>. </para>
</example>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">
<title
>Remerciements et licence</title>

<para
>&krec; </para>
<para
>Programme copyright 2002 Arnold Krille<email
>arnold@arnoldarts.de</email
> </para>


<para
>Documentation copyright 2002 Arnold Krille <email
>arnold@arnoldarts.de</email
> </para>

<para
>Traduction française par &LudovicGrossard;</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="getting-krec">
<title
>Comment obtenir &krec; ?</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Prérequis</title>

<para
>Pour utilisez &krec;, vous avez besoin de &kde; 3.1. </para>

<para
>&krec; devrait se trouver dans votre paquetage kdemultimedia. Étant donné que ce paquetage nécessite &kde; et &arts;, tout devrait bien se passer. </para>


</sect1>

<sect1 id="compilation">
<title
>Compilation et installation</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
End:
-->
