~ubuntu-branches/ubuntu/jaunty/xvidcap/jaunty-proposed

« back to all changes in this revision

Viewing changes to doc/man/de/xvidcap.1

  • Committer: Bazaar Package Importer
  • Author(s): John Dong
  • Date: 2008-02-25 15:47:12 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080225154712-qvr11ekcea4c9ry8
Tags: 1.1.6-0.1ubuntu1
* Merge from debian-multimedia (LP: #120003), Ubuntu Changes:
 - For ffmpeg-related build-deps, remove cvs from package names.
 - Standards-Version 3.7.3
 - Maintainer Spec

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH xvidcap 1  "April 2007" 
 
2
.SH NAME
 
3
XVidCap \- Nimmt Bereiche der X11 Anzeige als Video auf
 
4
.SH SYNOPSIS
 
5
\fBxvidcap\fR [\-v] [ \-\-mf | \-\-sf ] [\-\-file \fBDateinamens\-Muster\fR |\- ] [\-\-fps \fBEinzelbilder pro Sekunden\fR] [\-\-cap_geometry \fBgeometry\fR] [\-\-rescale \fBProzentuelle Ausgabegr\(:o\(sse\fR] [\-\-quality \fBProzentuelle Qualit\(:at\fR] [\-\-source x11|shm ] [\-\-time \fBmaximale Aufnahmedauer in Sekunden\fR] [\-\-frames \fBMaximale Einzelbilder\fR] [\-\-start_no \fBAnf\(:angliche Bildnummer\fR] [\-\-continue yes|no ] [\-\-gui yes|no ] [\-\-auto] [\-\-codec \fBVideo Codec\fR] [\-\-codec\-help] [\-\-format \fBFormat der Ausgabedatei\fR] [\-\-format\-help] [\-\-audio yes|no ] [\-\-aucodec \fBAudio Codec\fR] [\-\-aucodec\-help] [\-\-audio_in \fBTon Aufnahmeger\(:at\fR |\- ] [\-\-audio_bits \fBTon Bit\-Rate\fR] [\-\-audio_rate \fBTon Abtastrate\fR] [\-\-audio_channels \fBTon Kan\(:ale\fR]
 
6
.SH BESCHREIBUNG
 
7
xvidcap ist ein Werkzeug, welches Bewegungen in einem ausgew\(:ahlten Bereich einer X11 Anzeige speichert. Es kann auf zwei unterschiedliche Arten arbeiten: (1) \fIEinzelbild\-Aufnahme\fR (single\-frame capture) oder (2) \fIFilm\-Aufnahme\fR (multi\-frame capture). Bei der Einzelbild\-Aufnahme macht xvidcap eine konfigurierbare Anzahl von Bildschirmfotos pro Sekunde und speichert sie als einzelne Bild\-Dateien. Bei der Film\-Aufnahme macht xvidcap ebenfalls eine Anzahl von Bildschirmfotos pro Sekunde, kodiert sie aber zur Laufzeit zu einem Film und speichert diesen in einer einzelnen Video\-Datei. Ton\-Aufnahme ist bei Einzelbild\-Aufnahme nicht m\(:oglich.
 
8
.PP
 
9
Die Einzelbild\-Aufnahme kann unter Umst\(:anden geeigneter sein, wenn die Bilder vor dem Kodieren bearbeitet werden sollen oder wenn Video Codecs ben\(:otigt werden, die xvidcap nicht unterst\(:utzt. Die einzelnen Bilder k\(:onnen sp\(:ater mit Werzeugen wie ffmpeg, mendocer oder transcode zu einem Film kodiert werden.
 
10
.PP
 
11
F\(:ur weitere Hilfe, Verbesserungsvorschl\(:age oder Fehlerberichte wenden Sie sich bitte an http://www.sourceforge.net/projects/xvidcap/
 
12
.SH OPTIONEN
 
13
Dieses Program folgt der g\(:angigen GNU Befehlszeilen\-Syntax bei der lange Optionen mit zwei Bindestrichen (\fB\-\-\fR) beginnen. Folgende Optionen sind m\(:oglich:
 
14
.TP 
 
15
\fB\-v\fR
 
16
L\(:asst xvidcap ausf\(:uhrlichere Meldungen im Terminal ausgeben. Dies wird detailiertere Informationen bzgl. Einstellungen, Codecs, Aufnahme\-Leistung etc. auflisten. Meldungen wie "missing XX milli secs .." w\(:ahrend der Aufnahme bedeuten, dass mangels Rechenleistung Einzelbilder bei der Aufnahme verloren gehen. Dies f\(:uhrt zu einem Video, welches bei der Wiedergabe zu schnell abgespielt wird. Merke jedoch, dass die ausf\(:uhrlichen Meldungen xvidcap verlangsamen und den Verlust von Einzelbildern sogar \fIverursachen\fR k\(:onnen. Versuchen Sie die ausf\(:uhrlichen Meldungen abzuschalten und den Bild\-Verlust Messer im Auge zu behalten.
 
17
.TP 
 
18
\fB\-\-mf\fR | \fB\-\-sf\fR
 
19
xvidcap versucht zu erkennen welche Art von Aufnahme erw\(:unscht ist. Bei der Angabe von \fB\-\-file test.avi\fRxvidcap wird es davon ausgehen, dass die die Film\-Aufnahme ist. Mit diesem Schalter kann die gew\(:unschte Art der Aufnahme explizit angegeben werden. Wenn, zum Beispiel, in den gespeicherten Einstellungen die Film\-Aufnahme als Standard eingestellt ist, wird \fBxvidcap \-\-sf\fR daf\(:ur sorgen, dass xvidcap f\(:ur die Einzelbild\-Aufnahme gestartet wird. Film\-Aufnahme ist programm\-seitig als Standard eingestellt.
 
20
.TP 
 
21
\fB\-\-file \fIDateinamens\-Muster\fB\fR
 
22
Dateiname oder Muster zur Verwendung beim Abspeichern der aufgenommenen Bilder. Ein Muster enth\(:alt Formatierungsangaben wie sie von printf() verwendet werden (s. \fBman printf\fR), um es zu erm\(:oglichen, den Dateinamen hochzuz\(:ahlen, z. B. \fB\-\-file out\-%02d.xwd\fR. Bei der Einzelbild\-Aufnahme ist dies n\(:otig. xvidcap wird das erste Vorkommen einer printf() Formatierungs\-Information durch die Nummer des aktuellen Einzelbilds ersetzen. Im obigen Beispiel etwa werden Dateien \fBout\-00.xwd\fR, \fBout\-01.xwd\fR, \fBout\-02.xwd\fRetc. geschrieben. Die Anfangsnummer der Nummerierung kann mit \fB\-\-start_no\fRangegeben werden, s. oben.
 
23
 
 
24
Film\-Aufnahmen ben\(:otigen kein hochz\(:ahlbaren Dateinamen. Wenn dennoch ein Muster im Dateinamen enthalten ist, wie etwa \fB\-\-file mymovie\-%d.mpeg\fR , wird xvidcap die Formatierungsangabe durch die Nummer der aktuellen Aufnahme\-Sitzung (die Nummerierung beginnt immer bei Null) ersetzen. Dies erm\(:oglicht es, diese Nummer manuell heraufzusetzen oder die automatische Aufnahme\-Fortsetzung zu verwenden (s. unten bei \fB\-\-continue\fR ), um damit eine Serie von Filmen zu erzeugen.
 
25
.TP 
 
26
\fB\-\-fps \fIEinzelbilder pro Sekunden\fB\fR
 
27
Gibt die Anzahl von Einzelbildern (Frames) an, die pro Sekunde aufgenommen werden sollen. Diese Option akzeptiert Fliesskomma\-Werte als Parameter, was es erm\(:oglicht, sehr kleine Raten anzugeben (z. B. \fB\-\-fps 0.5\fR ), um etwa ein Bild nur alle zwei Sekunden aufzunehmen. Dies ist allerdings nur bei der Einzelbildaufnahme m\(:oglich, da die bei der Film\-Aufnahme verwendeten Video Codecs in der Regel nur bestimmte Bildraten als g\(:ultig akzeptieren. Fliesskomma\-Werte f\(:ur Codecs wie MPEG1, die nur ganz bestimmte Raten zulassen, sind in dieser Version deaktiviert. Es existiert eine Inkonsistenz bei der Behandlung von Fliesskomma Bildraten zwischen libavcodec und xvidcap . In diesen F\(:allen werden nur ganzzahlige Bildraten akzeptiert.
 
28
.TP 
 
29
\fB\-\-cap_geometry \fIgeometry\fB\fR
 
30
Gibt den Aufnahmebereich an wie eine Fenstergeometrie etwa f\(:ur xterm, also wie folgt: \fIBreite\fRx\fIH\(:ohe\fR+\fIHorizontale Position\fR+\fIVertikale Position\fR
 
31
 
 
32
Diese Option \(:uberschreibt die Standard\-Einstellung f\(:ur Breite und H\(:ohe des Aufnahmebereichs. Verwenden Sie statt dieser Option die Bereichsw\(:ahler\-Schaltfl\(:ache, um die Gr\(:osse an die eines bestehenden Fensters anzugleichen. Aufnahmebereiche kleiner 20 x 20 Bildpunkte scheinen mit den meisten bei der Film\-Aufnahme verwendeten Video Codecs nicht gut zu funktionieren.
 
33
.TP 
 
34
\fB\-\-rescale \fIProzentuelle Ausgabegr\(:o\(sse\fB\fR
 
35
\(:Andert die Gr\(:osse des ausgegebenen Films relativ zur Eingangsgr\(:osse des Aufnahmebereichs. Ein Wert von bspw. \fB25\fR erzeugt ein Video, dessen Bilder eine Gr\(:osse von 25 Prozent der Originalgr\(:osse haben. Die Aufnahme\-Verkleinerung funktioniert nicht mit XWD Ausgabe.
 
36
.TP 
 
37
\fB\-\-quality \fIProzentuelle Qualit\(:at\fB\fR
 
38
Geben Sie einen Wert zwischen \fB0\fR und \fB100\fR an f\(:ur die Qualit\(:at der Kodierung. Der Vorgabewert liegt bei \fB90\fR. Bedenken Sie, dass sich die Auswirkungen von Werten unter \fB100\fR mit Version 1.1.5 ge\(:andert haben.
 
39
.TP 
 
40
\fB\-\-source\fR x11|shm
 
41
Schaltet die Verwendung der X11 "shared memory" Erweiterung an oder aus. Wenn die Erweiterung unterst\(:utzt wird, verwendet xvidcap sie per Vorgabe. Daf\(:ur m\(:ussen X Server und Client jedoch auf dem gleichen Rechner laufen. Ist dies nicht der Fall, m\(:ussen Sie die Verwendung ausschalten, etwa per \fB\-\-source x11\fR.
 
42
.TP 
 
43
\fB\-\-time \fImaximale Aufnahmedauer in Sekunden\fB\fR
 
44
Gibt die maximale Dauer einer einzelnen Aufnahmesitzung an. Wenn der Wert auf \fB0\fR daf\(:ur sorgen, dass xvidcap die Aufnahme fortsetzen bis sie interaktiv beendet wird. Bei jedem anderen Wert wird die Aufnahme nach der angegebenen Anzahl Sekunden automatisch beendet. Dieser Parameter kolliediert ggf. mit \fB\-\-frames\fR (s. unten). Wenn beide spezifiziert sind, wird xvidcap die Aufnahme bei der ersten eintretenden Begrenzung beendet. Das Programm akzeptiert Fliesskomma\-Werte wie \fB2.5\fR.
 
45
.TP 
 
46
\fB\-\-frames \fIMaximale Einzelbilder\fB\fR
 
47
Beendet die Aufnahme automatisch nach der angegebenen Anzahl Einzelbilder. Wenn der Wert auf \fB0\fR die Aufnahme fortsetzen bis sie interaktiv beendet wird, s. \fB\-\-time\fR oben.
 
48
.TP 
 
49
\fB\-\-start_no \fIAnf\(:angliche Bildnummer\fB\fR
 
50
Geben Sie hier die Zahl an, die als erstes bei der Einzelbild\-Aufnahme f\(:ur die Nummerierung von Einzelbildern und Dateien verwendet werden soll. Der Vorgabewert ist \fB0\fR. Dieser Parameter wird nur von der Einzelbild\-Aufnahme verwendet. Die Z\(:ahlung der Video Dateien bei der Film\-Aufnahme unter Verwendung von \fB\-\-continue\fR beginnt immer bei
 
51
.TP 
 
52
\fB\-\-continue\fR yes|no
 
53
Wenn bei der Film\-Aufnahme eine maximale Aufnahmedauer oder eine maximale Anzahl von Einzelbildern angegeben ist und der Dateiname hochz\(:ahlbar ist (s. \fB\-\-file\fR oben), kann xvidcap die Aufnahme nach der automatischen Beendigung ebenso automatisch mit einer neuen Zieldatei fortsetzen. Dies \(:andert das Verhalten von \fB\-\-time\fR und \fB\-\-frames\fR da die Aufnahme beim Erreichen der angegebenen Begrenzungen nicht l\(:anger komplett stoppt, sondern ein neues Video beginnt. Diese Funktionalit\(:at ist besonders dann n\(:utzlich, wenn man die Aufnahme automatisch in vorgegebene Abschnitte (etwa zu je f\(:unf Minuten) st\(:uckeln m\(:ochte. Wenn keine Option \fB\-\-continue\fR angegeben ist, verwendet xvidcap f\(:ur die automatische Fortsetzung den Vorgabewert \fBno\fR. Bei der Einzelbild\-Aufnahme ist diese Funktionalit\(:at ebenfalls abgeschaltet, weil hier der hochz\(:ahlbare Dateiname f\(:ur die Nummerierung der Einzelbilder verwendet wird.
 
54
.TP 
 
55
\fB\-\-gui\fR yes|no
 
56
Starte xvidcap mit oder ohne grafisches Benutzerinterface. Ein Betrieb ohne grafisches Benutzerinterface startet automatisch eine einzelne Aufnahmesitzung. Diese kann entweder durch die Verwendung von \fB\-\-time\fR oder \fB\-\-frames\fRoder durch die Tastenkombination CTRL\-C beendet werden. \\t Damit beendet sich auch das Programm.
 
57
.TP 
 
58
\fB\-\-auto\fR
 
59
xvidcap kann Parameter f\(:ur Ausgabe\-Dateiformat, Video\- und Audio Codec automatisch erkennen. Wenn eine dieser Einstellungen als fest konfigurierter Wert in den Einstellungen abgespeichert ist, kann sie f\(:ur sie wieder die automatische Erkennung gew\(:ahlt werden, durch Spezifikation des Parameter \fBauto\fR bei irgendeiner der Optionen \fB\-\-format\fR, \fB\-\-codec\fR oder \fB\-\-aucodec\fR. Diese Option hier ist eine Kurzfassung, die f\(:ur alle drei Einstellungen automatische Erkennung aktiviert.
 
60
.TP 
 
61
\fB\-\-codec \fIVideo Codec\fB\fR
 
62
Setzt explizit einen Codec ggf. anstelle des automatisch erkannten oder in den Einstellungen gespeicherten.
 
63
.TP 
 
64
\fB\-\-codec\-help\fR
 
65
Zeigt eine Liste unterst\(:utzter Codecs.
 
66
.TP 
 
67
\fB\-\-format \fIFormat der Ausgabedatei\fB\fR
 
68
Setzt explizit ein Dateiformat ggf. anstelle des automatisch erkannten oder in den Einstellungen gespeicherten.
 
69
.TP 
 
70
\fB\-\-format\-help\fR
 
71
Zeigt eine Liste unterst\(:utzter Ausgabe\-Dateiformate.
 
72
.SH "OPTIONEN F\(:uR TON\-AUFNAHME"
 
73
Die folgenden Optionen beziehen sich auf die Ton\-Aufnahme, die nur bei Film\-Aufnahme m\(:oglich ist. Dabei k\(:onnen Kl\(:ange entweder von einem kompatiblen Audio\-Ger\(:at (z.B. \fB/dev/dsp\fR) oder von STDIN aufgenommen werden, s. \fB\-\-audio_in\fR unten.
 
74
.TP 
 
75
\fB\-\-audio\fR yes|no
 
76
Schaltet Ton\-Aufnahme an oder aus und verwendet ggf. Vorgabewerte oder gespeicherte Einstellungen. Wenn Ton\-Aufnahme unterst\(:utzt wird, ist dies bei der Film\-Aufnahme per Vorgabewert angeschaltet.
 
77
.TP 
 
78
\fB\-\-aucodec \fIAudio Codec\fB\fR
 
79
Setzt explizit einen Ton Codec ggf. anstelle des automatisch erkannten oder in den Einstellungen gespeicherten.
 
80
.TP 
 
81
\fB\-\-aucodec\-help\fR
 
82
Zeigt eine Liste unterst\(:utzter Ton Codecs.
 
83
.TP 
 
84
\fB\-\-audio_in \fITon Aufnahmeger\(:at\fB|\-\fR
 
85
W\(:ahlt als Ton\-Eingang entweder das angegebene Ger\(:at oder STDIN. Letzteres erlaubt es, die Aufnahme mit einer existierenden Ton\-Aufnahme zu hinterlegen. Dazu verwendet man einen Aufruf wie den folgenden. Der Vorgabewert ist \fB/dev/dsp\fR.
 
86
 
 
87
cat irgendein.mp3 | xvidcap \-\-audio_in \-
 
88
.TP 
 
89
\fB\-\-audio_bits \fITon Bit\-Rate\fB\fR
 
90
Setzt die gew\(:unschte Bit Rate. Der Vorgabewert ist \fB64000\fR Bit. Bei der Verwendung von STDIN als Ton\-Eingang wird die Quelle ggf. konvertiert.
 
91
.TP 
 
92
\fB\-\-audio_rate \fITon Abtastrate\fB\fR
 
93
Setzt die gew\(:unschte Abtastrate. Der Vorgabewert ist \fB44100\fR Hz. Bei der Verwendung von STDIN als Ton\-Eingang wird die Quelle ggf. konvertiert.
 
94
.TP 
 
95
\fB\-\-audio_channels \fITon Kan\(:ale\fB\fR
 
96
Setzt die gew\(:unschte Anzahl von Ton Kan\(:alen. Der Vorgabewert ist \fB2\fR f\(:ur stereo. Jeglicher Wert \(:uber \fB2\fR ist wahrscheinlich nur bei STDIN als Ton\-Quelle und einer 5\-Kanal AC Audio Datei oder sehr guter und seltener Aufnahme\-Ausstattung sinnvoll.
 
97
.SH AUTOREN
 
98
xvidcap wurde entwickelt von Rasca Gmelch und Karl H. Beckers.
 
99
.PP
 
100
Diese manpage wurde von Karl H. Beckers karl.h.beckers@gmx.net f\(:ur das xvidcap Project geschrieben.
 
101
.PP
 
102
Karl H. Beckers 
 
103
.PP
 
104
Die Genehmigung dieses Dokument zu kopieren, verteilen und/oder zu ver\(:andern wird erteilt im Rahmen der GNU Free Documentation License Version 1.1 oder jeglicher sp\(:aterer Version, die durch die Free Software Foundation herausgegeben wurde; ohne unver\(:anderliche Abschnitte, Voder\- oder R\(:uckseiten Texte.