<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kappname "&kmidi;">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % German "INCLUDE">
 <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
 %ents; 
]>

<book lang="&language;">
  <bookinfo>
    <title>Das &kmidi;-Handbuch</title>
    <authorgroup>
      <author>
	<firstname>Bernd Johannes</firstname>
	<surname>Wuebben</surname>
	<affiliation>
	  <address><email>wuebben@kde.org</email></address>
	</affiliation>
      </author>
      <author>
	<firstname>Greg</firstname>
	<surname>Lee</surname>
	<affiliation>
	  <address><email>lee@hawaii.edu</email></address>
	</affiliation>
      </author>
      <othercredit role="translator">
	<firstname>Frank</firstname>
	<surname>Sch&uuml;tte</surname>
	<affiliation>
	  <address><email>F.Schuette@t-online.de</email></address>
	</affiliation>
	<contrib>&Uuml;bersetzung</contrib>
      </othercredit>
</authorgroup>

<copyright>
<year>1999</year>
<year>2000</year>
<holder>Greg Lee</holder>
</copyright>

<date>16/12/2000</date>
<releaseinfo>1.03.00</releaseinfo>
<abstract>
<para>&kmidi; kann Midi-Dateien unter Verwendung von Instrumenten-Patches wiedergeben. Was eine Soundkarte
wie die GUS (Gravis UltraSound) oder Sound Blaster AWE in Hardware bewerkstelligen, erledigt &kmidi; in Software.</para>
</abstract>
<keywordset>
<keyword>KMidi</keyword>
<keyword>Midi</keyword>
<keyword>Spieler</keyword>
<keyword>Timidity</keyword>
<keyword>Midi</keyword>
<keyword>zu</keyword>
<keyword>Wav</keyword>
</keywordset>
</bookinfo>

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

<para>&kmidi; kann Midi-Dateien unter Verwendung von Instrumenten-Patches wiedergeben. Was eine Soundkarte wie die GUS (Gravis UltraSound) oder der Sound Blaster AWE in Hardware bewerkstelligen, erledigt &kmidi; in Software. Sie ben&ouml;tigen lediglich eine einfache
Soundkarte mit einem billigen Soundchip. Selbst wenn Sie &uuml;ber eine GUS oder AWE verf&uuml;gen, lohnt sich ein Versuch mit &kmidi;.
Falls Sie der Klang nicht zufrieden stellt, k&ouml;nnen Sie sogar selbst Hand anlegen, da der Quelltext frei verf&uuml;gbar ist.
</para>

<para>&kmidi; ben&ouml;tigt allerdings einen gewissen Anteil an der CPU-Zeit, um seine Aufgabe zu erledigen. Das &Ouml;ffnen von neuen
Fenstern oder manchmal bereits das Rollen eines Fensterinhalts kann Aussetzer in der Musikwiedergabe verursachen. Sie ben&ouml;tigen
zus&auml;tzlich zu &kmidi; einige Patch-S&auml;tze (siehe unten). Sie sind zu gro&szlig; (10-12 MB), um sie in eine KDE-Distribution aufzunehmen, 
daher sind nur 5 Beispiel-Patches beigelegt. &kmidi; kann 257 B&auml;nke mit je 128 Instrumenten verwalten.</para>

<para>&kmidi; basiert auf Tuukka Toivonens wundervollem TiMidity-Programm. Es erledigt die meiste Arbeit. &kmidi ist eine
Benutzeroberfl&auml;che f&uuml;r TiMidity und daher ist TiMidity selbst und andere Benutzeroberfl&auml;chen in der Quelltextdistribution von
&kmidi; enthalten. Vielen Dank an Tuukka!</para>

<para>&kmidi; unterst&uuml;tzt zur Zeit (Version 1.3) die folgenden Plattformen:</para>

<para><itemizedlist>
<listitem>
<para>Linux</para>
</listitem>
<listitem>
<para>FreeBSD</para>
</listitem>
<listitem>
<para>DEC OSF/1</para>
</listitem>
<listitem>
<para>HP UX</para>
</listitem>
<listitem>
<para>SUN</para>
</listitem>
<listitem>
<para>SUN SOLARIS</para>
</listitem>
</itemizedlist>
</para>

<para>Portierungen auf andere Plattformen sollten einfach sein. Kontaktieren Sie
mich bitte, wenn Sie &kmidi; auf ein anderes System portiert haben.</para>

<para>Weitere Informationen zur Benutzung, die nicht in dieser Dokumentation enthalten sind,
finden Sie auf den timidity(1)-Manualseiten (man-pages).</para>

<para>Da Midi-Dateien typischerweise lediglich einen Umfang von 50kB oder weniger haben, 
k&ouml;nnen Sie leicht heruntergeladen werden, so dass es Ihnen niemals
an gro&szlig;artigen MIDI-Dateien zum Abspielen mangeln wird.</para>


<para>Viel Spa&szlig; mit &kmidi;</para>

<para><literal remap="tt">Bernd Johannes Wuebben</literal> <ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></para>
</chapter>

<chapter id="usage">
<title>Benutzung</title>

<sect1 id="getting-started">
<title>Allgemeines zur Benutzung</title>

<para>Beim ersten Start von &kmidi; sehen Sie den Namen einer Beispiel-Mididatei im schwarzen Fenster. Klicken Sie zur
Wiedergabe auf den Knopf <guibutton>Wiedergabe</guibutton>. Bewegen Sie den Mauszeiger von Knopf zu Knopf und Sie erhalten jeweils eine
kurze Beschreibung der jeweiligen Funktion.</para>

<para>Klicken Sie auf das "KMidi"-Logo links oben, um die untere Anzeige einzublenden. Sie zeigt in einem schwarzen Fenster,
der Kanal-Anzeige, ein S&auml;ulendiagramm der Noten, die auf den 16 Midi-Kan&auml;len abgespielt werden. Auf der linken Seite
befindet sich ein Listenfeld zur Auswahl eines Patch-Satzes und zur Musikst&uuml;ckauswahl. Ein Mausklick auf das Liedtextlistenfeld
zeigt eine Liste aller Beispieldateien, die der &kmidi;-Distribution beiliegen. Sie k&ouml;nnen eine zur Wiedergabe ausw&auml;hlen.</para>

<para>Klicken Sie auf den Knopf 
<guibutton>Informationen anzeigen</guibutton>, um Informationen &uuml;ber die aktuelle Mididatei und "Karaoke"-Texte 
(falls die Midi-Datei solche enth&auml;lt)  zu sehen.</para>

      <para>Klicken Sie auf <guilabel>St&uuml;ckliste &ouml;ffnen</guilabel>, um eine St&uuml;ckliste zu &ouml;ffnen. W&auml;hlen Sie im Men&uuml; <guimenu>Bearbeiten</guimenu>
