path: root/tde-i18n-de/docs/tdemultimedia/artsbuilder/tools.docbook

<!-- 
<?xml version="1.0" ?>
<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd">

To validate or process this file as a standalone document, uncomment
this prolog. Be sure to comment it out again when you are done -->

<chapter id="arts-tools">
<title>&artscontrol;</title>

<para>Mit &arts; werden einige Hilfs- und Steuerprogramme ausgeliefert. Sie müssen sich mit diesen Programmen vertraut machen, wenn Sie &arts; effektiv nutzen wollen. Dieser Abschnitt beschreibt jedes dieser Programme und ihre Aufrufparameter. </para>

<sect1 id="kde-control-center">
<title>&kcontrol;</title>

<para>Wenn Sie &arts; unter &kde; einsetzen, stellt &kcc; einige Einstellmöglichkeiten  in dem Abschnitt <guilabel>Klänge</guilabel> bereit. Einige dieser Einstellungen werden von &arts; verwendet. Weiterhin können Sie Klänge mit verschiedenen Systemnachrichten des Fenstermanagers oder von &kde; im Abschnitt <menuchoice><guilabel>Erscheinungsbild</guilabel><guilabel>Systemnachrichten</guilabel></menuchoice> verknüpfen. Das Handbuch zu &kcontrol; gibt genauere Informationen über diese Einstellungen. </para>

</sect1>

<sect1 id="artsd">
<title>&artsd;</title>

<para>Der Zugriff auf die Klangressourcen wird durch &artsd;, den &arts;-Dämon kontrolliert. Das ermöglicht es verschiedenen Anwendungen, gleichzeitig Anfragen an den Soundserver zu senden, der sie dann mixt und zusammen wiedergibt. Ohne einen zentralen Soundserver kann immer nur eine Anwendung zur Zeit die Klangressourcen verwenden. </para>

<para>Zur Verwendung von &arts; darf nur eine Instanz von &artsd; aktiv sein. Sie wird normalerweise beim Start von &kde; gestartet, wenn der zugehörige Eintrag in &kcontrol; im Abschnitt <guilabel>Soundserver</guilabel> aktiviert ist. </para>

<para>Das Programm akzeptiert die folgenden Aufrufparameter:</para>

<!-- LW: FIX THIS -->

<cmdsynopsis><command>artsd</command> <group choice="opt"> <option>-n</option> <option>-p</option> <option>-N</option> <option>-W <replaceable>n</replaceable></option> </group> <group choice="opt"> <option>-a <replaceable>audiomethod</replaceable></option> <option>-r <replaceable>sampling rate</replaceable></option> <option>-b <replaceable>bits</replaceable></option> <option>-d</option> <option>-D <replaceable>devicename</replaceable></option> <option>-F <replaceable>fragments</replaceable></option> <option>-S <replaceable>size</replaceable></option> <option>-s <replaceable>seconds</replaceable></option> <option>-m <replaceable>appName</replaceable></option> </group> <group choice="opt"> <option>-h</option> <option>-A</option> <option>-v</option> <option>-l <replaceable>level</replaceable></option> </group> </cmdsynopsis>

