<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.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 % German "INCLUDE"
> <!-- change language only here -->
 <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>
<title
>Das &arts;-Handbuch</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>

<othercredit role="translator"
><firstname
>Frank</firstname
><surname
>Schütte</surname
><affiliation
><address
><email
>F.Schuette@t-online.de</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> 
</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
>Dieses Handbuch beschreibt &arts;, den analogen Echtzeit-Synthesizer.</para>

</abstract>

<keywordset>
<keyword
>aRts</keyword>
<keyword
>artsbuilder</keyword>
<keyword
>Synthesizer</keyword>
<keyword
>Multimedia</keyword>
<keyword
>Struktur</keyword>
<keyword
>Musik</keyword>
<keyword
>Klänge</keyword>
<keyword
>KDE</keyword>
</keywordset>
</bookinfo>

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

<sect1 id="what-is-arts">
<title
>Was ist &arts;?</title>

<para
>Der analoge Echtzeit-Synthesizer (&arts;) ist ein modulares System zur Synthetisierung von Klängen und Musik auf einem Computer. Mit Hilfe von kleinen Bausteinen namens Modulen kann der Benutzer leicht komplexe Audio-Werkzeuge zusammenstellen. Module stellen typische Funktionen wie Hüllkurvengeneratoren, Filter, Audioeffekte, Mixer und Wiedergabe digitaler Klänge in verschiedenen Dateiformaten zur Verfügung.</para>

<para
>Der &artsd; Soundserver mixt Klänge aus unterschiedlichen Quellen in Echtzeit. Damit können sich verschiedene Anwendungen transparent die zur Verfügung stehende Hardware teilen.</para>

<para
>Durch Verwendung von &MCOP;, dem Multimedia-Kommunikationsprotokoll, können Multimediaprogramme netzwerktransparent (aus Sicherheitsgründen mit Authentifizierung) und plattformübergreifend durch die Verwendung von Schnittstellen programmiert werden, die sprachunabhängig mit Hilfe von &IDL; festgelegt werden können. Es gibt auch eine Unterstützung für sonstige und älter Anwendungen, die nicht &arts; verwenden. &arts; stellt einen Kernbestandteil der &kde; 2-Umgebung dar und ist die Basis der &kde;-Multimedia-Architektur. &arts; wird zukünftig noch weitere Medien unterstützen, unter anderem Video. Wie auch &kde;, kann &arts; auf einigen Betriebssystemen, einschließlich &Linux; und BSD-Varianten eingesetzt werden. &arts; kann auch unabhängig von &kde; verwendet werden.</para>

</sect1>

<sect1 id="using-this-manual">
<title
>Verwendung dieses Dokuments</title>

<para
>Dieses Dokument ist eine umfassende Dokumentation für Benutzer unterschiedlicher Vorkenntnisse für &arts;. Falls Sie ein gelegentlicher Nutzer von Multimediaprogrammen sind, sollten Sie einen anderen Weg durch dieses Dokument wählen als ein Entwickler von &arts;-Anwendungen.</para>

<para
>Sie sollten zuerst den Abschnitt <link linkend="installation"
>Herunterladen und Kompilieren von &arts;</link
> lesen, falls Sie &arts; installieren möchten. Sollten Sie bereits ein funktionierendes System haben (häufig als Teil ihrer Distribution) können Sie diesen Abschnitt überspringen.</para>

<para
>Als nächstes sollten Sie die Abschnitte unter <link linkend="arts-tools"
>&arts;-Werkzeuge</link
>, besonders &artsd;, &artscontrol;, &artsshell; und &artsdsp; lesen. Diese Abschnitte helfen Ihnen bei der optimalen Nutzung von &arts;.</para>

<para
>Wenn Sie weitergehende Arbeiten mit &arts; planen, lesen Sie das Kapitel über <link linkend="artsbuilder"
>&arts-builder;</link
> und überfliegen Sie die Schritt-für-Schritt-Einführung. Das sollte Ihnen einen Eindruck der großen Möglichkeiten von &arts; und den ohne Programmierung nutzbaren Modulen geben.</para>