<guimenuitem>St&uuml;ckliste bearbeiten...</guimenuitem>, um in Ihrem System nach Midi-Dateien zu suchen und eine St&uuml;ckliste zusammenzustellen.
Es werden nur Midi-Dateien im Dialog angezeigt (die Dateierweiterungen k&ouml;nnen <literal remap="tt">.mid</literal> oder <literal remap="tt">.kar</literal>
sein). Doppelklicken Sie auf einen Dateinamen, um ihn in die St&uuml;ckliste (auf der rechten Seite) aufzunehmen.</para>

<para>Wundern Sie sich nicht, dass einige Midi-Dateien wenige oder gar keine Kl&auml;nge produzieren. &kmidi; hat standardm&auml;&szlig;ig nur eine geringe Anzahl an
Instrumenten-Patches. Wie Sie weitere Patches erhalten, erfahren Sie im entsprechenden Kapitel dieser Dokumentation.</para>
</sect1>
<sect1 id="Playlists">
<title>St&uuml;cklisten</title>

<para>Klicken Sie auf den Knopf <emphasis remap="bf">St&uuml;ckliste &ouml;ffnen</emphasis>, um den Dialog f&uuml;r St&uuml;cklisten zu
&ouml;ffnen. Auf der linken Seite wird das letzte Verzeichnis angezeigt, in dem Sie die St&uuml;ckliste bearbeitet haben.
Auf der rechten Seite sehen Sie den Inhalt der aktuellen St&uuml;ckliste. Sie k&ouml;nnen eine Midi-Datei zur St&uuml;ckliste
hinzuf&uuml;gen, indem Sie darauf doppelklicken, oder Sie wählen die Datei durch einfaches Klicken aus und w&auml;hlen aus dem
Men&uuml; <guimenu>Bearbeiten</guimenu><guimenuitem>Hinzuf&uuml;gen</guimenuitem>.</para>

<para>In der linken Liste werden nur Midi-Dateien angezeigt. Dabei kann &kmidi; keine komprimierten Midi-Dateien erkennen.
Wenn Sie komprimierte Midi-Dateien (<abbrev>z.B.</abbrev> mit <application>gzip</application> komprimierte Dateien)
verwenden, schalten Sie den Dateifilter durch Klicken auf Filter unten im Dialog aus. Dadurch werden alle Dateien angezeigt.
&kmidi; verwendet &uuml;brigens nicht die Dateinamenserweiterung, um den Dateityp festzustellen, sondern liest
einige Bytes am Anfang der Datei, um festzustellen, dass es sich um eine Midi-Datei handelt. Daher m&uuml;ssen Sie nicht
die Endung <literal remap="tt">.mid</literal> f&uuml;r Ihre Midi-Dateien verwenden.</para>

<para>In der unteren Liste werden die bereits definierten St&uuml;cklisten angezeigt. Anfangs gibt es nur eine einzige Liste mit dem Namen
"default" (Standard). Sie enth&auml;lt die Beispieldateien der &kmidi;-Distribution. Sie k&ouml;nnen den Inhalt dieser St&uuml;ckliste &auml;ndern, indem Sie
diese St&uuml;ckliste ausw&auml;hlen (falls sie noch nicht ausgew&auml;hlt ist) und im Men&uuml; <guimenu>Datei</guimenu> <guimenuitem>Speichern</guimenuitem>
ausw&auml;hlen. Dadurch wird der Inhalt der St&uuml;ckliste durch die aktuell ausgew&auml;hlten Musikst&uuml;cke ersetzt. W&auml;hlen Sie stattdessen
<guimenu>Datei</guimenu> <guimenuitem>Anh&auml;ngen</guimenuitem>, um die St&uuml;cke der St&uuml;ckliste  zur St&uuml;cklistendatei hinzuzuf&uuml;gen.
Sie k&ouml;nnen eine neue St&uuml;cklistendatei erstellen, indem Sie <guimenu>Datei</guimenu> <guimenuitem>Speichern unter...</guimenuitem>
ausw&auml;hlen. Es erscheint ein Dialog zur Eingabe des neuen St&uuml;cklistennamens. Doppelklicken Sie auf den Namen einer St&uuml;ckliste, um
die aktuelle St&uuml;ckliste durch den Inhalt dieser St&uuml;cklistendatei zu ersetzen. Das k&ouml;nnen Sie auch durch Klicken auf
<guibutton>St&uuml;ckliste ausw&auml;hlen</guibutton> und die Auswahl einer St&uuml;ckliste im &kmidi;-Hauptfenster erreichen.</para>

      <para>Um eine St&uuml;ckliste zu entfernen, w&auml;hlen Sie sie durch Klicken auf ihren Namen aus und w&auml;hlen Sie im Men&uuml; <guimenu>Datei</guimenu>
<guimenuitem>L&ouml;schen</guimenuitem> aus.</para>

<para>Die vertikale Trennleiste zwischen den beiden Listen kann durch Ziehen mit der Maus verschoben werden. Ebenso kann die horizontale
Trennleiste oberhalb der St&uuml;cklistennamen verschoben werden.</para>
</sect1>

<sect1 id="midi-filenames">
<title>Midi-Dateinamen</title>

<para>Die angezeigten Midi-Dateinamen im Hauptfenster unterscheiden sich geringf&uuml;gig von
den wirklichen Dateinamen, da &kmidi; zur besseren Lesbarkeit jedes Auftreten eines '_' im Namen durch ein Leerzeichen 
ersetzt und eine eventuelle Endung auf <filename>.mid</filename> oder <filename>.MID</filename> weggelassen wird.</para>
</sect1>
    <sect1 id="configuring">
      <title>Konfiguration</title>
      <para>Klicken Sie auf <guibutton>KMidi konfigurieren</guibutton>, um den Konfigurationsdialog von &kmidi; aufzurufen. Sie k&ouml;nnen
hier die Hintergrundfarbe und die "LED"-Farbe der beiden Anzeigefenster ausw&auml;hlen. Die Farbe f&uuml;r Percussion in der Kanal-Anzeige
ist nicht ver&auml;nderbar -- sie ist fest eingestellt auf gelb.</para>
    </sect1>
    <sect1 id="patchsets">
      <title>Patch-S&auml;tze</title>
      <para>In der unteren Anzeige befindet sich auf der linken Seite oben das Listenfeld <guilabel>Patch-Satz w&auml;hlen</guilabel>.
Standardm&auml;&szlig;ig gibt es hier drei Eintr&auml;ge: <literal remap="tt">piano+guitar</literal>, <literal remap="tt">piano</literal> und
<literal remap="tt">guitar</literal>. Der zweite und dritte Eintrag sind lediglich zur Illustration angegeben. Wenn Sie &uuml;ber einige
Patch-S&auml;tze verf&uuml;gen, k&ouml;nnen Sie sie in diesem Listenfeld ausw&auml;hlen. Dazu m&uuml;ssen Sie &kmidi; entsprechend konfigurieren:</para>

      <para>Erstellen Sie f&uuml;r jeden Patch-Satz eine <filename>.cfg</filename>-Datei, die eine Beschreibung der Patches, die B&auml;nke und
