<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&arts;" >
 <!ENTITY tools SYSTEM "tools.docbook">
 <!ENTITY artsbuilder-doc SYSTEM "artsbuilder.docbook"
> 
 <!ENTITY detail SYSTEM "detail.docbook">
 <!ENTITY arts-midi SYSTEM "midi.docbook">
 <!ENTITY gui SYSTEM "gui.docbook">
 <!ENTITY mcop-ref SYSTEM "mcop.docbook">
 <!ENTITY arts-mcop SYSTEM "mcop.docbook">
 <!ENTITY apis SYSTEM "apis.docbook">
 <!ENTITY modules SYSTEM "modules.docbook">
 <!ENTITY porting SYSTEM "porting.docbook">
 <!ENTITY helping SYSTEM "helping.docbook">
 <!ENTITY future SYSTEM "future.docbook">
 <!ENTITY references SYSTEM "references.docbook">
 <!ENTITY arts-faq SYSTEM "faq.docbook">
 <!ENTITY arts-glossary SYSTEM "glossary.docbook">
 <!ENTITY digitalaudio SYSTEM "digitalaudio.docbook">
 <!ENTITY midiintro SYSTEM "midiintro.docbook">
 <!ENTITY MCOP "<acronym
>MCOP</acronym
>">
 <!ENTITY DCOP "<acronym
>DCOP</acronym
>">
 <!ENTITY MIDI "<acronym
>MIDI</acronym
>">
 <!ENTITY mcopidl "<application
>mcopidl</application
>">
 <!ENTITY IDL "<acronym
>IDL</acronym
>">
 <!ENTITY % French "INCLUDE" 
> <!-- change language only here -->
 <!ENTITY % addindex "IGNORE">
]>

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

<author
> <firstname
>Stefan</firstname
> <surname
>Westerfeld</surname
> <affiliation
> <address
><email
>stefan@space.twc.de</email
></address
> </affiliation
> </author>

<author
> <firstname
>Jeff</firstname
> <surname
>Tranter</surname
> <affiliation
> <address
><email
>tranter@kde.org</email
></address
> </affiliation
> </author>

&traducteurLudovicGrossard;
</authorgroup>

<copyright>
<year
>1999-2001</year>
<holder
>Stefan Westerfeld &amp; Jeff Tranter</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2001-06-10</date>
<releaseinfo
>1.00.09</releaseinfo>

<abstract
><para
>Ce manuel décrit &arts;, le synthétiseur analogique en temps-réel.</para>

</abstract>

<keywordset>
<keyword
>aRts</keyword>
<keyword
>artsbuilder</keyword>
<keyword
>synthétiseur</keyword>
<keyword
>multimédia</keyword>
<keyword
>structure</keyword>
<keyword
>musique</keyword>
<keyword
>son</keyword>
<keyword
>KDE</keyword>
</keywordset>
</bookinfo>

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

<sect1 id="what-is-arts">
<title
>Qu'est-ce que &arts;&nbsp;?</title>

<para
>Le Synthétiseur Analogique en Temps-réel (Analog Real-Time Synthesizer), ou &arts;, est un système modulaire de synthèse sonore sur ordinateur. À l'aide de petits blocs appelés modules, l'utilisateur peut construire facilement des outils de traitement audio évolués. Les modules fournissent des fonctions telles que la génération de formes d'onde, des filtres, des effets, des mixeurs, et des lecteurs audio dans différents formats de fichiers.</para>

<para
>Le serveur sonore &artsd; mixe le son provenant de différentes sources en temps réel, permettant ainsi à plusieurs applications sonores de partager de manière transparente l'accès au matériel multimédia.</para>

<para
>En utilisant &MCOP; le protocole de communication multimédia (Multimedia Communication Protocol), les applications sont transparentes vis-à-vis du réseau, authentifiées au niveau sécurité, et multi-plates-formes grâce à des interfaces définies de manière indépendante du langage avec &IDL;. La compatibilité est aussi fournie pour les applications non basées sur &arts;. En tant que composant de base de l'environnement de bureau &kde;&nbsp;2, &arts; fournit les bases de l'architecture multimédia de &kde;, et gérera dans le futur plus de types de supports y compris la vidéo. Tout comme &kde;, &arts; fonctionne sur plusieurs systèmes d'exploitation, comme &Linux; ou les différents BSD. Il peut aussi être utilisé indépendamment de &kde;</para>