<para
>Wenn Sie mehr über die internen Details von &arts; wissen möchten, weil Sie Multimedia-Anwendungen programmieren oder &arts; erweitern wollen, lesen Sie einiges oder alles aus dem Kapitel <link linkend="arts-in-detail"
>&arts; Details</link
>. Das sollte Ihnen ein Verständnis der Konzepte von &arts; ermöglichen, die für eine erfolgreiche Programmentwicklung notwendig sind.</para>

<para
>Wenn Sie besonders an den <acronym
>MIDI</acronym
>-Fähigkeiten von &arts; interessiert sind, sollten Sie das Kapitel <link linkend="midi"
>&MIDI;</link
> lesen.</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
>Falls Sie planen &arts;-kompatible Multimedia-Anwendungen zu programmieren, lesen Sie das Kapitel <link linkend="arts-apis"
>&arts; Anwendungsprogramm-Schnittstellen</link
>, das die verschiedenen <acronym
>APIs</acronym
>detailiert beschreibt.</para>

<para
>Wenn Sie &arts; durch neue Module erweitern wollen, lesen Sie das Kapitel <link linkend="arts-modules"
>&arts;-Module</link
>.</para>

<para
>Falls Sie eine Anwendung ändern wollen, sodass Sie mit &arts; zusammenarbeitet, lesen Sie das Kapiteln <link linkend="porting"
>Anwendungen für &arts; portieren</link
>.</para>

<para
>Wie Sie Beiträge zu &arts; leisten können, erfahren Sie im Kapitel <link linkend="contributing"
>Zu &arts; beitragen</link
>. Die zukünftige Planung für &arts; erfahren Sie im Kapitel <link linkend="future-work"
>Zukünftige Arbeiten</link
>. Dort finden Sie auch Verknüpfungen zu weiteren <link linkend="references"
>Informationen</link
>.</para>

<para
>Wir haben das Hanbuch mit einigem Zusatzmaterial abgerundet: Das sind im Einzelnen <link linkend="faq"
>Antworten auf häufig gestellte Fragen</link
>, eine <link linkend="contributors"
>Liste der Mitarbeiter</link
>, detailierte Informationen zu <link linkend="copyright-and-licenses"
>Copyright und Lizenz</link
> von &arts; und einige Hintergrundinformationen zu <link linkend="intro-digital-audio"
>digitalem Audio</link
> und <link linkend="midi-introduction"
>&MIDI;</link
>. Weiterhin ist ein <link linkend="glossary"
>Glossar</link
> der verwendeten Begriffe enthalten.</para>

<note>
<para
>Dieses Handbuch ist noch keineswegs vollständig. Falls Sie Teile hinzufügen möchten, sind Sie sehr willkommen. Kontaktieren Sie in diesem Fall zuerstt Jeff Tranter <email
>tranter@kde.org</email
> oder Stefan Westerfeld <email
>stefan@space.twc.de</email
>, um Dopplungen zu vermeiden. </para>
</note>

</sect1>

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

<para
>Spät im Jahre 1997 begann Stefan Westerfeld mit der Arbeit an einem modularen Echtzeit-System zur Klang-Synthese. Das Programm war ursprünglich für einen Power-PC unter &AIX; bestimmt. Die erste Version war einfach, unterstützte aber ein vollständiges Flusssystem, das solche Aufgaben wie die Wiedergabe einer MP3-Datei oder das Durchleiten eines Audio-Datenstroms durch Effektmodule durchführen konnte. </para>


<para
>Der nächste Schritt war die Implementation eines &GUI;, so dass die Modules grafisch bearbeitet werden konnten. Stefan hatte einige Erfahrung mit &kde; und diese Umgebung wurde daher als &GUI;-System (in dem Bewußtsein, das eine GNOME/Gtk+-Version ebenfalls erforderlich sein könnte) benutzt. Später führte das dazu, das &Linux; die Hauptentwicklungsplattform wurde. Vom ursprünglichen Namen <application
>ksynth</application
> wurde das Projekt in &arts; umbenannt und die Entwicklungsgeschwindigkeit nahm zu. Das Projekt war zu dieser Zeit mit einem <acronym
>CORBA</acronym
>-basierten Protokoll, dutzenden von Modulen, einem grafischen Moduleditor, C- und C++-<acronym
>API</acronym
>-Dokumentation, Hilfsprogrammen und einer Mailingsliste und Internetseite mit einer kleinen Entwicklergruppe bereits recht vollständig. Diese ganze Entwicklung fand in der sehr kurzen Zeit von nur einem Jahr statt.</para>

