# Das Handbuch zu &krec;

## Einführung

### Warum &krec; programmiert wurde

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.

### Was &krec; kann

&krec; ist ein einfaches Programm. Es stellt eine Verbindung zum &arts;-Server her und leitet die empfangenen Daten in eine Datei um. 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).

## Verwendung von &krec;

Dieses Kapitel beschreibt die Verwendung von &krec;. &krec; kann auf mehrere Arten verwendet werden, daher besteht dieses Dokument aus mehreren HOWTO-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.

Bildschirmfoto von &krec; Bildschirmfoto von &krec; direkt nach dem Start.

### Aufnahme einer einzigen Datei

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.

1. 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.

2. 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 in_soundcard verbunden sein. Falls er nicht ausgewählt werden kann, stimmt vermutlich die Konfiguration nicht (kein full-duplex oder so ähnlich).

3. Falls soweit alles erfolgreich war, sollte man Bewegung innerhalb von &krec; feststellen — 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.

4. Nun benötigt man noch eine Datei, in der die Aufnahme gespeichert werden soll. Dazu wählt man im Menü Datei Neue Datei 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.

5. Jetzt kann die Aufnahme beginnen. Mit dem großen roten Knopf in der Werkzeugleiste oder im Menü Abspielen Aufnahme durch Drücken von R startet die Aufnahme. Genauso kann die Aufnahme angehalten werden über den Eintrag im Menü Abspielen (oder mit der Taste S).

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

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

### Die Aufnahme von mehreren Dateien

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).

Ich setze voraus, dass man mit &arts; bereits gearbeitet hat und daher einige Fakten zum Thema Audioaufnahmen 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.

Dieser Überblick 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 simple-usage folgen und beachten, dass man mehrere Dateien gleichzeitig geöffnet haben kann. Andernfalls sollte man hier weiterlesen...

1. 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 out_soundcard aufnimmt, kann man Abspielen Durchspielen 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.

2. Mehrere Dateien gleichen Namens werden erzeugt, wenn man mit Datei Neue Sitzung eine Sitzung erzeugt. Man wählt den Pfad und den Dateinamen, der dann mit der Nummer der Aufnahme und einer Dateiendung vervollständigt wird.

3. Danach muss man dennoch die Dateien einzeln erzeugen, aber das geschieht, indem man Neue Datei aus dem Kontextmenü wählt. Man kann beliebig viele Dateien erzeugen.

4. Der Rest ist einfach. Man wählt die gewünschte Datei zur Aufnahme aus und nimmt auf...

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...

### Weitere Tipps und Hinweise zur Verwendung

Einige Dinge wären noch zu erwähnen und einige genauer zu erläutern.

#### Verwendung von Durchspielen

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

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

#### Verwendung des Kompressors

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.

Man kann einen Test durchführen, indem man mit Durchspielen in das Mikrofon spricht. Die Unterschiede sind augenfällig.

#### Zwischen mehreren Dateien umschalten

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 `artscat file*.raw` hintereinander abspielt, kann man keine Sprünge hören.

### Interne Funktionsweise

Einige Dinge über die Sound-Verbindungen in &krec;.

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.

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.

Falls man Durchspielen aktiviert, wird der Effekt-Stapel auch mit AMAN_PLAY verbunden. Auf diese Weise passiert alles innerhalb des &arts;-Servers...

## Befehlsreferenz

### Das Hauptfenster von &krec;

#### Das Menü Datei

N Datei Neue Datei

- Erzeugt eine neue Datei zur Aufnahme in eine einzelne Datei

&Ctrl;N Datei Neue Sitzung

- Erzeugt eine neue Sitzung für mehrere Aufnahmen

&Ctrl;Q Datei Beenden

- Beendet &krec;

#### Das Menü Abspielen

P Abspielen Abspielen

- Spielt die ausgewählte Datei ab.

R Abspielen Aufnahme

- Startet die Aufnahme in die gewählte Datei.

S Abspielen Stopp

- Beendet die Aufnahme.

&Ctrl;P Abspielen Durchspielen

- Verbindet den Eingang mit dem Ausgang, damit man bei der Aufnahme mithören kann. (&krec;::In und &krec;::Out im Audio-Manager von &arts;-Kontrolle)

  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)

#### Das Menü Einstellungen

Einstellungen Zeige Start-Fenster

- Schaltet das Start-Fenster mit der Kurzanleitung an und aus.

#### Das Menü Hilfe

&help.menu.documentation;

### Das Start-Fenster

Das Start-Fenster besitzt nahezu den gleichen Inhalt wie der &ktip;-Dialog.

## Fragen und Antworten

&reporting.bugs; &updating.documentation;

Ich kann meine mit &krec; aufgenommenen Dateien nicht mit einem anderen Abspielprogramm wiedergeben.

&krec; nimmt (momentan) nur in Rohdateien auf. Diese stimmen nicht mit dem Format von WAV-Dateien überein. Zur Konvertierung kann man sox verwenden. Beispiel:

### Konvertierung von Rohdateien zu WAV-Dateien mit Hilfe von sox

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 `sox` 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.

    %sox -r 44100 -c 2 -s -w test.raw
    test.wav

Die Optionen `-r 44100 -c 2 -s -w` teilen `sox` 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 `sox`.

## Mitwirkende und Lizenz

&krec;

Copyright für das Programm 2002 Arnold Krillearnold@arnoldarts.de

Copyright für die Dokumentation 2002 Arnold Krille arnold@arnoldarts.de

Frank Schütte F.Schuette@t-online.de

&underFDL; &underGPL;

## Installation

### Wie man &krec; bekommt

&install.intro.documentation;

### Voraussetzungen

Zur erfolgreichen Verwendung von &krec; benötigt man &kde; 3.1.

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

### Kompilierung und Installation

&install.compile.documentation;
&documentation.index;