</sect1>

<sect1 id="using-this-manual">
<title
>Utiliser ce Manuel</title>

<para
>Ce manuel a été écrit de façon à fournir une documentation de &arts; utilisable quel que soit votre niveau. Si vous êtes utilisateur occasionnel d'applications multimédia qui font usage de &arts;, ou bien un développeur d'applications multimédia, vous emprunterez des chemins différents dans ce manuel.</para>

<para
>Je vous suggère de lire d'abord le chapitre <link linkend="installation"
>Téléchargement et compilation de &arts;</link
> si vous devez installer &arts;. Si vous avez déjà un système qui fonctionne, de préférence livré avec votre distribution, vous pouvez passer cette section.</para>

<para
>Lisez ensuite les sections du chapitre <link linkend="arts-tools"
>outils de &arts;</link
>, tout spécialement &artsd;, &artscontrol;, &artsshell; et &artsdsp;. Ceci va vous aider à tirer le meilleur de &arts;.</para>

<para
>Si vous souhaitez aller plus loin, lisez le chapitre <link linkend="artsbuilder"
>&artsbuilder;</link
> et parcourez son tutoriel. Ça vous donnera une idée des possibilités de &arts; ainsi que les modules fournis qui peuvent être utilisés sans avoir besoin d'être programmeur.</para>

<para
>Si vous voulez en savoir plus sur les entrailles de &arts;, soit pour développer des applications multimédia, ou pour étendre &arts; lui-même, lisez le chapitre <link linkend="arts-in-detail"
>&arts; en détail</link
>. Cela va vous aider à comprendre tous les concepts nécessaires au développement de logiciels avec &arts;.</para>

<para
>Si vous vous intéressez spécifiquement aux capacités de &arts; en ce qui concerne le <acronym
>MIDI</acronym
>, lisez le chapitre <link linkend="midi"
>&MIDI;</link
>.</para>

<!-- TODO
<para
>To learn more about the &arts; graphical elements, either as an advanced
user of artsbuilder or to create new elements, read the section on <link
linkend="gui-elements"
><acronym
>GUI</acronym
> Elements</link
>.</para>
-->

<para
>Si vous voulez développer des applications multimédia compatibles avec &arts;, le chapitre <link linkend="arts-apis"
>Application Programming Interfaces de &arts;</link
> couvre les différentes <acronym
>API</acronym
> en détail.</para>

<para
>Si vous voulez étendre &arts; en créant de nouveaux modules, lisez le chapitre <link linkend="arts-modules"
>Modules de &arts;</link
>.</para>

<para
>Si vous modifiez une application déjà existante pour la faire fonctionner avec &arts;, lisez le chapitre sur le <link linkend="porting"
>Portage des applications vers &arts;</link
>.</para>

<para
>La façon dont vous pourriez aider le projet &arts; se trouve dans le chapitre <link linkend="contributing"
>Contribuer à &arts;</link
>, et les développements à venir de &arts; se trouvent dans le chapitre <link linkend="future-work"
>Travaux à venir</link
>, enfin vous obtiendrez des informations supplémentaires en suivant les liens dans la section <link linkend="references"
>Références</link
>.</para>

<para
>Nous avons aussi enrichi ce manuel d'un certain nombre de choses, comme par exemple les <link linkend="faq"
>réponses aux questions fréquemment posées</link
>, une <link linkend="contributors"
>liste des participants</link
>, les détails sur le <link linkend="copyright-and-licenses"
>copyright et la licence</link
> de &arts;, et des informations sur l'<link linkend="intro-digital-audio"
>audio-numérique</link
> et le <link linkend="midi-introduction"
>&MIDI;</link
>. Un <link linkend="glossary"
>glossaire</link
> a aussi été ajouté.</para>

<note
> <para
> Ce manuel est encore en cours d'écriture. Vous êtes le bienvenu pour contribuer à son écriture, mais si vous souhaitez le faire, contactez d'abord Jeff Tranter <email
>tranter@kde.org</email
> ou Stefan Westerfeld <email
>stefan@space.twc.de</email
> pour éviter de faire le travail en double. </para
> </note>

</sect1>

<sect1 id="history">
<title
>Historique</title>