die Instrumentennummern ("Midi-Programmnummern") enth&auml;lt. Danach f&uuml;gen Sie zur Datei <filename>timidity.cfg</filename> eine Zeile
<literal remap="tt">source</literal> &lt;Dateiname&gt; und davor eine Zeile if &lt;n&gt; ein, wobei &lt;Dateiname&gt; der Name
der Beschreibungsdatei ist und &lt;n&gt; die Zeilennummer angibt, in der &lt;Dateiname&gt; im Listenfeld <guilabel>Patch-Satz w&auml;hlen</guilabel>
erscheint. Dort k&ouml;nnen Sie dann auf den Namen klicken, um den Patch-Satz auszuw&auml;hlen. Die Patch-Satznummern beginnen mit 0.</para>

      <para>Die Bänke/Drumsets und die Namen von Patches müssen in den <filename>.cfg</filename>-Dateien immer angegeben werden, da sie sonst nicht 
geladen werden, selbst wenn sie vorhanden sind. So ist es einfach, gewisse Patches von einem Soundfont außen vor zu lassen und bessere aus einem 
nachfolgenden Soundfont zu laden. Geben Sie sie einfach nicht an, bevor Sie den Soundfont geladen haben.</para>

      <para>Falls der Patch in der gleichen Bank oder dem gleichen Drumset mehrfach auftritt, beachtet &kmidi; nur die erste Deklaration. Sie sollten also
ihre besten Soundfonts vorn eintragen.</para>

      <para>Es existiert ein Hilfsprogramm namens <application>sf2cfg</application>, um eine <filename>cfg</filename>-Datei automatisch zu 
erzeugen, die alle Patches enth&auml;lt, die in einem <filename>sbk/sf2</filename>-Soundfont enthalten sind. &kmidi beigelegt sind eine 
<filename>cfg</filename>-Beispieldatei f&uuml;r die Soundfonts <filename>chaos8m.sf2</filename> und <filename>chaos12m.sf2</filename> 
hinzugef&uuml;gt.</para>
    </sect1>
    <sect1 id="polyphony">
      <title>Mehrstimmigkeit (Polyphonie)</title>
      <para>H&ouml;ren Sie Aussetzer? Es ist m&ouml;glich, dass &kmidi; beim Berechnen der Tonh&ouml;he der Instrumenent-Patches, beim Signalfiltern, 
Notenkombinieren <abbrev>u.s.w.</abbrev> nicht schnell genug ist. Sie k&ouml;nnen die Situation eventuell verbessern, indem Sie die Mehrstimmigkeit 
im Drehregler <guilabel>Mehrstimmigkeit einstellen</guilabel> anpassen. Damit wird die maximale Anzahl unterschiedlicher Stimmen begrenzt, die
gleichzeitig wiedergegeben werden. Durch Verringerung der Mehrstimmigkeit wird die Wiedergabe weniger rechenintensiv. Allerdings gehen 
dadurch vielleicht einige Chor- oder Hall-Effekte verloren, oder es werden einige Noten abgeschnitten oder gar v&ouml;llig weggelassen. (In einigen
F&auml;llen generiert &kmidi; zus&auml;tzliche Noten, um die Effekte Midi-Chor oder Hall anzun&auml;hern.)</para>
    </sect1>

    <sect1 id="Effects">
      <title>Effekte</title>

      <para>Effekte haben Auswirkungen auf den Klang, wobei deren Auswirkungen nicht nicht immer ganz klar sind. Effekte k&ouml;nnen auf
vier Arten eingeschaltet und auf zwei Arten gesteuert werden.</para>

      <para>Ein Midi-St&uuml;ck kann Effekte f&uuml;r alle Instrumente auf jedem einzelnen der 16 Midi-Kan&auml;le einstellen. Andererseits k&ouml;nnen mehrere Effekte f&uuml;r mehrere
Kan&auml;le eingeschaltet werden. Klicken Sie auf <guibutton>eff</guibutton> unten rechts im Hauptfenster, um folgende Midi-Effekte anzun&auml;hern:
 Chor, Hall, Celeste und Phaser. Jeder dieser Effekte wird aber nur dann angewandt, wenn er durch das Midi-St&uuml;ck verwendet wird.
F&uuml;r zwei weitere Midi-Standardeffekte, n&auml;mlich Harmonics und Helligkeit (Brightness), sind noch keine Filter implementiert (die anderen Filter
stammen von Nicolas Witczak).</para>

      <para>Ist der Knopf <guibutton>eff</guibutton> nicht gedr&uuml;ckt, werden dennoch eine Art von Chor und Hall auf Anforderung eingesetzt. Diese
werden aber auf eine andere Weise erzeugt. Es werden anstatt Filtern zus&auml;tzliche Noten erzeugt. Sie werden f&uuml;r den Chor-Effekt leicht verstimmt und f&uuml;r
den Hall-Effekt leicht verz&ouml;gert. Au&szlig;erdem wird die H&uuml;llkurve und das Vibrato angepasst. Celeste- und Phaster-Effekte werden in diesem Modus
nicht wiedergegeben.</para>

      <para>Effekte k&ouml;nnen zweitens durch einen Patch eingeschaltet werden. Das bedeutet, dass das Instrument eine bestimmte Chor- und/oder 
Hallst&auml;rke enth&auml;lt . AWE-Patches enthalten in der Regel Effekte, w&auml;hrend Gravis-Forte Patches keine enthalten. (Daher klingen AWE-Patch-S&auml;tze in der Regel
voller.) Auf diese Art angeforderte Effekte werden durch "Geisternoten" implementiert und werden nicht durch den Knopf <guibutton>eff</guibutton>
beeinflusst.</para>

      <para>Drittens k&ouml;nnen Sie selbst Effekte anfordern. Dazu befinden sich rechts unten im Hauptfenster vier Ankreuzfelder. Jedes der Felder kann einen
von drei Zust&auml;nden annehmen: "Normal" (Standardeinstellung), "Extra" und "Aus".  Die mittleren beiden Felder kontrollieren Chor und Hall. Bei
"Normal" werden die Effekte wie oben beschrieben eingesetzt. Werden Sie auf "Extra" geschaltet, werden f&uuml;r alle Instrumente und alle Kan&auml;le extra Noten f&uuml;r
Chor und Hall erzeugt. Das geschieht zus&auml;tzlich zu den Noten, die durch Klicken auf <guibutton>eff</guibutton> angefordert werden. Werden Sie auf
"Aus" geschaltet, werden keine extra Chor- oder Hall-Noten erzeugt.</para>

      <para>Schlie&szlig;lich k&ouml;nnen Effekte durch Midi-Systemnachrichten in einer Midi-Datei angefordert werden -- "sysexes". Sie sind zur Kontrolle der Hardware