<para
>Bei der Planung von &kde; 2.0 wurde es dem &kde;-Team klar, das &kde; eine bessere Klanginfrastruktur und Unterstützung für Klänge und andere Stream-Medien benötigte. Man entschied sich, &arts; für diese Zwecke anzupassen, da bereits eine fundierte Architektur vorhanden war. Es wurde große Mühe in eine neue Version von &arts; investiert, die umfangreichtse Entwicklung war die Ersetzung des <acronym
>CORBA</acronym
>-Protokolls durch ein völlig neues Subsystem mit dem Namen &MCOP;, das für Multimedia optimiert ist. Die Version 0.4 von &arts; wurde Bestandteil der Version 2.0 von &kde;.</para>

<para
>Die Arbeit an &arts; geht weiter. Die Arbeitsgeschwindigkeit wird verbessert und neue Funktionen werden hinzugefügt. Obwohl &arts; ein Kernbestandteil von &kde; ist, kann es auch ohne &kde; verwendet werden. Es findet auch Verwendung in Anwendungen, die über das traditionelle Multimedia hinausgehen. Das Projekt hat auch beim GNOME-Team einiges Interesse hervorgerufen, so dass die Möglichkeit besteht, das es eines Tages die Standard-Multimedia-Architektur für &UNIX;-Arbeitsplatzrechner wird.</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
>&arts; Copyright und Lizensierung</title>

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

<para
><anchor id="contributors"/> Dokumentation Copyright 1999-2001 Stefan Westerfeld <email
>stefan@space.twc.de</email
> und Jeff Tranter <email
>tranter@kde.org</email
>. </para>
<para
>Übersetzung: Frank Schütte <email
>F.Schuette@t-online.de</email
></para
> 
&underFDL; <para
>Alle Bibliotheken in &arts; stehen unter der <acronym
>GNU</acronym
> Lesser General Public Lizenz. Die überwiegende Menge des &arts;-Programms befindet sich in den Bibliotheken, einschließlich des gesamten <acronym
>MCOP</acronym
> und ArtsFlow. Damit können die Bibliotheken auch für nicht-freie/nicht-offene Anwendungen verwendet werden, falls gewünscht. </para>

<para
>Es gibt einige Programme (wie <application
>artsd</application
>), die unter der <acronym
>GNU</acronym
> General Public Lizenz stehen. Da es unterschiedliche Einstellungen dazu gibt, ob es erlaubt ist, <acronym
>GPL</acronym
>-Anwendungen mit &Qt; zu linken, habe ich dieses explizit erlaubt, also zusätzlich zur <acronym
>GPL</acronym
>: Es ist auch erlaubt, dieses Programm mit der &Qt;-Bibliothek zu linken; dabei wird &Qt; wie eine Bibliothek benutzt, die normalerweise zu einem Betriebssystem dazugehört, ob das im Einzelfall so ist oder nicht (hier noch der Originaltext: "permission is also granted to link this program with the Qt library, treating Qt like a library that normally accompanies the operating system kernel, whether or not that is in fact the case.")</para>

</chapter>

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

<para
>Um &arts; benutzen zu können, müssen Sie es zuerst installieren und starten. Dazu gibt es zwei Möglichkeiten, die in den nächsten beiden Abschnitten beschrieben werden. </para>

<sect1 id="binary-install">
<title
>Ein vorkompiliertes Binärpaket installieren</title>

<para
>Der schnellste und einfachste Weg, um &arts; auf Ihrem System zu installieren ist ein vorkompiliertes Binärpaket. Aktuelle Versionen von &Linux;-Distributionen beinhalten &kde;, und wenn es sich um &kde; 2.0 oder später handelt, enthalten Sie &arts;. Wenn &kde; nicht in Ihrer Distribution enthalten ist, können Sie sie vielleicht von Ihrem Händler herunterladen. Alternativ sind manche Binärpakete auch von dritter Seite erhältlich. Achten Sie darauf, das die verwendeten Pakete kompatibel mit Ihrer Betriebssystemversion sind. </para>

