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

<book lang="&language;">
<bookinfo>
<title
>Das Handbuch zu &krec;</title>

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

<othercredit role="translator"
> <firstname
>Frank</firstname
><surname
>Schütte</surname
> <affiliation
><address
><email
>F.Schuette@t-online.de</email
></address
> </affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit
> 

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

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

<abstract>
<para
>&krec; ist ein Aufnahmeprogramm für &arts;. Es kann verwendet werden, um einzelne Dateien oder ganze Sitzungen aufzunehmen. Es verfügt über einige dynamische Effekte sowie eine Möglichkeit der Wiedergabe von aufgenommenen Stücken (solange man nicht versucht, das Abspielende aufzunehmen). </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>KRec</keyword>
<keyword
>aRts</keyword>
<keyword
>Aufnahme läuft</keyword>
<keyword
>Oberfläche</keyword>
</keywordset>

</bookinfo>
 
<chapter id="introduction">
<title
>Einführung</title>

<sect1 id="why-krec">
<title
>Warum &krec; programmiert wurde</title>

<para
>Nach einiger Zeit der Arbeit mit &arts; stellte ich fest, das es außer dem Befehlszeilenprogramm artsrec keine Oberfläche zur Aufnahme gibt. Da ich mit Freunden ein Hörspiel unter &Linux; aufnehmen und mischen wollte, begann ich &krec; zu programmieren. </para>
</sect1>

<sect1 id="what-krec-does">
<title
>Was &krec; kann</title>

<para
>&krec; ist ein einfaches Programm. Es stellt eine Verbindung zum &arts;-Server her und leitet die empfangenen Daten in eine Datei um. </para>
<para
>Momentan können nur Rohdateien gelesen werden. Es handelt sich um Dateien im Wave-Format, aber ohne den WAV-Vorspann (mit sox kann man eine Konvertierung durchführen). </para>
</sect1>

</chapter>

<chapter id="using-krec">
<title
>Verwendung von &krec;</title>

<para
>Dieses Kapitel beschreibt die Verwendung von &krec;. &krec; kann auf mehrere Arten verwendet werden, daher besteht dieses Dokument aus mehreren <quote
>HOWTO</quote
>-Abschnitten, die verschiedene Anwendungsmöglichkeiten beschreiben. Am ersten Absatz kann man erschließen, welcher Teil auf die eigene Anwendung passt. Alles in allem bietet &krec; einige fantastische Möglichkeiten.</para>

<screenshot>
<screeninfo
>Bildschirmfoto von &krec;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="krec-hicolor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Bildschirmfoto von &krec; direkt nach dem Start.</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect1 id="simple-usage">
<title
>Aufnahme einer einzigen Datei</title>

<para
>Falls man etwas im Radio hört, das man aufnehmen möchte (und falls das Radio mit der Soundkarte des Rechners verbunden ist), gibt es eine (relativ) einfache Aufnahmemöglichkeit. </para>

<orderedlist>
<listitem>
<para
>Zunächst wählt man die Aufnahmequelle in der Soundkarte. Man benötigt dazu einen Mixer (&kmix;), um die Quelle auszuwählen. Der &arts;-Server muss auf full-duplex eingestellt sein (und sowohl die Soundkarte als auch die Treiber müssen das unterstützen). Falls &arts; neu gestartet werden muss, sollte man auch &krec; neu starten. </para>
</listitem>
<listitem>
<para
>Dann öffnet man das Programm &arts;-Kontrolle und dort den Audio-Manager. Es werden zwei neue Einträge &krec;::In und &krec;::Out angezeigt. Der zweite Eintrag wird für die Wiedergabe verwendet und ist daher hier uninteressant. Der erste Eintrag sollte mit dem Bus <emphasis
>in_soundcard</emphasis
> verbunden sein. Falls er nicht ausgewählt werden kann, stimmt vermutlich die Konfiguration nicht (kein full-duplex oder so ähnlich).</para>
</listitem>
<listitem>
<para
>Falls soweit alles erfolgreich war, sollte man Bewegung innerhalb von &krec; feststellen &mdash; die Pegelanzeige (VU-Meter). Gute Aufnahmen ohne "Clippling" erhält man, wenn die Lampen höchstens gelb oder orange aber niemals rot zeigen. Mit dem Schieberegler rechts der Anzeige lässt sich die Lautstärke kontrollieren.</para>
</listitem>
<listitem>
<para
>Nun benötigt man noch eine Datei, in der die Aufnahme gespeichert werden soll. Dazu wählt man im Menü <menuchoice
><guimenu
>Datei</guimenu
><guimenuitem
>Neue Datei</guimenuitem
></menuchoice
> oder das entsprechende Symbol der Werkzeugleiste aus. Danach muss man &krec; noch veranlassen, diese Datei auch für die Aufnahme zu verwenden. Die Funktion dazu findet man im Kontextmenü des Dateieintrags.</para>
</listitem>
<listitem>
<para
>Jetzt kann die Aufnahme beginnen. Mit dem großen roten Knopf in der Werkzeugleiste oder im Menü <guimenu
>Abspielen</guimenu
> <guimenuitem
>Aufnahme</guimenuitem
> durch Drücken von <keycap
>R</keycap
> startet die Aufnahme. Genauso kann die Aufnahme angehalten werden über den Eintrag im Menü <guimenu
>Abspielen</guimenu
> (oder mit der Taste <keycap
>S</keycap
>).</para>
</listitem>
</orderedlist>