spezieller Synthesizer gedacht. &kmidi; enth&auml;lt eine Anzahl Dekoder f&uuml;r Sysexes der RolandGS- und YamahaXG-Synthesizer und versucht die Wirkung dieser
Effekte m&ouml;glichst gut nachzuempfinden. Chor, Hall und ihre Variationen werden durch "Geisternoten" simuliert und k&ouml;nnen durch die im vorherigen Absatz
beschriebenen Ankreuzfelder ausgeschaltet werden. Wenn allerdings die Celeste-Variation eines Chores mit einer XG-sysex angefordert wird, aktiviert das
Witczak's Celeste-Filter falls der Knopf <guibutton>eff</guibutton> gedr&uuml;ckt ist.</para>

    </sect1>

<sect1 id="command-line-options">
<title>Befehlszeilen-Parameter</title>

      <para>Bis auf die Angabe von einem oder mehreren Midi-Dateinamen auf der Befehlszeile ist das Wissen um die weiteren
Parameter in diesem Abschnitt wahrscheinlich nicht besonders n&uuml;tzlich f&uuml;r Sie. Falls Sie diese Optionen dennoch ben&ouml;tigen, bevorzugen Sie 
vermutlich die Verwendung der Befehlszeilenversion dieses Programmes: <application>timidity</application>.</para>

<variablelist>
<varlistentry>
<term>kmidi</term>
<listitem>
<para>&lsqb;Optionen&rsqb; Dateiname &lsqb;...&rsqb;</para>
</listitem>
</varlistentry>
</variablelist>

      <para>Verwenden Sie &quot;-&quot; als Dateiname, um eine MIDI-Datei von <filename>stdin</filename> zu lesen.</para>

<variablelist>
<varlistentry>
<term>Optionen:</term>
<listitem>
<para></para>
</listitem>
</varlistentry>
<varlistentry>
<term>-o Dateiname</term>
<listitem>
<para>Leitet die Ausgabe um in die Datei  "Dateiname". Dabei kann Dateiname eine Datei, ein Ger&auml;t oder ein HP-UX-Audioserver sein, abh&auml;ngig
vom Ausgabemodus, der mit der Option <emphasis remap="bf">-O</emphasis> eingestellt wird.
Die Spezialdatei  &quot;-&quot; leitet die Ausgabe nach <filename>stdout</filename> um. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>-O Modus</term>
<listitem>
<para>W&auml;hlt den Ausgabemodus aus den vorhanden M&ouml;glichkeiten aus. Modus muss mit einem der 
von <application>TiMidity</application> unterst&uuml;tzten Ausgabemodusnamen beginnen. F&uuml;hren Sie
<application>TiMidity</application> mit der Option <emphasis remap="bf">-h</emphasis> aus, um eine
Liste anzeigen zu lassen. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>-sf</term>
<listitem>
<para>Sampling-Frequenz f (Hz oder kHz) einstellen. Nicht alle Soundger&auml;te unterst&uuml;tzen alle Frequenzen -- implementationsabh&auml;ngig kann
eine angen&auml;herte Frequenz verwendet werden.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-a</term>
<listitem>
<para>Antialiasing-Filter aktivieren. Samples werden vor der Wiedergabe durch einen Tiefpassfilter geleitet. Dadurch wird das bei niedrigen
Resampling-Frequenzen produzierte Aliasing-Ger&auml;usch verringert.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-f</term>
<listitem>
<para>Schnelles Ausklingen aktivieren. Schaltet schnelle H&uuml;llkurven ein. Einige Midi-Dateien klingen besser, wenn die Noten
langsamer ausklingen -- das erzeugt einen Eindruck von Nachhall (Reverb).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-pn</term>
<listitem>
<para>Stellt die Mehrstimmigkeit ein (Anzahl gleichzeitig wiedergegebener Stimmen).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-An</term>
<listitem>
<para>Lautst&auml;rke um n Prozent erh&ouml;hen (kann zu Clipping f&uuml;hren).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-Cn</term>
<listitem>
<para>Setzt das Verh&auml;ltnis von Sampling- und Kontrollfrequenz fest. Hier wird eingestellt, wie oft die H&uuml;llkurve neu berechnet wird -- ein kleines 
Verh&auml;ltnis f&uuml;hrt zu besserer Wiedergabequalit&auml;t, ben&ouml;tigt aber mehr CPU-Zeit.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-E</term>
<listitem>
<para>Schaltet Witczak's Effektfilter f&uuml;r Chor, Hall (Reverb), Phaser und Celeste ein.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-&num;n</term>
<listitem>
<para>Patch-Satz w&auml;hlen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-L Verzeichnis</term>
<listitem>
<para>F&uuml;ge Verzeichnis zum Suchpfad hinzu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-c Datei</term>
<listitem>
<para>Zus&auml;tzliche Konfigurationsdatei einlesen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-In</term>
<listitem>
<para>Standardm&auml;&szlig;ig Programmnummer n verwenden.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-P Datei</term>
<listitem>
<para>Benutze Datei als Patch-Datei f&uuml;r alle Programme</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-Dn</term>
<listitem>
<para>Spiele Schlagzeug auf Kanal n</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-Qn</term>
<listitem>
<para>Ignoriere Kanal n</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-F</term>
<listitem>
<para>Schnelles "Panning" aktivieren</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-U</term>
<listitem>
<para>Instrumenten-Patches zwischen der Wiedergabe von Midi-Dateien aus dem Speicher entfernen</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-i Modus</term>
<listitem>
<para>Benutzeroberfl&auml;che ausw&auml;hlen (siehe Liste weiter unten)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-Bn</term>
<listitem>
<para>Anzahl Puffer-Fragmente festlegen</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-h</term>
<listitem>
<para>Hilfeinformationen anzeigen</para>
</listitem>
</varlistentry>
</variablelist>

<para>Verf&uuml;gbare Ausgabemodi (-O Option):</para>

<variablelist>
<varlistentry>
<term>-Od</term>
<listitem>
<para>Linux dsp Ger&auml;t</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-Ow</term>
<listitem>
<para>RIFF-WAVE-Datei</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-Or</term>
<listitem>
<para>Rohe Wellenformdaten</para>
</listitem>
</varlistentry>
</variablelist>

<para>Ausgabeformatoptionen (anh&auml;ngen an  -O? Option):</para>