<para
>Eine grundlegende Installation von &kde; enthält den Soundserver, damit die meisten Anwendungen Klänge abspielen können. Wenn Sie das gesamte Paket der Multimedia-Werkzeuge und -Anwendungen haben wollen, müssen Sie vermutlich noch einige optionale Pakete installieren. </para>

<para
>Der Nachteil an vorkompilierten Binärpaketen ist, das sie vermutlich nicht die aktuellste Version von &arts; enthalten. Das ist noch wahrscheinlicher, wenn Sie auf &CD-ROM; bereitstehen, da die Entwicklungsgeschwindigkeit von &arts; und &kde; so groß ist, das Medien wie die &CD-ROM; in der Regel nicht mithalten können. Sie werden auch feststellen, das, wenn Sie eine ungebräuchliche Distribution oder eine ungewöhnliche Konfiguration haben, Binärpakete nicht verfügbar sind. In solchen Fällen sind Sie auf die zweite Methode angewiesen. </para>

</sect1>

<sect1 id="source-install">
<title
>Erstellen aus den Quelltexten</title>

<para
>Der zeitaufwendigste aber flexibelste Weg ist, &arts; aus den Quelltexten selbst zu kompilieren. Das sichert, dass die kompilierte Version optimal für Ihre Systemeinrichtung geeignet ist und erlaubt Ihnen, die jeweils aktuelle Version zu verwenden. </para>

<para
>Sie haben zwei Möglichkeiten -- entweder Sie installieren die letzte stabile Version, die zu &kde; gehört, oder Sie nehmen die aktuellste (aber vielleicht instabile) Version direkt aus dem <acronym
>CVS</acronym
>-Repository des &kde;-Projektes. Die meisten Benutzer, die nicht für &arts; entwickeln, sollten die stabile Version verwenden. Sie können sie von <ulink url="ftp://ftp.kde.org"
>ftp://ftp.kde.org</ulink
> oder von einem der vielen Mirrors herunterladen. Wenn Sie für &arts; entwickeln, sollten Sie die <acronym
>CVS</acronym
>-Version verwenden. Wenn Sie aRts ohne KDE verwenden wollen, können Sie einen selbstständigen Entwicklugsschnappschuß (Snapshot) von <ulink url="http://space.twc.de/~stefan/kde/arts-snapshot-doc.html"
> http://space.twc.de/~stefan/kde/arts-snapshot-doc.html</ulink
> herunterladen. </para>

<para
>Weiterhin gilt, wenn Sie aus dem <acronym
>CVS</acronym
> kompilieren, es befinden sich einige Komponenten von &arts; (&dh; die grundlegenden Komponenten einschließlich des Soundservers) in dem <acronym
>CVS</acronym
>-Modul kdelibs, während weitere Komponenten (&zb; <application
>artsbuilder</application
>) sich im Modul kdemultimedia befinden. Das kann sich in Zukunft ändern. Im Modul kmusic finden Sie ebenfalls ein Version; es handelt sich dabei um die alte (vor-&kde; 2.0) Version, die jetzt überholt ist. </para>

<para
>Die Vorbedingungen für die Kompilierung von &arts; sind die gleichen wie für den Rest von &kde;. Die configure-Skripte sollten Ihr Sytem identifizieren und anzeigen, falls benötigte Komponenten fehlen. Vergewissern Sie sich, das Ihr Sound-Treiber funktioniert (entweder der <acronym
>OSS</acronym
>/Free Kerneltreiber, der <acronym
>OSS</acronym
>-Treiber von 4Front Technologies oder der <acronym
>ALSA</acronym
>-Treiber mit <acronym
>OSS</acronym
>-Emulation). </para>

<para
>Weitere Informationen zum Herunterladen und installieren von &kde; (einschließlich &arts;) finden Sie in der <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:
-->