<para
>Das erfordert mehr Zeit als die Aufnahmetaste am Cassettenrekorder zu betätigen, aber dafür hat &krec; einige zusätzliche Funktionen.</para>

<tip>
<para
>Man möchte vielleicht andere Dinge aufnehmen. Zum Test kann man das Ausgangssignal von &noatun; verwenden: Man verbindet dazu &krec;::In mit <emphasis
>out_soundcard</emphasis
> (oder irgendeinem anderen Bus, auf den &noatun; ausgibt). Das funktioniert auch ohne Full-Duplex-Unterstützung unter &arts;.</para>
</tip>
</sect1>

<sect1 id="advanced-usage">
<title
>Die Aufnahme von mehreren Dateien</title>

<para
>In diesem Abschnitt gehen wir davon aus, dass man viele kurze oder längere Stücke in mehren Dateien aufnehmen möchte. Man könnte z.B. Szenen für ein Hörspiel aufnehmen wollen (das war übrigens der Grund, &krec; überhaupt zu programmieren). </para>

<para
>Ich setze voraus, dass man mit &arts; bereits gearbeitet hat und daher einige Fakten zum Thema <quote
>Audioaufnahmen</quote
> bekannt sind. Das Mikrofon sollte mit dem Rechner verbunden sein und man sollte wissen, was man einrichten muss (außerhalb von &krec;), um das empfangene Signal aufzunehmen. </para>

<para
>Dieser <quote
>Überblick</quote
> verwendet ein Hörspiel als Beispiel. Man muss sich zunächst entscheiden, ob man die Aufnahmen unterschiedlich benennen will oder ob sich die Namen lediglich in einer Nummer unterscheiden sollen. Im ersten Fall sollte man den Instruktionen unter <xref linkend="simple-usage"/> folgen und beachten, dass man mehrere Dateien gleichzeitig geöffnet haben kann. Andernfalls sollte man hier weiterlesen... </para>

<orderedlist>
<listitem
><para
>Erst sollte man überprüfen, ob die Einrichtung stimmt, ob also wirklich das aufgenommen wird, was man aufnehmen möchte. Im Idealfall sollte man auf der Pegelanzeige (VU-Meter) von &krec; Bewegung wahrnehmen. Falls man nicht von <emphasis
>out_soundcard</emphasis
> aufnimmt, kann man <guimenu
>Abspielen</guimenu
><guimenuitem
>Durchspielen</guimenuitem
> verwenden, um das aufgenommene Signal über die Soundkarte auszugeben. Das ist dem Mithören über den Mixer vorzuziehen, da man hören kann, da man die Aussteuerung der Aufnahme überwachen kann.</para
></listitem>
<listitem
><para
>Mehrere Dateien gleichen Namens werden erzeugt, wenn man mit <guimenu
>Datei</guimenu
> <guimenuitem
>Neue Sitzung</guimenuitem
> eine Sitzung erzeugt. Man wählt den Pfad und den Dateinamen, der dann mit der Nummer der Aufnahme und einer Dateiendung vervollständigt wird.</para
></listitem>
<listitem
><para
>Danach muss man dennoch die Dateien einzeln erzeugen, aber das geschieht, indem man <guimenuitem
>Neue Datei</guimenuitem
> aus dem Kontextmenü wählt. Man kann beliebig viele Dateien erzeugen.</para
></listitem>
<listitem
><para
>Der Rest ist einfach. Man wählt die gewünschte Datei zur Aufnahme aus und nimmt auf...</para
></listitem>
</orderedlist>

<note
><para
>Eine Sitzung ist nicht ein weiterer Mime-Typ, nicht einmal eine eigene Datei. Es ist nur eine programminterne Organisationsform. Man kann daher nicht einfach später eine bestehende Sitzung öffnen und weiter aufnehmen... </para
></note>
</sect1>