<variablelist>
<varlistentry>
<term>`8'</term>
<listitem>
<para>8-bit Samplebreite</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`1'</term>
<listitem>
<para>16-bit Samplebreite</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`U'</term>
<listitem>
<para>uLaw Kodierung</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`l'</term>
<listitem>
<para>lineare Kodierung</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`M'</term>
<listitem>
<para>Mono</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`S'</term>
<listitem>
<para>Stereo</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`s'</term>
<listitem>
<para>Vorzeichenbehaftete Ausgabe</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`u'</term>
<listitem>
<para>Vorzeichenlose Ausgabe</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`x'</term>
<listitem>
<para>Ausgabe Byte-vertauscht</para>
</listitem>
</varlistentry>
</variablelist>

<para>Verf&uuml;gbare Benutzeroberfl&auml;chen (-i Option):</para>

<variablelist>
<varlistentry>
<term>-iq</term>
<listitem>
<para>&kmidi; Qt-Oberfl&auml;che</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-id</term>
<listitem>
<para>einfache (dumb) Oberfl&auml;che</para>
</listitem>
</varlistentry>
</variablelist>

<para>Oberfl&auml;chen-Einstellungen (anh&auml;ngen an  -i? Option):</para>

<variablelist>
<varlistentry>
<term>`v'</term>
<listitem>
<para>Mehr Informationen anzeigen (kumulativ)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`q'</term>
<listitem>
<para>Weniger Informationen anzeigen (kumulativ)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>`t'</term>
<listitem>
<para>Wiedergabe verfolgen (Trace)</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-i Modus</term>
<listitem>
<para>Benutzeroberfl&auml;che ausw&auml;hlen (siehe weiter unten) </para>
</listitem>
</varlistentry>
<varlistentry>
<term>-Bn</term>
<listitem>
<para>Anzahl Puffer-Fragmente festlegen</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-h</term>
<listitem>
<para>Diese Hilfe anzeigen</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>

<chapter id="questions-and-answers">
<title>Fragen und Antworten</title>

<sect1 id="where-to-get-a-full-patchset">
<title>Woher bekomme ich einen vollst&auml;ndigen Patch-Satz?</title>

      <para>Bitte lesen Sie dazu <xref linkend="patches"> im Kapitel zur Installation von &kmidi;.</para>
</sect1>
</chapter>

  <chapter id="design">
    <title>Design</title>
    <sect1 id="processes">
      <title>Prozesse</title>
      <para>&kmidi; ist eine Benutzeroberfl&auml;che, die die Bildschirmdarstellung &uuml;bernimmt und Benutzereingaben verarbeitet. &kmidi; wird
als eigenst&auml;ndiger Prozess neben <application>TiMidity</application> ausgef&uuml;hrt. Das letztere Programm liest Midi-Dateien und gibt
sie wieder.</para>
    </sect1>

    <sect1 id="synthesis-model">
      <title>Synthesizer-Modell</title>
      <para><application>TiMidity</application> hat einen Tongenerator, zwei H&uuml;llkurvengeneratoren, drei Sinusoszillatoren f&uuml;r tiefe Frequenzen,
einen Tiefpassfilter und eine Einheit f&uuml;r Effekte. (Der Tiefpassfilter wird nur verwendet, wenn die vierte Interpolationsoption von &kmidi; gew&auml;hlt und
der Knopf <guibutton>filt</guibutton> gedr&uuml;ckt ist -- momentan funktioniert das noch nicht zuverl&auml;ssig.)</para>

      <para>Der Tongenerator resampelt Intrumenten-Patches mit den Grundfrequenzen, die f&uuml;r die wiedergegebenen Noten geeignet sind. (Der 
Interpolationsalgorithmus kann durch vier Ankreuzfelder im oberen Hauptfenster ausgew&auml;hlt werden.)</para>

      <para>Der H&uuml;llkurvengenerator moduliert jede Note nacheinander mit einer Attack-, einer Hold-, einer Abkling- und einer
Release-Phase. Einer der Generatoren beeinflusst die Amplitude, der andere die Tonh&ouml;he und/oder die Grenzfrequenz des
Tiefpassfilters.</para>

      <para>Die Oszillatoren f&uuml;r tiefe Frequenzen modulieren die Amplitude (f&uuml;r Tremolo), die Frequenz (f&uuml;r Vibrato) und die Grenzfrequenz des
Tiefpassfilters (XG "rezo sweep").</para>

      <para>Die Einheit f&uuml;r Effekte liefert Echo-, Verstimmungs-, Hall-, Chor-, Celeste- und Phaser-Effekte. Echo (durch zus&auml;tzlich generierte
Echonoten) und Hall (durch einen Filter erzeugt) erzeugen zusammen Midi-Hall (Midi-Reverberation). Verstimmung 
(Detuning--durch Erzeugung von zus&auml;tzlichen in der H&ouml;he ver&auml;nderten Noten) und Chor (durch einen Filter erzeugt) implementieren zusammen
Midi-Chor. (Die Effektfilter sind nur aktiv, wenn der Knopf <guibutton>eff</guibutton> gedr&uuml;ckt ist. Echo und Verstimmung k&ouml;nnen mit den
mittleren beiden Ankreuzfeldern auf der rechten Seite des unteren Hauptfenster und durch die <guimenu>Chor</guimenu>- und 
<guimenu>Hall</guimenu>-Men&uuml;s eingestellt werden.)</para>

      <para>Instrumente k&ouml;nnen ein oder zwei Tonelemente und f&uuml;r jedes davon einen Patch-Satz mit Patches f&uuml;r unterschiedliche Bereiche der 
Lautst&auml;rke (&uuml;blich f&uuml;r Klaviere) und Tonh&ouml;he beinhalten. GUS Patch-S&auml;tze enthalten allerdings lediglich ein Tonelement und einen Lautst&auml;rkebereich
pro Instrument. (Wählen Sie das Ankreuzfeld ganz rechts aus, um &kmidi; zur Anzeige der Patch-Satznamen im Informationsfenster beim Laden
anzuzeigen. Dabei wird der Lautst&auml;rkebereich angezeigt und "(2)" bei zwei Tonelementen.)</para>
    </sect1>

    <sect1 id="midi-implementation">
      <title>Midi-Implementierung</title>

      <para>Fast alle Midi- und Kontrollnachrichten sind irgendwie implementiert (was bedeutet, dass sie irgend etwas bewirken, wenn
auch nicht notwendigerweise das Richtige). NRPN-Kontrollnachrichten zum Senden von Attack- und Abklingzeit sind nicht implementiert, da der Entwickler
keine Midi-Dateien gefunden hat, die diese verwenden. Die "flanging"-Kontrollnachricht ist nicht implementiert (obwohl "flanging" innerhalb
eines XG sysex-Dumps implementiert ist). Nur wenige der Kontrollnachrichten f&uuml;r Roland und Yamaha sysex-dumps sind implementiert.</para>

      <para><application>TiMidity</application> kann Midi-Dateien verwalten, die zur Wiedergabe auf bis zu vier verschiedenen Synthesizern gedacht sind.
F&uuml;r jeden der vier Synthesizer werden die 16 Kan&auml;le getrennt verwaltet. Allerdings m&uuml;ssen die Synthesizer innerhalb der Midi-Datei mit Hilfe von
Port-Befehlen (in Roland-GS oder Yamaha-XG sysex-dumps) ausgew&auml;hlt werden. Einige Midi-Dateien f&uuml;r mehrere Synthesizer haben diese Port-Befehle
nicht. (Das Informationsfenster zeigt Port-Befehle an, falls sie vorhanden sind.)</para>

      <para>Die S&auml;ulenanzeige der Kanalaktivit&auml;t ist auf 16 Kan&auml;le begrenzt. Das Kanaldiagramm der Patches mit horizontalen Balken f&uuml;r Steuerwerte ist
