tvtime.xml.5

Linux下的电视卡播放软件源码。tvtime软件

.\" Man page for tvtime.xml
.\" Copyright (c) 2003, 2004  Billy Biggs
.\" German translation (c) 2004  Ingo van Lil
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH tvtime.xml 5 "Oktober 2004" "tvtime 1.0RC1"

.SH NAME
tvtime.xml \- tvtime\-Konfigurationsdatei

.SH 蹷ERSICHT

.I ~/.tvtime/tvtime.xml
.br
.I /etc/tvtime/tvtime.xml
.br

.SH BESCHREIBUNG

Die Datei
.I tvtime.xml
ist die zentrale Konfigurationsdatei f黵
.BR tvtime .
Sie enth鋖t alle Standardeinstellungen und Tastenbindungen.  Die Datei wird
zur Laufzeit durch
.B tvtime
aktualisiert, um Einstellungen f黵 den n鋍hsten Programmstart zu erhalten.
Daher sollten Sie die Datei nicht bearbeiten, w鋒rend
.B tvtime
l鋟ft, da Ihre 膎derungen sonst 黚erschrieben werden k鰊nten.

Die globale Syntax sieht folgenderma遝n aus:

    <?xml version="1.0"?>
    <!DOCTYPE tvtime PUBLIC "-//tvtime//DTD tvtime 1.0//EN"
      "http://tvtime.sourceforge.net/DTD/tvtime1.dtd">
    <tvtime xmlns="http://tvtime.sourceforge.net/DTD/">
    </tvtime>

Den DTD und weitere Informationen 黚er die XML\-Konfigurationsdateien finden
Sie unter
.nh
.UR http://tvtime.sourceforge.net/DTD/
http://tvtime.sourceforge.net/DTD/
.UE
.hy

.SH OPTIONEN

.B tvtime
bietet eine gro遝 Menge an Optionen.  Die <option>\-Tags sollten im
<tvtime>\-Tag eingeschlossen sein.

Die folgende Liste enth鋖t alle Optionen, deren Standardwerte und eine
Beschreibung ihrer Wirkung:

.TP
<option name="Verbose" value="0"/>
Wenn diese Option auf
.IR 1
gesetzt wird, startet
.B tvtime
im wortreichen Modus, in dem Informations\- und Warnmeldungen auf dem
Standardfehlerkanal ausgegeben werden.  Andernfalls werden nur kritische
Fehlermeldungen angezeigt.

.TP
<option name="V4LDevice" value="/dev/video0"/>
Legt das zu verwendende video4linux\-Ger鋞 fest.  Standardm溥ig wird
.IR /dev/video0
verwendet.

.TP
<option name="V4LInput" value="0"/>
Legt die video4linux\-Quellennummer fest.  Standardwert ist
.IR 0 .
Die meisten Karten besitzen eine ganze Reihe von Quellen, so ist z. B. bei
einer WinTV\-Karte
.I Quelle 0
der TV\-Empf鋘ger und
.I Quelle 1
der Composite Video\-Eingang.