<sect1 id="more-usage">
<title
>Weitere Tipps und Hinweise zur Verwendung</title>

<para
>Einige Dinge wären noch zu erwähnen und einige genauer zu erläutern.</para>

<sect2 id="usage-play-through">
<title
>Verwendung von Durchspielen</title>

<para
>Falls man hören möchte, was man gerade aufnimmt, ist die Option <quote
>Durchspielen</quote
> nützlich. Sie befindet sich ebenfalls im Menü <guimenu
>Abspielen</guimenu
>. Man sollte diese Option so häufig wie möglich verwenden, besonders falls man den Kompressor oder andere Effekte verwendet. Sieh auch <xref linkend="internals"/> wegen Details zu den Verbindungen.</para>

<caution>
<para
>Man muss sicher stellen, dass man keine Rückkopplungsschleife erzeugt, wenn man über <emphasis
>out_soundcard</emphasis
> aufnimmt und <quote
>Durchspielen</quote
> aktiviert. Solch eine Schleife kann &arts; nicht verarbeiten. Das System wird langsam und kann &arts; kann abstürzen...</para>
</caution>

</sect2>

<sect2 id="using-compressor">
<title
>Verwendung des Kompressors</title>

<para
>Bei der Aufnahme übe rein Mikrofon kann es sein, dass der Pegel entweder andauernd übersteuert oder viel zu gering ist, insbesondere bei der Sprachaufnahme. Das kann man mit Hilfe des Kompressors korrigieren. Alle Klänge über einer gewissen Lautstärkegrenze werden um den angegebenen Faktor reduziert. Da dieses Vorgehen die "Loudness" verringert, gibt es einen Ausgangspotentiometer, um das Signal zu erweitern (oder zu reduzieren). Die Werte für "Attack" und "Release" ermöglichen eine Kontrolle des Kompressoreinsatzes (die Zeit bis der Kompressor auf eine Übersteuerung reagiert) und die Zeit, bis der Kompressor sich nach Unterschreiten der Obergrenze wieder ausschaltet. </para>
<tip
><para
>Man kann einen Test durchführen, indem man mit <quote
>Durchspielen</quote
> in das Mikrofon spricht. Die Unterschiede sind augenfällig.</para
></tip>
</sect2>

<sect2 id="usage-switching-file">
<title
>Zwischen mehreren Dateien umschalten</title>

<para
>So wie man mehrere Dateien zur Bearbeitung öffnen kann, kann man auch zwischen ihnen umschalten. Das kann sogar während einer Aufnahme passieren. Das kann allerdings dazu führen, dass von der Aufnahme einige Datenpakete verloren gehen. Wie viele das sind, das hängt von der Größe des Audiopuffers ab, der mit &kcontrol; für &arts; festgelegt worden ist. Das sollte nicht allzu viel sein, aber falls man die Dateien mit <command
>artscat file*.raw</command
> hintereinander abspielt, kann man kleine <quote
>Sprünge</quote
> hören.</para>
</sect2>

</sect1>
 
<sect1 id="internals">
<title
>Interne Funktionsweise</title>

<para
>Einige Dinge über die Sound-Verbindungen in &krec;. </para>
<para
>Für die Aufnahme mit &arts; werden einige Dinge benötigt: ein synth_AMAN_RECORD, ein AudioToByteStream-Konverter und ein ByteStreamReceiver. Die ersten beiden befinden sich im &arts;-Server. Das Dritte befindet sich innerhalb der Anwendung. Aber das ist nur der grobe Überblick. Um sich Dateien anhören zu können, benötigt man einen ByteStreamSender innerhalb der Anwendung und einen ByteStreamToAudio-Konverter und einen synth_AMAN_PLAY innerhalb des Servers. </para>
<para
>Wie sieht es mit Effekten aus? Zwischen dem AMAN_RECORD und dem AudioToByteStream befindet sich ein StereoEffectStack, in dem sich ein Kompressor (synth_STEREO_COMPRESSOR) und ein Lautstärkeregler (StereoVolumeControl) befindet. </para>
<para
>Falls man <quote
>Durchspielen</quote
> aktiviert, wird der Effekt-Stapel auch mit AMAN_PLAY verbunden. Auf diese Weise passiert alles innerhalb des &arts;-Servers... </para>
</sect1>

</chapter>

<chapter id="commands">
<title
>Befehlsreferenz</title>

<sect1 id="krec-mainwindow">
<title
>Das Hauptfenster von &krec;</title>