auf einen Satz von 16 Kan&auml;len begrenzt.</para>
    </sect1>

    <sect1 id="volume">
      <title>Lautst&auml;rke</title>

      <para>Lautst&auml;rkeunterschiede sind im Vergleich zum originalen <application>TiMidity</application> stark reduziert. Das verringert 
"clipping" (Abschneiden von Informationen) und erh&ouml;ht die dynamischen Unterschiede. (Bei geringen Lautst&auml;rken k&ouml;nnen allerdings leider
 Artefakte entstehen). Falls Sie eine gr&ouml;&szlig;ere Lautst&auml;rke ben&ouml;tigen, sollten Sie diese an einer anderen Stelle einstellen. 
Verwenden Sie entweder <application>KMix</application>, um die Line-oder Mixerlautst&auml;rke f&uuml;r <filename>/dev/dsp</filename> zu erh&ouml;hen 
oder Sie erh&ouml;hen die Lautst&auml;rke an ihren Kopfh&ouml;rern oder Aktivboxen.</para>
    </sect1>

    <sect1 id="computation-issues">
      <title>Geschwindigkeitsaspekte</title>

      <para><application>TiMidity</application> liefert unter Umst&auml;nden die Daten nicht schnell genug an den Sound-Treiber und die Folge sind
Aussetzer in der Musik. <application>TiMidity</application> versucht solche Aussetzer zu vermeiden, indem es seinen Pufferinhalt &uuml;berwacht und beim
Leerlaufen des Puffers den Berechnungsaufwand verringert: es verwendet einen gr&ouml;beren Interpolationsalgorithmus zum Resampeln, es f&uuml;gt keine
Extranoten f&uuml;r Echo und Verstimmung f&uuml;r Hall- und Chor-Effekte ein, und es beendet Noten fr&uuml;her oder &uuml;bergeht einzelne Noten vollst&auml;ndig. 
Daher kann es abh&auml;ngig von Musikst&uuml;ck, Patch-Satz und Systemleistung zu einer Verringerung der Qualit&auml;t kommen, wenn auch Aussetzer unterbleiben.
Die LEDs des Hauptfensters von &kmidi; zeigen an, welche Anstrengungen <application>TiMidity</application> machen muss, um komplette Aussetzer
zu vermeiden. (Anzeichen von "Verzweiflung": Die Puffer-LED &auml;ndert die Farbe von einem gesunden gr&uuml;n auf gesch&auml;ftiges orange, 
die Interpolations-LED geht aus (was bedeutet, dass lediglich lineare Interpolation zum Resampeln verwendet wird), die Echo-LED oder die
Verstimmungs-LED geht aus (was bedeutet, dass keine Extranoten oder verstimmte Noten wiedergegeben werden).
</para>

      <para>Zur &Uuml;berwachung des Ausgabepuffers muss der Soundtreiber gefragt werden, wie viele Daten er gepuffert hat. Das funktioniert f&uuml;r
Hannu Savolainen's OSS-Treiber (f&uuml;r Linux und einige andere Systeme), vielleicht auf &auml;lteren Sun-Workstations (es hat zumindest funktioniert), aber nicht
auf anderen System.</para>

      <para>Sie k&ouml;nnen durch verschiedene Ma&szlig;nahmen den Berechnungsaufwand f&uuml;r <application>TiMidity</application> senken:
(1) verringern Sie die erlaubte Mehrstimmigkeit (Drehregler im unteren Hauptfenster), (2) schalten Sie den Knopf <guibutton>eff</guibutton> aus,
(3) w&auml;hlen Sie eine billigere Resampling Interpolationsmethode (eines der Ankreuzfelder im oberen Hauptfenster links), (4) deaktivieren Sie
Echo, Verstimmung oder Stereo mit den linken drei Ankreuzfeldern im unteren Hauptfenster, (5) w&auml;hlen Sie im Men&uuml;
<guimenu>Hall</guimenu> <guimenuitem>Trocken</guimenuitem> aus. Nat&uuml;rlich hat all dies einen Verlust an Qualit&auml;t zur Folge. Den Knopf
<guibutton>filt</guibutton> zu dr&uuml;cken kostet nichts, es sei denn, Sie haben gleichzeitig als Interpolationsoption "cspline+filter" gew&auml;hlt.</para>
    </sect1>

    <sect1 id="memory-issues">
      <title>Speicheraspekte</title>

      <para><application>TiMidity</application> kann eine Riesenmenge Speicher f&uuml;r Patches verbrauchen. Anzeichen daf&uuml;r ist eine geringe 
Antwortgeschwindigkeit ihrer Arbeitsoberfl&auml;che oder gar ein Absturz. Dieses Problem tritt wahrscheinlich nur bei gro&szlig;en sf2-Soundfonts mit
mehr als 30 MB auf. Die Klavier-Patches des  Personal Choice's PC400 Soundfonts k&ouml;nnen beispielsweise je 25 MB Speicher
belegen. Nach der Wiedergabe einiger Midi-Dateien, die drei dieser Patches verwenden, sind 75 MB Speicher belegt. Im 
Konfigurationsdialog von &kmidi; k&ouml;nnen Sie die Obergrenze des von &kmidi; verwendeten Speichers festlegen. Das bedeutet, dass 
<application>TiMidity</application> fr&uuml;her geladene Patches verwirft, wenn die Obergrenze erreicht ist.  Die Standardeinstellung von
60 MByte funktioniert auf einem System mit 48 MB RAM und 196 MB Cache-Speicher. Je niedriger Sie diesen Wert ansetzen, um so mehr
Patches m&uuml;ssen w&auml;hrend der Wiedergabe einer St&uuml;ckliste zwischendurch nachgeladen werden. Wenn Sie &uuml;ber sehr viel RAM verf&uuml;gen, k&ouml;nnen
sie den Wert auf "no limit" setzen. Wenn Sie den Wert hoch genug ansetzen, k&ouml;nnen ganze Soundfont-Dateien anstatt einzelner Patches
geladen werden. Setzen Sie den Wert zu gering an, so ist das nachteilig, da Soundfont-Dateien in einem St&uuml;ck weniger Speicher ben&ouml;tigen als
die Patches, wenn Sie einzeln geladen werden (der Grund ist unklar). </para>

      <para>Auf Little-Endian-Systemen wie x86 werden sf2-Dateien nicht eingelesen, sondern in den Speicher abgebildet. Damit erfolgt der Start
wesentlich schneller. Für Big-Endian-Systeme konnte das bis jetzt noch nicht implementiert werden.</para>

      <para>Nach der Wiedergabe jeder Midi-Datei gibt &kmidi; die durch Patches belegte Speichermenge im Informationsfenster aus.</para>

      <para>Wenn Sie nur &uuml;ber wenig Speicher oder Auslagerungsspeicher verf&uuml;gen, kann ihr System trotz einer niedrigen Obergrenze des von
&kmidi; verwendeten Speichers abst&uuml;rzen. Seien Sie daher vorsichtig mit gro&szlig;en Soundfonts. </para>
    </sect1>
  </chapter>

<chapter id="credits">
<title>Mitwirkende</title>

    <para>Dieses Programm verwendet Tuuka Toivonen's TiMidity 0.2i engine, Copyright (C) 1995
<ulink url="mailto:toivonen@clinet.fi">Tuuka Toivonen</ulink>. Eine erweiterte Version von Tuuka's urspr&uuml;nglichem Programm mit f&uuml;nf anderen
Benutzeroberfl&auml;chen ist in der &kmidi;-Distribution enthalten. (F&uuml;r Informationen zur &Uuml;bersetzung von <application>TiMidity</application>
siehe weiter unten.) &kmidi; und <application>TiMidity</application> verwenden die
AWE Soundfont-Erweiterungen von <ulink url="mailto:iwai@dragon.mm.t.u-toky.ac.jp">Takashi Iwai</ulink> und die
AMD InterWave-Erweiterungen von <ulink url="mailto:lee@hawaii.edu">Greg Lee</ulink>,. Diese erm&ouml;glichen die Benutzung von
soundfonts (.sbk/.sf2-Dateien) und IW Patch-S&auml;tzen (.fff/.dat-Dateien) zus&auml;tzlich zu den Gravis/Forte.pat-Dateien.</para>

<para>Deutsche &Uuml;bersetzung der Dokumentation Frank Sch&uuml;tte <email>F.Schuette@t-online.de</email></para>

</chapter>

<chapter id="copyright">
<title>Copyright</title>

    <para>KMidi Copyright 1997 Bernd Johannes Wuebben <ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></para>

<para>KMidi verwendet Tuukka Toivonen's timidity 0.2i engine, Copyright (C) 1995 Tukka
Toivonen <ulink url="mailto:toivonen@clinet.fi">toivonen@clinet.fi</ulink>.</para>

&underFDL;
&underGPL;

</chapter>

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

<sect1 id="how-to-obtain-kmidi">
<title>Wie Sie &kmidi; bekommen</title>

<para>&kmidi; ist ein Teil des KDE-Projekts (<ulink url="http://www.kde.org">http://www.kde.org</ulink>).
Sie finden &kmidi; auf <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, dem
Haupt-FTP-Server des KDE-Projekts.</para>
</sect1>

<sect1 id="requirements">
<title>Anforderungen</title>

<para>Um &kmidi; erfolgreich kompilieren zu k&ouml;nnen, brauchen Sie die
neueste Version von <literal remap="tt">kdelibs</literal>. Alle
ben&ouml;tigten Bibliotheken wie auch &kmidi; selbst finden Sie auf
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>.</para>

      <para>Die "dumb" Befehlszeilenoberfl&auml;che von <application>TiMidity</application> sollte auf jedem Standard-Unixsystem zu &uuml;bersetzen
sein. Die anderen Benutzeroberfl&auml;chen stellen spezielle Anforderungen (Informationen in den verschiedenen README-Dateien der
Distribution). Die Motif-Oberfl&auml;che funktioniert zufriedenstellend unter Lesstif, aber besser mit Motif.</para>
</sect1>

<sect1 id="compilation-and-installation">
<title>Kompilierung und Installation</title>

<para>Wenn Sie &kmidi; bereits installiert haben, so stellen Sie bitte sicher,
dass Sie eine Sicherungskopie der Konfigurationsdateien haben
(typischerweise zu finden unter &dollar;KDEDIR/share/apps/kmidi/config/),
bevor Sie &kmidi; installieren, da diese sonst &uuml;berschrieben werden.
Genauso sollten Sie vor der Installation einer neuen Version von TiMidity
(nicht-KDE-Version) die Dateien unter /usr/local/lib/timidity/* sichern.
Wenn Sie umgekehrt eine komplett neue Installation dieser beiden Programme
vornehmen wollen, sollten Sie diese Dateien l&ouml;schen, da sie unter
Umst&auml;nden von der neuen Version nicht &uuml;berschrieben werden.</para>

<para>Wenn Sie die komplette kdemultimedia-Distribution haben, wechseln Sie ins
kdemultimedia-Verzeichnis und tippen:</para>

      <para><programlisting>&percnt; ./configure</programlisting></para>

      <para>Um alle Benutzeroberfl&auml;chen einzubeziehen, tippen Sie folgendes:</para>

      <para><programlisting>&percnt; ./configure --enable-interface=ncurses,xaw,gtk,tcltk,slang,motif</programlisting></para>

<para>Bleiben Sie in diesem Verzeichnis, wenn Sie alle Multimedia-Programme
erzeugen wollen oder wechseln Sie ins Verzeichnis kmidi, falls Sie nur
dieses eine Programm wollen. Dort tippen Sie:</para>

<para><programlisting>&percnt; make
&percnt; make install</programlisting></para>

      <para>Die Nicht-KDE-Version von <application>TiMidity</application> wird auf die gleiche Art &uuml;bersetzt und installiert wie
 &kmidi;. (Die Manualseite <filename>timidity.1</filename> wird allerdings nicht automatisch in
<filename>/usr/man/man1</filename> installiert.</para>

</sect1>

<sect1 id="patches">
<title>Woher bekommt man einen vollst&auml;ndigen Satz Patches?
</title>

<para>&kmidi; kann zwei Arten von Patch-S&auml;tzen benutzen: GUS-Patches und AWE32 
SoundFonts (<literal remap="tt">sf2</literal>). Ein Patch ist eine Menge von Samples und
Parametern f&uuml;r ein einzelnes Instrument. Bei GUS befindet sich jeder
Patch in einer eigenen Datei. AWE32 SoundFonts packen alles zusammen in eine einzige
<literal remap="tt">.sf2- </literal>oder<literal remap="tt">.sbk</literal>-Datei.</para>

      <para>Der Autor empfiehlt <literal remap="tt">.sf2</literal> Soundfonts, und davon besonders die bereits erw&auml;hnten Chaos-Fonts.</para>

<para>Im Konfigurationsdialog von &kmidi; finden Sie Hinweise zu Webseiten mit Patch-S&auml;tzen. Hier sind einige zus&auml;tzliche
Quellen:</para>

<para><ulink url="mailto:goemon@anime.net">Dan Hollis</ulink>
hat einen Patch-Satz zusammengestellt. Bitte besuchen Sie seine Seite auf
<ulink url="http://www.anime.net/~goemon/timidity/">http://www.anime.net/~goemon/timidity</ulink>
und helfen Sie ihm, diesen zum besten verf&uuml;gbaren Satz zu machen.</para>

<para><emphasis remap="bf">Neu:</emphasis> Ich habe den oben erw&auml;hnten Patch-Satz auf ftp.kde.org
hinaufgeladen. Der genaue Ort ist zur Zeit auf
<ulink url="ftp://fiwi02.wiwi.uni-tuebingen.de/pub/kde/stable/Beta2/apps/multimedia/sound/">
ftp://fiwi02.wiwi.uni-tuebingen.de/pub/kde/stable/Beta2/apps/multimedia/sound/</ulink>. Diese Stelle kann sich allerdings noch &auml;ndern.
Schauen Sie also auf ftp.kde.org ein wenig herum.</para>

<para>Patches k&ouml;nnen auch als .dep oder .rpm Module im Sunsite Archiv gefunden
werden:</para>

<para><itemizedlist>
<listitem>
<para> Debian (.dep):
<ulink url="ftp://sunsite.unc.edu/pub/Linux/./distributions/debian/bo/source/sound/timidity-patches_0.1.tar.gz">timidity-patches_0.1.tar.gz</ulink>
</para>
</listitem>
<listitem>
<para> .rpm:
<ulink url="ftp://sunsite.unc.edu/pub/Linux/distributions/redhat/contrib/oldrpms/contrib-2.0.x/RPMS/timidity-patches-1-1.i386.rpm">timidity-patches-1-1.i386.rpm</ulink>
</para>
</listitem>
<listitem>
<para> .srpm:
<ulink url="ftp://sunsite.unc.edu/pub/Linux/distributions/redhat/contrib/oldrpms/contrib-2.0.x/SRPMS/timidity-patches-1-1.src.rpm-try2">timidity-patches-1-1.src.rpm-try2</ulink>
</para>
</listitem>
</itemizedlist>
</para>

<para>Der Autor hat die oben genannten Patches (bis jetzt) nicht ausprobiert. Er
selbst verwendet den Midia Patch-Satz sowie einige zus&auml;tzliche Patches und
Schlagzeug-S&auml;tze. Sie finden den Midia Patch-Satz auf
<ulink url="ftp://archive.cs.umbc.edu/pub/midia/">ftp://archive.cs.umbc.edu/pub/midia/</ulink>.</para>

<para>Weitere Patches finden Sie auf
<ulink url="ftp://ftp.cdrom.com/pub/gus/sound/patches/files/">ftp://ftp.cdrom.com/pub/gus/sound/patches/files/</ulink>.
(Probieren Sie die gsdrum- und wow-Patches aus!)</para>

<para>Vincent Pagel hat eine Sammlung von Patches zusammengestellt. Dieser Link
kann nur w&auml;hrend der Nachtstunden in Paris erreicht werden:
<ulink url="ftp://sig.enst.fr/pub/midi/instruments/">ftp://sig.enst.fr/pub/midi/instruments/</ulink>
Sie finden die Konfigurationsdatei, die zu seinem Patch-Satz passt auf:
<ulink url="ftp://sig.enst.fr/pub/midi/timidity_pagel.cfg">ftp://sig.enst.fr/pub/midi/timidity_pagel.cfg</ulink></para>

<para>Besuchen Sie auch die 
<ulink url="http://www.clinet.fi/~toivonen/timidity/">TiMidity-Seite</ulink></para>

<para>und Takashis Homepage:
<ulink url="http://bahamut.mm.t.u-tokyo.ac.jp/~iwai/midi.html#TiMidity">http://bahamut.mm.t.u-tokyo.ac.jp/~iwai/midi.html#TiMidity</ulink>. 
Takashis Homepage empfiehlt den 8 MB AWE32 SoundFont <literal remap="tt">chaos8m.sf2</literal> und
den 12 MB gro&szlig;en AWE32 SoundFont <literal remap="tt">chaos12m.sf2</literal>, welche ganz gut
sind. Sie sind erh&auml;ltlich unter <ulink url="http://soback.kornet.nm.kr/~chaos/sbawe32/sbawe32.htm">http://soback.kornet.nm.kr/~chaos/sbawe32/sbawe32.htm</ulink>, abgelegt als
selbstextrahierende <literal remap="tt">*.exe</literal>-Datei.</para>

<sect2 id="patch-set-installation">
<title>Installation von Patch-S&auml;tzen</title>

<para>Jeder der oben genannten Patch-S&auml;tze (Sie ben&ouml;tigen nur einen)
sollte eine <literal remap="tt">.cfg</literal>-Datei enthalten, &auml;hnlich jener, die in &kmidi;
enthalten ist und sich in <literal remap="tt">$KDEDIR/share/apps/kmidi/config</literal> befindet. &kmidi; hat f&uuml;r eine 
Reihe von verbreiteten Patch-S&auml;tzen, wie den Midia-Satz, fertige Konfigurationsdateien f&uuml;r Sie bereit.</para>

<para>Sie m&uuml;ssen den Konfigurationsdateien nicht die Endung
<literal remap="tt">.cfg</literal> geben. Es handelt sich um Textdateien, deren Struktur 
an einer anderen Stelle dieser Dokumentation beschrieben ist.</para>

<para>Zum Abschluss der Installation eines Patch-Satzes muss die Datei
<literal remap="tt">timidity.cfg</literal> g&auml;ndert und die Konfigurationsdatei des
heruntergeladenen Patch-Satzes eingebunden werden. Wenn Sie einen Blick in die
<literal remap="tt">timidity.cfg</literal>-Datei werfen, wird Ihnen v&ouml;llig klar, was gemeint ist. 
Das war's. Jetzt k&ouml;nnen Sie auch die anderen MIDIs abspielen, die sich im
&kmidi; Paket befinden (und nat&uuml;rlich alle anderen auch).</para>
</sect2>

<sect2 id="miscellaneous">
<title>Verschiedenes</title>

<para>Gelegentlich werden Sie erleben, dass &kmidi; einen Patch f&uuml;r ein
spezielles Instrument nicht findet. (&Ouml;ffnen Sie das Informationsfenster, um
eine Fehlermeldung zu sehen.) In diesem Fall m&uuml;ssen Sie sich nur den
fehlenden Patch besorgen und ihn installieren, indem Sie ihn in das Verzeichnis
<literal remap="tt">patch/</literal> kopieren und Ihre Konfigurationsdatei bearbeiten, um &kmidi;
anzuzeigen, dass der neue Patch nun verf&uuml;gbar ist.</para>

<para>Manchmal klingt auch ein bestimmtes Instrument nicht besonders gut. In
diesem Fall k&ouml;nnen Sie sich in einem der Ultrasound-Archive einen neuen
Patch besorgen und damit den schlechteren ersetzen. Wie Sie feststellen werden,
ist es v&ouml;llig Ihnen &uuml;berlassen, wie gut jedes Instrument klingt.
Sie k&ouml;nnen sogar Ihre eigenen Patches mit dem pat2wav Programm herstellen,
das in der &kmidi;-Distribution enthalten ist.</para>
</sect2>
</sect1>
</appendix>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->