Die Videoquelle kann auch zur Laufzeit mit dem Kommando
.B toggle_input
ge鋘dert werden, das im Normalfall mit der Taste \(lqi\(rq ausgel鰏t wird.

.TP
<option name="Norm" value="NTSC"/>
Stellt den TV\-Empf鋘ger auf die angegebene Fernsehnorm ein (Standardwert ist
.IR NTSC ).
G黮tige Werte sind:
.TS
nokeep tab (@);
l l.
\(bu@NTSC
\(bu@NTSC\-JP
\(bu@SECAM
\(bu@PAL
\(bu@PAL\-Nc
\(bu@PAL\-M
\(bu@PAL\-N
\(bu@PAL\-60
.TE

.TP
<option name="SaveAndRestorePictureSettings" value="1"/>
Diese Option legt fest, ob
.B tvtime
die Bildeinstellungen automatisch beim Kanalwechsel oder beim Beenden des
Programms speichern soll.

.TP
<option name="AudioMode" value="stereo"/>
Diese Option speichert den zuletzt verwendeten Audio\-Modus, um diesen beim
n鋍hsten Programmstart wiederherzustellen.  M鰃liche Werte sind "mono",
"stereo", "lang1", "lang2" oder "sap".

.TP
<option name="AudioBoost" value="-1"/>
Diese Option speichert die Lautst鋜ke der TV\-Karte in Prozent.  Im Normalfall
鋘dert
.B tvtime
die Audio\-Lautst鋜ke der TV\-Karte 黚erhaupt nicht, aber in manchen F鋖len
ist die Werkseinstellung nicht brauchbar oder wird von anderen Anwendungen
ver鋘dert und kann mit dieser Option auf einen sinnvollen Wert konfiguriert
werden.
Verwenden Sie
.IR -1 ,
um die Lautst鋜ke nicht durch
.B tvtime
setzen zu lassen.

.TP
<option name="ShowCC" value="0"/>
Diese Option aktiviert oder deaktiviert die Dekodierung von Closed
Caption\-Untertiteln f黵 H鰎gesch鋎igte in NTSC\-Regionen.

.TP
<option name="ColourInvert" value="0"/>
Diese Option speichert den Status des Farbinvertierungsfilters bis zum
n鋍hsten Programmstart.

.TP
<option name="MirrorInput" value="0"/>
Diese Option speichert den Status des Spiegelfilters bis zum n鋍hsten
Programmstart.

.TP
<option name="Frequencies" value="US-Cable"/>
W鋒lt die zu verwendende Frequenztabelle. M鰃liche Werte:
.TS
nokeep tab (@);
l l.
\(bu@us-cable
\(bu@us-broadcast
\(bu@japan-cable
\(bu@japan-broadcast
\(bu@europe
\(bu@australia
\(bu@australia-optus
\(bu@newzealand
\(bu@france
\(bu@russia
.TE

.TP
<option name="NTSCCableMode" value="Standard"/>
Es gibt in den USA zwei vom Normalfall abweichende NTSC\-Kabelstandards: IRC
und HRC. Bei IRC liegen die Kan鋖e 5 und 6 auf anderen Frequenzen als sonst,
bei HRC sind zus鋞zlich noch alle Frequenzen um 1,25 MHz nach oben verschoben.
M鰃liche Werte:
.IR Standard ,
.IR IRC " oder "
.IR HRC .
IRC und HRC werden nur sehr selten verwendet.


.TP
<option name="CheckForSignal" value="1"/>
Aktiviert oder deaktiviert die Signalpr黤ung.  Wenn Sie nicht gerade eine ganz
furchtbar schlechte TV\-Karte haben, sollte es keinen Grund geben, diese
Funktion abzuschalten.  Die Signalpr黤ung ist eine notwendige Voraussetzung
f黵 den Sendersuchlauf.

.TP
<option name="InputWidth" value="720"/>
Legt die horizontale Aufl鰏ung des V4L\-Eingangssignals fest.  Ein h鰄erer
Wert liefert ein besseres Bild, ein niedrigerer Wert verringert die ben鰐igte
Rechenzeit.  Wenn Sie eine langsame CPU besitzen (etwa 500 MHz oder weniger),
sollten Sie einen Wert von
.IR 480 " oder " 400
verwenden.  F黵 h鯿hste Bildqualit鋞 verwenden Sie
.IR 720 " oder " 768
Pixel.  Die meisten TV\-Karten k鰊nen das Eingangssignal nicht mit mehr als
.I 768
Pixeln pro Bildzeile abtasten.

.TP
<option name="XMLTVFile" value="none"/>
Tragen Sie hier den Namen der Datei ein, aus der Programminformationen im
XMLTV\-Format zur Anzeige im OSD gelesen werden sollen.  Verwenden Sie "none",
wenn Sie XMLTV nicht verwenden m鯿hten.

.TP
<option name="XMLTVLanguage" value="none"/>
W鋒lt die bevorzugte Sprache f黵 XMLTV\-Daten.  Setzen Sie dies auf den
zweibuchstabigen Sprachcode gem溥 ISO 639 (z. B. "de" f黵 Deutsch), um
XMLTV\-Daten in der gew鋒lten Sprache anzuzeigen, wenn vorhanden.

.TP
<option name="UseXDS" value="0"/>
Setzen Sie diese Option auf
.IR 1 ,
um die Dekodierung von XDS\-Programminformationen zu aktivieren.  Diese
Funktion ist nur in NTSC\-Gebieten verf黦bar.  XDS wird verwendet, um
Informationen 黚er das aktuelle Programm (Name des Senders und des
Netzwerkes, dem er angeh鰎t, Senderk黵zel und manchmal Informationen 黚er die
laufende Sendung) zu 黚ertragen.

.TP
<option name="VBIDevice" value="/dev/vbi0"/>
Legt das zu verwendende VBI\-Ger鋞 fest.

.TP
<option name="MixerDevice" value="/dev/mixer:line"/>
Legt Mixerger鋞 und \-kanal fest.  Das Format dieser Einstellung ist
name:kanal.  G黮tige Kan鋖e:

.nh
.IR vol ", " bass ", " treble ", " synth ", " pcm ", " speaker ", "
.IR line ", "  mic ", "  cd ", "  mix ", "  pcm2 ", " rec ", " 
.IR igain ", "  ogain ", "  line1 ", "  line2 ", "  line3 ", "
.IR dig1 ", "  dig2 ", "  dig3 ", "  phin ", " phout ", " video ", "
.IR radio ", "  monitor
.hy

.TP
<option name="Widescreen" value="0"/>
Setzen Sie diese Option, um
.B tvtime
im 16:9\-Breitbildmodus zu starten.

.TP
<option name="WindowGeometry" value="0x576"/>
Legt die Gr鲞e des Ausgabefensters fest.  Wenn die Breite mit 0 angegeben
wird, wird die passende Breite zur Fensterh鰄e berechnet.  Bei einem
4:3\-Bildformat und quadratischen Pixeln wird standardm溥ig eine Fenstergr鲞e
von
.I 768\[mu]576
Pixeln verwendet.

.TP
<option name="Overscan" value="0.0"/>
Gibt die Gr鲞e des 黚erstehenden Bildbereiches in Prozent an.  Analoge
Fernseher verwenden normalerweise etwa 10%, dadurch ist allerdings ein gro遝r
Teil des Bildes nicht zu sehen.  Wenn Sie m鯿hten, da