<sect2>
<title
>Das Menü <guimenu
>Datei</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Datei</guimenu
> <guimenuitem
>Neue Datei</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Erzeugt eine neue Datei zur Aufnahme in eine einzelne Datei</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Datei</guimenu
> <guimenuitem
>Neue Sitzung</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Erzeugt eine neue Sitzung für mehrere Aufnahmen</action
></para
></listitem>
</varlistentry>

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

<sect2>
<title
>Das Menü <guimenu
>Abspielen</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Abspielen</guimenu
> <guimenuitem
>Abspielen</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Spielt die ausgewählte Datei ab.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Abspielen</guimenu
> <guimenuitem
>Aufnahme</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Startet die Aufnahme in die gewählte Datei.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Abspielen</guimenu
> <guimenuitem
>Stopp</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Beendet die Aufnahme.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Abspielen</guimenu
> <guimenuitem
>Durchspielen</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Verbindet den Eingang mit dem Ausgang, damit man bei der Aufnahme mithören kann.</action
> (&krec;::In und &krec;::Out im Audio-Manager von &arts;-Kontrolle)</para>
<caution
><para
>Verwenden sie diese Einstellung niemals, um aufzunehmen, was man hört (über out_soundcard). Das erzeugt Rückkopplungen, mit denen &arts; nicht fertig wird. (Man hört es nicht, da &arts; schneller ist als man das von Rückkopplungen zwischen Rekorder und Mikrofon kennt)</para
></caution>
</listitem>
</varlistentry>

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

<sect2>
<title
>Das Menü <guimenu
>Einstellungen</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Einstellungen</guimenu
> <guimenuitem
>Zeige Start-Fenster</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Schaltet das Start-Fenster mit der Kurzanleitung an und aus.</action
></para
></listitem>
</varlistentry>

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

<sect2>
<title
>Das Menü <guimenu
>Hilfe</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="startupwindow">
<title
>Das Start-Fenster</title>

<para
>Das Start-Fenster besitzt nahezu den gleichen Inhalt wie der &ktip;-Dialog. </para>
</sect1>

</chapter>

<chapter id="faq">
<title
>Fragen und Antworten</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>Ich kann meine mit &krec; aufgenommenen Dateien nicht mit einem anderen Abspielprogramm wiedergeben.</para>
</question>
<answer>
<para
>&krec; nimmt (momentan) nur in Rohdateien auf. Diese stimmen nicht mit dem Format von WAV-Dateien überein. Zur Konvertierung kann man sox verwenden. Beispiel:</para>
<example id="converting-with-sox">
<title
>Konvertierung von Rohdateien zu WAV-Dateien mit Hilfe von sox</title>
<para
>Um eine Rohdatei, wie sie bei der Aufnahme mit &krec; entsteht, in eine WAV-Datei zu konvertieren, muss man innerhalb eines Konsolenfensters (&konsole;) folgenden Befehl eintippen. Das funktioniert nur dann, wenn <command
>sox</command
> installiert ist. Die Beispieldatei heißt test.raw und soll in test.wav konvertiert werden. Hier muss man selbstverständlich die gewünschten Dateinamen substituieren. </para>
<para
><screen
><prompt
>&percnt;</prompt
><command
>sox -r 44100 -c 2 -s -w test.raw 
test.wav</command
>
</screen
></para>
<para
>Die Optionen <option
>-r 44100 -c 2 -s -w</option
> teilen <command
>sox</command
> mit, dass die Aufnahme mit 44100kHz Samplingrate, mit zwei Kanälen, linear vorzeichenbehaftet kodiert und in 16Bit-Worten erfolgte. Diese Optionen müssen an die tatsächlichen Gegebenheiten angepasst werden - Hinweise findet man auf der Manualseite zu <command
>sox</command
>. </para>
</example>
</answer>
</qandaentry>

</qandaset>
</chapter>


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

<para
>&krec; </para>
<para
>Copyright für das Programm 2002 Arnold Krille<email
>arnold@arnoldarts.de</email
> </para>


<para
>Copyright für die Dokumentation 2002 Arnold Krille <email
>arnold@arnoldarts.de</email
> </para>

<para
>Frank Schütte <email
>F.Schuette@t-online.de</email
></para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-krec">
<title
>Wie man &krec; bekommt</title>
&install.intro.documentation; </sect1>

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

<para
>Zur erfolgreichen Verwendung von &krec; benötigt man &kde; 3.1. </para>

<para
>&krec; sollte sich im Paket kdemultimedia befinden. Da dieses Paket sowohl ein lauffähiges &kde; als auch &arts; voraussetzt, sollte alles in Ordnung sein. </para>


</sect1>

<sect1 id="compilation">
<title
>Kompilierung und Installation</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

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