.\" Man page for tvtime-command
.\" 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-command 1 "Oktober 2004" "tvtime 1.0RC1"

.SH NAME
tvtime\-command \- Steuerung einen laufenden
.BR tvtime \-Prozesses.

.SH SYNTAX

.B tvtime\-command
.RI [\| KOMMANDO "\|] ..."

.SH BESCHREIBUNG

.B tvtime\-command
ermglicht dem Benutzer, einem laufenden
.BR tvtime \-Proze
Kommandos zu schicken, um diesen zu steuern.  Es kommuniziert durch einen
FIFO (eine "benannte Pipe") mit
.BR tvtime .
Kommandos werden nicht nach Gro\-/Kleinschreibung unterschieden und in der
Reihenfolge ihrer Angabe ausgefhrt.

.SH KOMMANDOS

.TP
.B AUTO_ADJUST_PICT
Setzt die Bildeinstellungen (Helligkeit, Kontrast, Farbton und Sttigung) auf
die ihre Standardwerte zurck.

.TP
.B AUTO_ADJUST_WINDOW
Pat die Fenstergre dem Inhalt an.  Setzen Sie diese Funktion ein, wenn sie
die Fenstergre von
.B tvtime
verstellt haben und sie wieder ein dem Bild angepates Fenster mit dem
Seitenverhltnis 4:3 haben mchten.

.TP
.B BRIGHTNESS_DOWN
Verringert die Helligkeit der Bildquelle.

.TP
.B BRIGHTNESS_UP
Erhht die Helligkeit der Bildquelle.

.TP
.B CHANNEL_[0\-9]
Simuliert einen Tastendruck auf dem Ziffernblock.

.TP
.B CHANNEL_ACTIVATE_ALL
Reaktiviert alle Kanle der Senderliste.  Benutzen Sie diese Funktion, um die
Senderliste zu reinitialisieren, bevor sie den Kanalscanner starten, wenn
Ihnen Sender fehlen oder oder wenn neue Sender hinzugekommen sind.

.TP
.B CHANNEL_DEC / CHANNEL_DOWN
Wechselt zum nchstniedrigeren Kanal in der Senderliste.

.TP
.B CHANNEL_INC / CHANNEL_UP
Wechselt zum nchsthheren Kanal in der Senderliste.

.TP
.B CHANNEL_JUMP / CHANNEL_PREV
Springt zum zuletzt eingestellten Sender zurck.  Dies ist sinnvoll um
zwischen zwei Sendern hin\- und herzuspringen, die in der Senderliste weit
auseinanderliegen.

.TP
.B CHANNEL_RENUMBER
Verschiebt den aktuellen Kanal auf einen anderen Senderspeicher.  Diese
Funktion tauscht den Speicherplatz des gerade aktiven Kanals mit dem, dessen
Nummer sie eingeben.  Auf diese Weise knnen Sie die Senderliste ihren
persnlichen Vorlieben anpassen.

.TP
.B CHANNEL_SAVE_TUNING
Schreibt die momentane Feineinstellung als benutzerdefinierten Kanal in die
Senderliste.

.TP
.B CHANNEL_SCAN
Durchluft die Senderliste ab der momentanen Position und deaktiviert alle
Kanle, auf denen kein Signal empfangen wird.  Dieses Kommando ist nur
verfgbar, wenn die Signalprfung aktiviert ist.

.TP
.B CHANNEL_SKIP
Markiert den aktuellen Kanal als aktiviert oder deaktiviert.  Auf diese Weise
knnen Sie ihre Senderliste manuell durchsuchen und solche mit vorhandenem
Signal aktivieren oder doppelt vorhandene Sender deaktivieren.

.TP
.B COLOUR_DOWN / COLOR_DOWN / SATURATION_DOWN
Verringert die Farbsttigung des Bildsignals.  Dadurch wird das Bild weniger
farbintensiv, bis es komplett schwarzwei ist.

.TP
.B COLOUR_UP / COLOR_UP / SATURATION_UP
Erhht die Farbsttigung des Bildsignals.  Dadurch wird das Bild
farbintensiver.

.TP
.B CONTRAST_DOWN
Verringert die Kontrasteinstellung des Bildsignals.

.TP
.B CONTRAST_UP
Erhht die Kontrasteinstellung des Bildsignals.

.TP
.B DISPLAY_INFO
Blendet das OSD mit Information zum aktuellen Sender und der Uhrzeit ein.

.TP
.B DISPLAY_MESSAGE
Zeigt eine Nachricht am unteren Bildrand an.  Dies ist ntzlich fr Cronjobs
oder andere Skripte, um Benachrichtigungen an einen tvtime-Nutzer zu
schicken.

.TP
.B DOWN
Dieses Kommando wechselt entweder zum nchstniedrigeren Sender oder bewegt den
Cursor eine Menzeile nach unten, je nachdem, ob das Men aktiv ist oder
nicht.  Es sollte in Verbindung mit den Kommandos LEFT, RIGHT und UP verwendet
werden.

.TP
.B ENTER
Simuliert einen ENTER\-Tastendruck.  Verwenden Sie dies, um den Sender zu
wechseln:
.br
\h'4n'tvtime-command channel_1 channel_5 enter
.br
wechselt auf Sender 15.

.TP
.B FINETUNE_DOWN
Verringert die Feineinstellung fr den aktuellen Sender.

.TP
.B FINETUNE_UP
Erhht die Feineinstellung fr den aktuellen Sender.

.TP
.B HUE_DOWN
Verringert die Farbton\-Einstellung fr den aktuellen Sender.

.TP
.B HUE_UP
Erhht die Farbton\-Einstellung fr den aktuellen Sender.

.TP
.B KEY_EVENT
Simuliert einen Tastendruck in
.BR tvtime .
Auf diese Weise knnen komplexe Operationen mit der Fernbedienung
durchgefhrt werden, indem Sie
.BR tvtime s
Tastenbindungssystem verwenden.

.TP
.B LEFT
Dieses Kommando verringert entweder die Lautstrke oder geht eine Menebene
zurck, je nachdem, ob das Men aktiv ist oder nicht.  Es sollte in Verbindung
mit den Kommandos RIGHT, UP und DOWN genutzt werden.

.TP
.B LUMA_DOWN
Verringert den Farbkorrekturwert.

.TP
.B LUMA_UP
Erhht den Farbkorrekturwert.

.TP
.B MENU_DOWN
Bewegt den Cursor um einen Menzeile nach unten.

.TP
.B MENU_ENTER
Whlt den markierten Meneintrag oder wechselt zur nchsten Menebene.

.TP
.B MENU_EXIT
Verlt das Men.

.TP
.B MENU_LEFT
Geht eine Menebene zurck.

.TP
.B MENU_RIGHT
Whlt den markierten Meneintrag oder wechselt zur nchsten Menebene.

.TP
.B MENU_UP
Bewegt den Cursor um einen Menzeile nach oben.

.TP
.B MIXER_DOWN
Verringert die Mixerlautstrke.  Durch einen optionalen Parameter kann die
Anzahl der Prozentpunkte, um die die Lautstrke verringert werden soll,
angegeben werden.

.TP
.B MIXER_TOGGLE_MUTE
Aktiviert oder deaktiviert die Stummschaltung des Mixers, im Gegensatz zu
.B TOGGLE_MUTE,
das die TV\-Karte stummschaltet.

.TP
.B MIXER_UP
Erhht die Mixerlautstrke.  Durch einen optionalen Parameter kann die
Anzahl der Prozentpunkte, um die die Lautstrke erhht werden soll,
angegeben werden.

.TP
.B NOOP
Dieses Kommando hat keine Wirkung.  Es ist sinnvoll, um eine vordefinierte
Tastenbindung zu deaktivieren.

.TP
.B OVERSCAN_DOWN
Verringert den berstehenden Bildbereich, es ist also ein grerer Teil des
Fernsehbildes zu sehen.

.TP
.B OVERSCAN_UP
Erhht den berstehenden Bildbereich, es ist also ein kleinerer Teil des
Fernsehbildes zu sehen.

.TP
.B PICTURE
Wechselt die mit den Kommandos
.B PICTURE_UP
und
.B PICTURE_DOWN
zu ndernde Bildeinstellung.

.TP
.B PICTURE_UP
Erhht die momentan gewhlte Bildeinstellung (Helligkeit, Kontrast, Farbton
oder Sttigung).

.TP
.B PICTURE_DOWN
Verringert die momentan gewhlte Bildeinstellung (Helligkeit, Kontrast,
Farbton oder Sttigung).

.TP
.B RESTART
Startet
.B tvtime
neu.  Dieses Kommando wird aus dem Men verwendet, wenn eine Einstellung
gendert wurde, die (noch) nicht zur Laufzeit konfigurierbar ist.

.TP
.B RIGHT
Dieses Kommando erhht entweder die Lautstrke oder whlt den markierten
Menpunkt, je nachdem, ob das Men aktiv ist oder nicht.  Es sollte in
Verbindung mit den Kommandos LEFT, UP und DOWN genutzt werden.

.TP
.B RUN_COMMAND
Weist
.B tvtime
an, ein Kommando zu starten.  Auf diese Weise knnen externe Programme, z. B.
mythepg oder alevt, durch einen Tastendruck in
.B tvtime
oder lirc gestartet werden.
.br
\h'4n'tvtime-command run_command "xterm"
.br
wrde
.B tvtime
veranlassen, system( "xterm &" ) aufzurufen.

.TP
.B SAVE_PICTURE_GLOBAL
Speichert die momentanten Bildeinstellungen als globale Standardwerte.

.TP
.B SAVE_PICTURE_CHANNEL
Speichert die momentanen Bildeinstellungen als Standardwerte fr den aktuellen
Sender.

.TP
.B SCREENSHOT
Erzeugt ein Bildschirmfoto vom aktuellen Fernsehbild.  Bildschirmfotos werden
in dem Ordner gespeichert, der in der Datei
.I tvtime.xml
als Zielpfad fr Bildschirmfotos angegeben ist.  Standardmig wird das
Heimatverzeichnis des Nutzers verwendet.

.TP
.B SET_AUDIO_MODE
Dieses Kommando bentigt einen Parameter und setzt den Audio\-Modus.
Zulssige Werte fr diese Option sind "mono", "stereo", "sap", "lang1" oder
"lang2".

.TP
.B SET_DEINTERLACER
Dieses Kommando bentigt einen Parameter und setzt den De\-Interlacer.
Zulssige Werte sind die Kurzbezeichnungen der in
.B tvtime
verfgbaren De\-Interlacer\-Algorithmen.

.TP
.B SET_FRAMERATE
Dieses Kommando bentigt einen Parameter und setzt die momentane Bildrate.
Gltige Werte sind "full" (volle Bildrate), "top" (halbe Bildrate, oberes
Halbbild) oder "bottom" (halbe Bildrate, unteres Halbbild).

.TP
.B SET_FREQUENCY_TABLE
Dieses Kommando bentigt einen Parameter und setzt die zu verwendende
Frequenztabelle.

.TP
.B SET_FULLSCREEN_POSITION
Dieses Kommando bentigt einen Parameter und legt fest, wie ein zu breites
Fernsehbild im Vollbild\-Modus plaziert wird. Zulssige Werte sind "top"
(oberer Rand), "center" (mittig) oder "bottom" (unterer Bildrand).

.TP
.B SET_INPUT_WIDTH
Dieses Kommando bentigt einen Parameter und legt die horizontale Auflsung
des Eingangssignals in Pixeln fest.  Diese Einstellung zeigt erst nach einem
Neustart von
.B tvtime
Wirkung.

.TP
.B SET_MATTE
Dieses Kommando bentigt einen Parameter und legt die Breite der schwarzen
Balken am oberen und unteren Bildrand fest.  Auf diese Weise kann das
Seitenverhltnis des Ausgabefenster festgelegt werden.  Gltige Werte sind
16:9, 1.85:1, 2.35:1 oder 4:3.

.TP
.B SET_NORM
Dieses Kommando bentigt einen Parameter und setzt die zu verwendende
Fernsehnorm.  Diese Einstellung zeigt erst nach einem Neustart von
.B tvtime
Wirkung.

.TP
.B SET_STATION
Dieses Kommando interpretiert seinen Parameter als Sendername oder als Nummer
und wechselt zum angegebenen Kanal.

.TP
.B SET_XMLTV_LANGUAGE
Dieses Kommando setzt die bevorzugte Sprache fr XMLTV\-Daten.  Das Argument
kann entweder ein zweibuchstabiges Sprachkrzel gem ISO 639 (z. B. "de"
fr deutsch) sein oder eine Nummer, um eine der bereits bekannten Sprachen
zu verwenden.

.TP
.B SHOW_DEINTERLACER_INFO
Zeigt einen Hilfetext mit einer Beschreibung des aktiven De\-Interlacers auf
dem OSD an.

.TP
.B SHOW_MENU
Zeigt das
.BR tvtime \-Hauptmen.

.TP
.B SHOW_STATS
Zeigt eine Reihe von statistischen Daten zu Debug\-Zwecken im OSD an.

.TP
.B SLEEP
Dieses Kommando setzt die Schlaffunktion von
.BR tvtime .
Wenn es zum ersten Mal gesendet wird, wird dieses Funktion aktiviert,
wiederholtes Senden erhht die Zeit, nach Ablauf derer
.B tvtime
sich selbstttig beenden wird.  Wird das Kommando nach Erreichen des
Maximalwertes erneut gesendet, wird die Funktion wieder deaktiviert.


.TP
.B TOGGLE_ALWAYSONTOP
Wechselt den "Immer im Vordergrund"\-Status von
.BR tvtime ,
vorausgesetzt, der verwendete Fenstermanager untersttzt diese Funktion.

.TP
.B TOGGLE_ASPECT
Wechselt das Seitenverhltnis zwischen 4:3 und 16:9.  Verwenden Sie den
16:9\-Modus, wenn Sie einen externen DVD\-Player oder Satellitenreceiver
anschlieen mchten, der ein anamorphes 16:9\-Signal erzeugt.

.TP
.B TOGGLE_AUDIO_MODE
Wechselt den Audio\-Modus zwischen den beim aktuellen Kanal verfgbaren
Einstellungen.  Es kann einige Zeit dauern, bis der Treiber die verfgbaren
Modi erkennt.

.TP
.B TOGGLE_BARS
Zeigt ein Testbild mit Farbbalken in
.BR tvtime .
Diese Balken werden von
.B tvtime
generiert, nicht vom Treiber der TV\-Karte.  Sie sind dazu gedacht, um Sie
beim Konfigurieren der Bildschirm\- oder Projektoreinstellungen zu
untersttzen.  Wenn diese Farbbalken korrekt dargestellt werden, vergleichen
Sie sie mit einem Testbild aus einer externen Quelle.

.TP
.B TOGGLE_CC
Schaltet die Dekodierung von Closed Caption\-Untertiteln ein oder aus.  Diese
Funktion ist nur in NTSC\-Gebieten und bei aktivierter VBI\-Dekodierung in der
Konfigurationsdatei
.I tvtime.xml
verfgbar.

.TP
.B TOGGLE_CHANNEL_PAL_DK
Wechselt den Audiomodus des aktuellen Senders zwischen PAL\-BG und PAL\-DK.

.TP
.B TOGGLE_CHROMA_KILL
Aktiviert oder deaktiviert den Farbsignalfilter.  Dieser Filter macht das
Eingangssignal schwarzwei und ist ntzlich, um Schwarzwei\-Filme ohne
Crominanz\-Artifakte zu betrachten.

.TP
.B TOGGLE_COLOR_INVERT / TOGGLE_COLOUR_INVERT
Schaltet den Farbinvertierungsfilter ein oder aus.  Dies ist (scheinbar)
hilfreich fr Kunden der australischen Kabelfirma Optus, die den Kanal ber
die TV\-Karte einstellen mchten, anstatt die Dekoderbox zu verwenden.

.TP
.B TOGGLE_DEINTERLACER
Wechselt zwischen den verfgbaren De\-Interlacer\-Algorithmen.

.TP
.B TOGGLE_FULLSCREEN
Wechselt zwischen Vollbild\- und Fenstermodus.

.TP
.B TOGGLE_FRAMERATE
Wechselt die Einstellung der verwendeten Bildrate. Mgliche Werte sind "volle
Bildrate", "halbe Bildrate, oberes Halbbild" und "halbe Bildrate, unteres
Halbbild".

.TP
.B TOGGLE_INPUT
Wechselt die Signalquelle der TV\-Karte.  Mgliche Signalquellen sind u. a.
das Empfangsteil, der Composite Video\-Eingang oder ein S\-Video\-Anschlu.

.TP
.B TOGGLE_LUMA_CORRECTION
Dieses Kommando aktiviert oder deaktiviert den Farbkorrekturfilter, der
versucht, falsche Farbraumwerte von bt848\- oder bt878\-basierten TV\-Karten
auszugleichen.

.TP
.B TOGGLE_MATTE
Wechselt zwischen den verschieden breiten Bildblenden, um die oberen und
unteren Bildrnder abzudecken.

.TP
.B TOGGLE_MIRROR
Schaltet den Bildspiegelfilter ein oder aus, der fr den Einsatz von
.B tvtime
in Verbindung mit Rckprojektionsprojektoren gedacht ist.  Diese Funktion
ist leider noch nicht wirklich brauchbar, da die OSD\-Anzeige nicht
mitgespiegelt wird.

.TP
.B TOGGLE_MUTE
Aktiviert oder deaktiviert die Stummschaltung der TV\-Karte (nicht der
Soundkarte).

.TP
.B TOGGLE_NTSC_CABLE_MODE
Wechselt den NTSC\-Kabelmodus zwischen
.IR Standard ,
.IR IRC ", und "
.IR HRC "."

.TP
.B TOGGLE_PAL_DK_AUDIO
Wechselt die Audionorm zwischen PAL\-BG und PAL\-DK.

.TP
.B TOGGLE_PAL_SECAM
Wechselt die TV\-Norm fr den aktuellen Sender zwischen PAL und SECAM.  Diese
Funktion ermglicht es, in Gebieten, in denen Sender beider Normen empfangen
werden knnen, fr jeden Sender die richtige Norm zu konfigurieren.

.TP
.B TOGGLE_PAUSE
Schaltet
.B tvtime
in den Pause\-Modus.  Dieser Modus wird bei der Entwicklung von
De\-Interlacer\-Algorithmen eingesetzt, um ein und dieselben Bilder mit
verschiedenen De\-Interlacer\-Einstellungen zu betrachten.

.TP
.B TOGGLE_PULLDOWN_DETECTION
Aktiviert oder deaktiviert den 2\[en]3\-Pulldown im NTSC\-Modus.

.TP
.B TOGGLE_QUIET_SCREENSHOTS
Schaltet die optische Rckmeldung beim Bildschirmfotos ein oder aus.
Normalerweise wird bei Erzeugen eines Bildschirmfotos eine Nachricht im OSD
ausgegeben.  Wenn Sie mehrere Bildschirmfotos kurz hintereinander machen
mchten, ohne da die jeweils vorangegangene Benachrichtigung in selbigen zu
sehen ist, knnen Sie die Benachrichtigung mit dieser Funktion abschalten.

.TP
.B TOGGLE_SIGNAL_DETECTION
Schaltet die Signalerkennung ein oder aus.  Signalerkennung ist Voraussetzung
fr Funktionen wie den Sendersuchlauf und erhht die Ansprechbarkeit bei
Sendern mit schwachem Empfang, aber sie macht es unmglich, Sender
anzuschauen, deren Signal zu schwach fr eine zuverlssige Detektion ist.

.TP
.B TOGGLE_XDS
Schaltet die XDS\-Dekodierung ein oder aus, die in NTSC\-Gebieten verwendet
wird, um Senderinformationen wie den Sender\- und Netzwerknamen und das
aktuelle Fernsehprogramm zu bertragen.  Diese Informationen werden, wenn
verfgbar, im OSD angezeigt.

.TP
.B TOGGLE_XMLTV_LANGUAGE
Wechselt die bevorzugte Sprache fr XMLTV\-Daten zwischen den in der
XMLTV\-Datei verfgbaren Sprachcodes.

.TP
.B UP
Dieses Kommando wechselt entweder zum nchsthheren Sender oder bewegt den
Cursor um eine Menzeile nach oben, je nachdem, ob das Men aktiv ist oder
nicht.  Es sollte in Verbindung mit den Kommandos LEFT, RIGHT und DOWN
verwendet werden.

.TP
.B QUIT
Beendet den laufenden
.BR tvtime \-Proze.

.SH AUTOREN

Billy Biggs,
Stewart Allen.

.SH "SIEHE AUCH"

.BR tvtime (1),
.IR tvtime.xml (5),
.IR stationlist.xml (5).