<para
> À la fin de l'année 1997, Stephan Westerfeld a commencé à travailler sur un système modulaire dédié à la synthèse sonore en temps réel. Le code fonctionnait initialement sur un PowerPC sous &AIX;. Cette première implantation était plutôt simple mais gérait un système de flux de données qui pouvait lire des fichiers mp3 ou bien diriger un flux audio vers des modules d'effet. </para>


<para
>L'étape suivante a consisté à implanter une interface graphique (&GUI;) de façon à manipuler les modules de manière graphique. Stefan connaissait bien &kde; et l'a utilisé comme outil de développement de l'interface graphique (tout en sachant qu'une interface GNOME/Gtk+ était aussi nécessaire), ce qui l'a amené plus tard à utiliser &Linux; comme plate-forme de développement principale. Nommé à l'origine <application
>ksynth</application
>, le projet a été renommé &arts; et le développement s'est accéléré. Le projet à ce niveau était à peu près terminé, avec un protocole de communication basé sur <acronym
>CORBA</acronym
>, une douzaine de modules, un outil d'édition graphique des modules, des <acronym
>API</acronym
> C et C++, de la documentation, des utilitaires, et une liste de discussion avec un petit groupe de développeurs. Le projet a beaucoup avancé après seulement un peu plus d'un an de développement.</para>

<para
>Alors que l'équipe &kde; commençait à planifier &kde; 2.0, il devenait clair que &kde; nécessitait une infrastructure plus puissante pour le son et autres formats multimédia. Il a été décidé d'adapter &arts;, étant bien adapté à cela et possédant une architecture ayant fait ses preuves. De gros efforts de développement ont alors été menés sur cette nouvelle version de &arts;, notamment au niveau du remplacement du code <acronym
>CORBA</acronym
> avec un sous-système entièrement nouveau, &MCOP;, optimisé pour le multimédia. La version 0.4 de &arts; a fait partie de &kde; 2.0.</para>

<para
>Le travail continue sur &arts;, en améliorant les performances et en ajoutant de nouvelles fonctionnalités. Notez que, bien que &arts; soit à présent un composant de base de &kde;, il peut être aussi utilisé sans &kde;, et est aussi utilisé par des applications qui vont au-delà du multimédia traditionnel. Le projet a suscité un intérêt de la part de l'équipe GNOME, ouvrant ainsi la possibilité qu'il devienne un jour l'architecture multimédia standard des environnements de bureau pour &UNIX;.</para>

</sect1>

</chapter>

&tools;
&artsbuilder-doc;
&detail;
&arts-midi;
&gui;
&mcop-ref;
&apis;
&modules;
&porting;
&helping;
&future;
&references;
&arts-faq;

<chapter id="copyright-and-licenses">

<title
>Licence et  Copyright de &arts;</title>

<para
>&arts; software copyright 1998-2001 Stefan Westerfeld<email
>stefan@space.twc.de</email
></para>

<para
><anchor id="contributors" /> Documentation copyright 1999-2001Stefan Westerfeld <email
>stefan@space.twc.de</email
> et Jeff Tranter <email
>tranter@kde.org</email
>. </para>
<para
>Traduction française par &LudovicGrossard;.</para>

&underFDL;

<para
> Toutes les librairies de &arts; sont distribuées selon les termes de la licence<acronym
>GNU</acronym
> Lesser General Public license. La grande majorité du code de &arts;se trouve dans les librairies, incluant <acronym
>MCOP</acronym
> et ArtsFlow en totalité. Ceci permet d'utiliser les librairies pour des applications non libres ou non open source si vous le souhaitez. </para>

<para
>Il y a quelques programmes (comme <application
>artsd</application
>), qui sont distribués selon les termes de la <acronym
>GNU</acronym
> General Public License. Comme il y a eu des discussions sur la légalité de lier des programmes <acronym
>GPL</acronym
> avec &Qt;, j'ai aussi ajouté une notice explicite qui ajoute, en plus de la <acronym
>GPL</acronym
>&nbsp;: permission est accordée de lier ce programme avec les librairies &Qt;, considérant &Qt; comme une librairie qui accompagne normalement le noyau du système d'exploitation, que ce soit le cas ou non en réalité.</para>

</chapter>

<appendix id="installation">
<title
>Installer &arts;</title>

<para
> Pour utiliser &arts;, vous devez évidemment l'installer et l'exécuter sur votre système. Il y a deux façons de faire ceci, qui sont décrites dans les sections suivantes. </para>