<variablelist><varlistentry>
<term><option>-r <replaceable>Sampling-Rate</replaceable></option></term>
<listitem>
<para>Setzt die zu verwendende Sampling-Rate.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-h</option></term>
<listitem>
<para>Verwendungshinweise anzeigen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-n</option></term>
<listitem>
<para>Netzwerk-Transparenz aktivieren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-p <replaceable>Port</replaceable></option>
</term>
<listitem>
<para>Legt den zu verwendenden <acronym>TCP</acronym>-Port fest (setzt <option>-n</option> voraus).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-u</option></term>
<listitem>
<para>Öffentlich, keine Authentifizierung (unsicher).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-d</option></term>
<listitem>
<para>Volle Duplex-Fähigkeit aktivieren.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-D <replaceable>Gerätename</replaceable></option></term>
<listitem>
<para>Audiogerät festlegen (normalerweise <filename>/dev/dsp</filename>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-F <replaceable>Fragmente</replaceable></option></term>
<listitem>
<para>Anzahl der Fragmente festlegen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-S <replaceable>Größe</replaceable></option></term>
<listitem>
<para>Legt die Fragmentgröße in Byte fest.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-s <replaceable>Sekunden</replaceable></option></term>
<listitem>
<para>Legt die Zeit bis zum automatischen Aussetzen in Sekunden fest. Der Wert Null deaktiviert das automatische Aussetzen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-m <replaceable>appName</replaceable></option></term>
<listitem>
<para>Gibt den Namen der Anwendung an, die für die Ausgabe von Fehler- , Warn- und Informationsmeldungen verwendet wird. Wenn Sie KDE verwenden, können Sie das Hilfsprogramm <application>artsmessage</application> verwenden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-N</option></term>
<listitem>
<para>Erhöht die Größe der Netzwerkpuffer auf einen Wert, der für ein 10 mbps LAN erforderlich ist. Diese Einstellung ist äquivalent zur Option -w 5 (weiter unten). </para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-w <replaceable>n</replaceable></option></term>
<listitem>
<para>Wenn Sie &artsd; über eine Netzwerkverbindung zu einem anderen Rechner betreiben, sollten Sie die Puffer vergrößern, um Aussetzer zu vermeiden. &arts; stellt Anwendungen eine Standardpuffergröße bereit. Ohne diese Option basiert die Größe auf Abschnittgröße * Abschnittanzahl. Durch diese Option können Sie diese Größe vom Standardwert um einen Faktor von <replaceable>n</replaceable> erhöhen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-l <replaceable>Ebene</replaceable></option></term>
<listitem>
<para>Legt die Informationsebene fest - 3 (keine), 2 (Warnungen), 2 (Informationen), 0 (Debug).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-v</option></term>
<listitem>
<para>Versionsnummer anzeigen.</para>
</listitem>
</varlistentry>

</variablelist>

<para>In den meisten Fällen reicht das Kommando &artsd; zum Start. </para>
</sect1>

<sect1 id="artswrapper">
<title>&artswrapper;</title>

<para>Für ein gutes Echtzeit-Antwortverhalten, sollte &artsd; normalerweise als Echtzeit-Prozess (auf Systemen, die solche Prozesse unterstützen) gestartet werden. Das erfordert root-Rechte, daher kann &artsd; aus Sicherheitsgründen durch ein kleines Startprogramm namens <application>artswrapper</application> gestartet werden, das Echtzeitpriorität setzt (es arbeitet als <systemitem class="username">root</systemitem>) und dann <command>artsd</command>  als Nicht-root startet. </para>

<para>Falls man artswrapper als SUID <systemitem class="username">root</systemitem> ausführt, wird die Qualität der Wiedergabe aufgrund weniger Unterbrechungen der Musik erhöht. Allerdings erhöht sich dadurch auch das Risiko einer Beschädigung des Rechners durch einen Fehler oder einen böswilligen Benutzer. Außerdem kann die Wiedergabe einer hochwertigen Musikaufnahme in einem Mehr-Benutzersystem negative Auswirkungen auf die Geschwindigkeit anderer Prozesse und Benutzer haben, die <quote>produktiv</quote> arbeiten wollen.</para>

</sect1>

<sect1 id="artsshell">
<title>&artsshell;</title>

<para>Der Befehl &artsshell; ist ein Hilfsprogramm, das verschiedene Funktionen im Zusammenhang mit dem Soundserver ausführt. Das Programm wird in der Zukunft vermutlich mit weiteren Funktionen ausgestattet (einen Überblick geben die Kommentare im Quelltext). </para>

<para>Die Befehlszeile zum Start hat das folgende Format: </para>

<!-- LW: FIX THIS -->

<cmdsynopsis><command>artsshell</command> <group> <arg>suspend</arg><arg>status</arg> <arg>terminate</arg> <arg>autosuspend <replaceable>secs</replaceable></arg> <arg>networkbuffers <replaceable>n</replaceable></arg> <arg>volume [<replaceable>volume</replaceable>]</arg> <arg>stereoeffect <replaceable>options</replaceable></arg> </group> <group> <option>-h</option> <option>-q</option> </group> </cmdsynopsis>

<para>artsshell [options] <replaceable>Befehl</replaceable> [<replaceable>Befehlsoptionen</replaceable>] </para>

<para>Folgende Optionen werden unterstützt: </para>

<variablelist>

<varlistentry>
<term><option>-q</option></term>
<listitem>
<para>Ausgabe unterdrücken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-h</option></term>
<listitem>
<para>Verwendungshinweise anzeigen.</para>
</listitem>
</varlistentry>

</variablelist>

<para>Folgende Befehle werden unterstützt:</para>

<variablelist>

<varlistentry>
<term><option>suspend</option></term>
<listitem>
<para>Der Soundserver schaltet sich aus. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>status</option></term>
<listitem>
<para>Statusinformationen des Soundservers anzeigen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>terminate</option></term>
<listitem>
<para>Den Soundserver beenden. Das kann Programme, die den Soundserver verwenden, zum Absturz bringen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>autosuspend</option> <parameter>Sekunden</parameter></term>
<listitem>
<para>Setzt die Zeit bis zum Aussetzen auf die angegebene Anzahl von Sekunden. Der Soundserver setzt automatisch aus, wenn er die angegebene Zeit unbeschäftigt ist. Der Wert Null deaktiviert das automatische Aussetzen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>networkbuffers</option> <parameter>n</parameter></term>
<listitem>
<para>Setzt die Größe der Netzwerkpuffer auf das <parameter>n</parameter>-fache der Standardgröße. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>volume</option> [<replaceable>Lautstärke</replaceable>]</term>
<listitem>
<para>Legt die Lautstärkeskalierung für die Soundserver Audioausgabe fest. Das Argument <replaceable>Lautstärke</replaceable> ist eine Kommazahl. Bei Aufruf ohne Argument wird der aktuelle Wert angezeigt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>Liste der Stereoeffekte</option></term>
<listitem>
<para>Liste aller verfügbaren Stereoeffektmodule</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>stereoeffect insert [top|bottom]</option> <replaceable>Name</replaceable></term>
<listitem>
<para>Fügt einen Stereoeffekt in einen Stereoeffektstapel ein. Gibt einen Namen zurück, der für ein späteres Löschen erforderlich ist. Der Effekt kann oben oder unten (Standardeinstellung) hinzugefügt werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>stereoeffect remove</option> <replaceable>Id</replaceable></term>
<listitem>
<para>Löscht den Stereoeffekt mit dem Namen <replaceable>Id</replaceable> vom Effektstapel.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="artsplay">
<title><application>artsplay</application></title>

<para>Der Befehl <application>artsplay</application> ist ein einfaches Hilfsprogramm zum Abspielen einer Klangdatei. Der Befehl hat ein einziges Argument, nämlich den Namen der an den Soundserver zu schickenden Datei. Die Klangdatei kann zu jedem der üblichen Typen gehören, also <literal role="extension">wav</literal> oder <literal role="extension">au</literal>. Mit diesem Befehl kann man testen, ob der Soundserver funktioniert. Indem man zwei Befehl parallel oder in schneller Folge gibt, kann man demonstrieren, wie der Soundserver mehrere Ausgaben mixen kann.</para>

</sect1>

<sect1 id="artsdsp">
<title><application>artsdsp</application></title>

<para>Der Soundserver unterstützt nur Anwendungen, die &arts;-aktiviert sind. Viele herkömmliche Anwendungen wollen auf die Klanggeräte direkt zugreifen. Das Programm &artsdsp; ist eine Übergangslösung, die es vielen dieser Anwendungen erlaubt, ohne Änderung zu funktionieren. </para>

<para>Wenn ein Programm unter &artsdsp; ausgeführt wird, werden alle Zugriffe auf das Audiogerät <filename class="devicefile">/dev/dsp</filename> abgefangen und in &arts; <acronym>API</acronym>-Aufrufe umgewandelt. Diese Emulation ist nicht perfekt, aber die meisten Anwendungen funktionieren auf diese Weise mit einer kleinen Einbuße an Geschwindigkeit und Antwortverhalten. </para>

<para>Der Befehl &artsdsp; hat das folgende Format: </para>

<!-- LW: FIX THIS -->
<para>artsdsp [<replaceable>Optionen</replaceable>] <replaceable>Anwendung Parameter</replaceable> </para>

<para>Folgende Optionen werden erkannt: </para>

<variablelist>

<varlistentry>
<term><option>-h</option>, <option>--help</option></term>
<listitem>
<para>Zeigt eine kurze Hilfe.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-n</option> <option>--name</option> = <replaceable>Name</replaceable></term>
<listitem>
<para>Verwendet <replaceable>Name</replaceable> um den Spieler gegenüber <command>artsd</command>.zu identifizieren.</para>

</listitem>
</varlistentry>

<varlistentry>
<term><option>-m</option> <option>--mmap</option></term>
<listitem>
<para>Speicher-Mapping emulieren (&zb; für <application>Quake</application>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-v</option> <option>--verbose</option></term>
<listitem>
<para>Zeigt Parameter an.</para>
</listitem>
</varlistentry>

</variablelist>

<para>Ein typischer Aufruf ist: </para>

<para>
<userinput><command>artsdsp</command> <option>-v</option> <option>-m</option> <parameter>realplay <replaceable>Lied.mp3</replaceable></parameter></userinput>
</para>

<para>Einige Anwendungen funktionieren mit der Einstellung <option>--mmap</option> besser. Es werden nicht alle Funktionen des Klanggerätes voll emuliert, aber die meisten Anwendungen sollten funktionieren. Falls eine nicht funktionieren sollte, senden Sie eine detailierte Benachrichtigung ein. So können die Entwickler möglicherweise eine Lösung finden. Bedenken Sie, dass es sich um eine Übergangslösung handelt. Die beste Lösung ist sicherlich, Unterstützung für &arts; zu der Anwendung hinzuzufügen. Wenn Ihre Lieblingsanwendung &arts; nicht unterstützt, bitten Sie die Entwickler diese Unterstützung nachzurüsten. </para>

</sect1>

<sect1 id="artscat">
<title><application>artscat</application></title>

<para>Dieses kleine Hilfsprogramm kann Audion-Rohdaten zum Soundserver schicken. Sie müssen das Datenformat (Samplingrate, Samplegröße und Anzahl der Kanäle) angeben. Es ist ein Programm, das Sie vermutlich nicht oft benötigen, das aber für Testzwecke recht praktisch ist. Die Aufrufsyntax ist: </para>

<!-- LW: FIX THIS -->
 
<para>artscat [ <replaceable>Optionen</replaceable> ] [ <replaceable>Dateiname</replaceable> ] </para>

<para>Wenn Sie keinen Dateinamen angeben, wird von der Standardeingabe gelesen. Folgende Optionen werden unterstützt: </para>

<variablelist>
<varlistentry>
<term><option>-v</option> <parameter>--verbose</parameter></term>
<listitem>
<para>Setzt die zu verwendende Sampling-Rate. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-b</option> <parameter>Bits</parameter></term>
<listitem>
<para>Setzt die Sample-Größe fest (8 oder 16). </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-c</option> <parameter>Kanäle</parameter></term>
<listitem>
<para>Setzt die Anzahl der Kanäle fest (1 oder 2). </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-h</option></term>
<listitem>
<para>Nur Verwendungshinweise anzeigen. </para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="artscontrol">
<title>&artscontrol;</title>

<para>Dies ist ein graphisches Programm für die Durchführung einer Anzahl Aufgaben im Zusammenhang mit dem Soundserver. Das Hauptfenster hat zwei Lautstärkeanzeigen und einen Schieberegler für die Gesamtausgabelautstärke. Aus dem Menü <guimenu>Ansicht</guimenu> können Sie weitere Funktionen auswählen: </para>

<variablelist>

<varlistentry>
<term><guimenuitem>FFT-Anzeige</guimenuitem></term>
<listitem>
<para>Öffnet ein Fenster mit einer Echtzeit-Spektrumanalysator-Anzeige. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Audio-Manager</guimenuitem></term>
<listitem>
<para>Zeigt die aktiven Klangquellen an und erlaubt die Zuordnung zu einem der verfügbaren Busse. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>aRts-Statusanzeige</guimenuitem></term>
<listitem>
<para>Zeigt an, ob der Soundserver läuft und Echtzeitpriorität besitzt. Außerdem wird angezeigt, wann der Soundserver automatisch aussetzt. Durch einen Knopf kann er auch sofort ausgeschaltet werden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Midi-Manager</guimenuitem></term>
<listitem>
<para>Zeigt aktive &MIDI;-Ein- und Ausgabegeräte an und erlaubt die Herstellung von Verknüpfungen [TODO: Funktioniert vermutlich noch nicht! Mehr Details benötigt]. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>FreeVerb</guimenuitem></term>
<listitem>
<para>Verbindet einen FreeVerb-Echoeffekt mit dem Stapel von &arts; Ausgabeeffekten und erlaubt eine graphische Kontrolle der Effektparameter. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Lautstärkeanzeige im LED-Stil</guimenuitem></term>
<listitem>
<para>Ändert die Lautstärkeanzeige des Hauptfensters auf eine farbige <acronym>LED</acronym>-Anzeige anstatt Fortschrittsbalken. </para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="artsc-config">
<title><application>artsc-config</application></title>

<para>Dieses Hilfsprogramm unterstützt Entwickler bei der Verwendung des &arts; C-<acronym>API</acronym>. Es gibt die geeignete Compiler- und Linker-Optionen aus, die zur Kompilierung und zum Linken von Programmen mit &arts; benötigt werden. Es ist gedacht zur Verwendung innerhalb von make-Dateien zur Unterstützung von Portabilität. Das Programm kennt drei Optionen: </para>

<variablelist>
<varlistentry>
<term><option>--cflags</option></term>
<listitem>
<para>Zeigt die Kompiler-Flags an, die zur Kompilierung mit dem &arts; C-<acronym>API</acronym> benötigt werden. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>--libs</option></term>
<listitem>
<para>Zeigt die Linker-Flags an, die zum Linken mit dem &arts; C-<acronym>API</acronym> benötigt werden. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><acronym>--version</acronym></term>
<listitem>
<para>Zeigt die Versionsnummer des <command>artsc-config</command> Befehles an. </para>
</listitem>
</varlistentry>
</variablelist>

<para>Eine typische Ausgabe dieses Befehls sieht folgendermaßen aus:</para>

<screen width="40"><prompt>%</prompt> <userinput><command>artsc-config</command> <option>--cflags</option></userinput>
<computeroutput>-I/usr/local/kde2/include/artsc</computeroutput>
<prompt>%</prompt> <userinput><command>artsc-config</command> <option>--libs</option></userinput>
<computeroutput>-L/usr/local/kde2/lib -ldl -lartsc -DPIC -fPIC -lpthread</computeroutput>
<prompt>%</prompt> <userinput><command>artsc-config</command> <option>--version</option></userinput>
<computeroutput>0.9.5</computeroutput>
</screen>

<para>Sie können dieses Programm in einer Make-Datei z.B. in einer solchen Regel verwenden: </para>

<programlisting>artsc: artsc.c
        gcc `artsc-config --cflags` -o artsc artsc.c `artsc-config --libs`
</programlisting>

</sect1>

<sect1 id="mcopidl">
<title>&mcopidl;</title>

<para>Der Befehl &mcopidl; ist der <acronym>IDL</acronym>-Datei Kompiler für &MCOP;, das Multimedia Communication Protokol, das von &arts; verwendet wird. Interfaces sind in &arts; in &IDL;, einer sprachunabhängigen Interface Definition Language, geschrieben. Das Programm &mcopidl; akzeptiert ein &IDL;-Datei als Eingabe und generiert C++-Header und Quelldateien für eine Klasse, die das Interface implementiert. Der Befehl hat die folgende Syntax: </para>

<!-- LW: FIX THIS -->

<para>mcopidl [ <replaceable>Optionen</replaceable> ] <replaceable>Dateiname</replaceable> </para>

<para>Folgende Optionen sind möglich:</para>
<variablelist>
<varlistentry>
<term><option>-I</option> <parameter>Verzeichnis</parameter></term>
<listitem>
<para>Suche in <parameter>Verzeichnis</parameter> nach Include-Dateien. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-e</option> <parameter>Name</parameter></term>
<listitem>
<para>Schließe die Struktur, das Interface oder den Aufzählungstyp <parameter>Name</parameter> von der Erzeugung aus. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><option>-t</option></term>
<listitem>
<para>Erzeuge zusätzlich die Dateien <literal role="extension">.mcoptype</literal>/ <literal role="extension">.mcopclass</literal>, die Informationen für die &IDL;-Datei enthalten. </para>
</listitem>
</varlistentry>
</variablelist>

<para>Weitere Informationen über &MCOP; und &IDL; finden Sie im Abschnitt <link linkend="interfaces">Interfaces und &IDL;</link>. </para>

</sect1>

</chapter>