Author: voroshil Date: Mon Sep 24 19:18:55 2007 New Revision: 24604 Log: Teletext documentation Modified: trunk/DOCS/xml/en/tvinput.xml Modified: trunk/DOCS/xml/en/tvinput.xml ============================================================================== --- trunk/DOCS/xml/en/tvinput.xml (original) +++ trunk/DOCS/xml/en/tvinput.xml Mon Sep 24 19:18:55 2007 @@ -185,4 +185,95 @@ to a hardware limitation. </sect2> </sect1> + +<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> + + +<sect1 id="tv-teletext"> +<title>Teletext</title> + +<para> +Teletext is currently available only in MPlayer for v4l and v4l2 drivers. +</para> + +<sect2 id="tv-teletext-implementation-notes"> +<title>Implementation notes</title> + +<para> +<application>MPlayer</application> supports regular text, graphics and navigation links. +Unfortunately, colored pages are not fully supported yet - all pages are shown as grayscaled. +Subtitle pages (also known as Closed Captions) are supported, too. +</para> + +<para> +<application>MPlayer</application> starts caching all teletext pages upon +starting to receive TV input, so you do not need to wait until the requested page is loaded. +</para> + +<para> +Note: Using teletext with <option>-vo xv</option> causes strange colors. +</para> +</sect2> + +<sect2 id="tv-teletext-usage"> +<title>Using teletext</title> + +<para> +To enable teletext decoding you must specify the VBI device to get teletext data +from (usually <filename>/dev/vbi0</filename> for Linux). This can be done by specifying +<option>tdevice</option> in your configuration file, like shown below: +<screen>tv=tdevice=/dev/vbi0</screen> +</para> + +<para> +You might need to specify the teletext language code for your country. +To list all available country codes use +<screen>tv=tdevice=/dev/vbi0:tlang=<replaceable>-1</replaceable></screen> +Here is an example for Russian: +<screen>tv=tdevice=/dev/vbi0:tlang=<replaceable>33</replaceable></screen> +</para> + +<para> +</para> +</sect2> + +<sect2 id="tv-teletext-hotkeys"> +<title>Teletext hot keys</title> + +<informaltable frame="all"> +<tgroup cols="2"> +<thead> +<row> + <entry>Key</entry> + <entry>Description</entry> +</row> +</thead> +<tbody> +<row> + <entry>X</entry> + <entry>Switch teletext display on/off</entry> +</row> +<row> + <entry>C</entry> + <entry>Cycle through teletext rendering modes (opaque, transparent, inverted opaque, + inverted transparent</entry> +</row> +<row> + <entry>Left/Right</entry> + <entry>Go to previous/next teletext page</entry> +</row> +<row> + <entry>PageUp/PageDown</entry> + <entry>Go to next/previous teletext subpage</entry> +</row> +<row> + <entry>digits</entry> + <entry>Enter teletext page number to jump to</entry> +</row> +</tbody> +</tgroup> +</informaltable> +</sect2> +</sect1> + </chapter>
On Mon, 24 Sep 2007 19:18:56 +0200 (CEST) voroshil <subversion@mplayerhq.hu> wrote: ....
+ <entry>Key</entry> + <entry>Description</entry> +</row> +</thead> +<tbody> +<row> + <entry>X</entry> + <entry>Switch teletext display on/off</entry> +</row> .... +<row> + <entry>digits</entry> + <entry>Enter teletext page number to jump to</entry> +</row> +</tbody>
shouldn't keyboard controls be in the man page only? as radio input ones, for instance????
On Tue, Nov 27, 2007 at 12:01:36AM +0100, Paul TT wrote:
On Mon, 24 Sep 2007 19:18:56 +0200 (CEST) voroshil <subversion@mplayerhq.hu> wrote:
....
+ <entry>Key</entry> + <entry>Description</entry> +</row> +</thead> +<tbody> +<row> + <entry>X</entry> + <entry>Switch teletext display on/off</entry> +</row> .... +<row> + <entry>digits</entry> + <entry>Enter teletext page number to jump to</entry> +</row> +</tbody>
shouldn't keyboard controls be in the man page only? as radio input ones, for instance????
Indeed, good catch! This needs to be moved to the man page. Diego
On Tue, 27 Nov 2007 11:53:18 +0100, Diego Biurrun wrote:
On Tue, Nov 27, 2007 at 12:01:36AM +0100, Paul TT wrote:
On Mon, 24 Sep 2007 19:18:56 +0200 (CEST) voroshil <subversion@mplayerhq.hu> wrote:
....
+ <entry>Key</entry> + <entry>Description</entry> +</row> +</thead> +<tbody> +<row> + <entry>X</entry> + <entry>Switch teletext display on/off</entry> +</row> .... +<row> + <entry>digits</entry> + <entry>Enter teletext page number to jump to</entry> +</row> +</tbody>
shouldn't keyboard controls be in the man page only? as radio input ones, for instance????
Indeed, good catch! This needs to be moved to the man page.
Diego
erm, shouldnt default keys be in input.conf as well? :) -compn
2007/11/27, Compn <tempn@twmi.rr.com>:
On Tue, 27 Nov 2007 11:53:18 +0100, Diego Biurrun wrote:
On Tue, Nov 27, 2007 at 12:01:36AM +0100, Paul TT wrote:
On Mon, 24 Sep 2007 19:18:56 +0200 (CEST) voroshil <subversion@mplayerhq.hu> wrote:
.... [..] shouldn't keyboard controls be in the man page only? as radio input ones, for instance????
Indeed, good catch! This needs to be moved to the man page.
Diego
erm, shouldnt default keys be in input.conf as well? :)
Is attached patch ok to apply? What about additional lines in input.conf: ======== CUT ============= # Following keys will work only when teletext is switched on #RIGHT {teletext} step_property teletext_page 1 # navigates to next page #LEFT {teletext} step_property teletext_page -1 # navigates to pevious page #1 {teletext} teletext_add_dec 1 # enters digit '1' in page number field #2 {teletext} teletext_add_dec 2 # enters digit '2' in page number field #3 {teletext} teletext_add_dec 3 # enters digit '3' in page number field #4 {teletext} teletext_add_dec 4 # enters digit '4' in page number field #5 {teletext} teletext_add_dec 5 # enters digit '5' in page number field #6 {teletext} teletext_add_dec 6 # enters digit '6' in page number field #7 {teletext} teletext_add_dec 7 # enters digit '7' in page number field #8 {teletext} teletext_add_dec 8 # enters digit '8' in page number field #9 {teletext} teletext_add_dec 9 # enters digit '9' in page number field #0 {teletext} teletext_add_dec 0 # enters digit '0' in page number field #- {teletext} teletext_add_dec - # erases last digit in page number field ================END==================== Moreover, comments can be removed (thus enabling those keys by default) since above keys affects only teletext. And my comment should be replaced by more clear and easy-to-undestand version. -- Regards, Vladimir Voroshilov mailto:voroshil@gmail.com JID: voroshil@gmail.com, voroshil@jabber.ru ICQ: 95587719
participants (5)
-
Compn -
Diego Biurrun -
Paul TT -
Vladimir Voroshilov -
voroshil