<sect1 id="binary-install">
<title
>Installer une distribution de binaires précompilé</title>

<para
> La façon la plus rapide et la plus simple pour disposer d'une version fonctionnelle de &arts; est d'installer les paquetages de binaires pré-compilés pour votre système. Les distributions les plus récentes de &Linux; fournissent &kde;, et s'il s'agit de &kde; 2.0 ou supérieur, elles fournissent également &arts;. Si &kde; n'est pas présent sur le support d'installation, vous pouvez le télécharger depuis le distributeur du système d'exploitation. Autrement, il devrait être aussi rendu disponible par des tiers Assurez-vous que vous utilisez des paquetages compatibles avec la version de votre système d'exploitation. </para>

<para
> Une installation typique de &kde; inclut le serveur sonore, permettant à la plupart des application de jouer des sons. Si vous voulez l'ensemble des outils et applications multimédia, vous devrez installer des paquetages supplémentaires. </para>

<para
> L'inconvénient d'utiliser des binaires pré-compilés est que vous ne disposez probablement pas de la dernière version de &arts;. Ceci est particulièrement vrai s'ils sont fournis sur &CD-ROM;, étant donné que la vitesse de développement de &arts; et &kde; est telle que les supports &CD-ROM; ne peuvent pas suivre. Il est possible aussi que les paquetages de binaires pré-compilés ne soient pas disponibles si vous utilisez une architecture ou un système d'exploitation peu communs. Vous devrez utilisez dans ce cas la seconde méthode d'installation décrite ci-après. </para>

</sect1>

<sect1 id="source-install">
<title
>Installation à partir des sources</title>

<para
> Bien que gourmand en temps de calcul, la façon la plus flexible pour installer &arts; est de le compiler vous-même à partir des sources. Ceci vous assure que vous disposez de la version compilée optimale pour la configuration de votre système et vous permet d'installer les versions les plus récentes. </para>

<para
> Vous avez ici deux possibilités&nbsp;-- vous pouvez soit installer la version stable la plus récente fournie avec &kde;, soit installer la version la plus récente (mais peut-être instable) directement depuis le référentiel <acronym
>CVS</acronym
> du projet &kde;. La plupart des utilisateurs qui ne participent pas au développement de &arts; utilise la version stable. Vous pouvez la télécharger depuis <ulink url="ftp://ftp.kde.org"
>ftp://ftp.kde.org</ulink
> ou l'un de ses sites miroirs. Si vous participez au développement de &arts;, utilisez la version<acronym
>CVS</acronym
>. Si vous souhaitez utiliser aRts dans KDE, vous pouvez télécharger une version de développement autonome à <ulink url="http://space.twc.de/~stefan/kde/arts-snapshot-doc.html"
> http://space.twc.de/~stefan/kde/arts-snapshot-doc.html</ulink
>. </para>

<para
> Notez également que si vous compilez à partir du <acronym
>CVS</acronym
>, certains composants de &arts; (&cad; les composants de bases y compris le serveur sonore) se trouvent dans le module <acronym
>CVS</acronym
> kdelibs, tandis que les composants additionnels (&pex; <application
>artsbuilder</application
>) sont inclus dans le. Ceci changera certainement dans le futur. Vous trouverez aussi une version dans le module kmusic&nbsp;; il s'agit d'une vieille version (pre-&kde; 2.0) qui est maintenant obsolète. </para>

<para
> Les pré-requis pour compiler &arts; sont principalement les mêmes que pour compiler &kde;. Les scripts de configuration devraient détecter la configuration de votre système et indiquer s'il manque certains composants. Assurez-vous que vous disposez d'un pilote sonore en état de fonctionnement (soit le pilote<acronym
>OSS</acronym
>/Free dans le noyau, le pilote <acronym
>OSS</acronym
>de 4Front Technologies, soit le pilote <acronym
>ALSA</acronym
> avec l'émulation<acronym
>OSS</acronym
>). </para>

<para
>Des informations complémentaires sur le téléchargement et l'installation de &kde; (y compris &arts;) peuvent être trouvées dans la <ulink url="http://www.kde.org/documentation/faq/index.html"
>&kde;&FAQ;</ulink
>.</para>

</sect1>

</appendix>

&digitalaudio;
&midiintro;
&arts-glossary;

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
