This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Marcel Wiesweg <marcel.wiesweg@gmx.de

Project's homepage:          http://www.wiesweg-online.de/linux/vdr

Latest version available at: http://www.wiesweg-online.de/linux/vdr

See the file COPYING for license information.

Description:

Osd-Teletext displays the teletext directly on the OSD.
Both sound and video are played in the background. 


Receiving code:
 To enable the receiving code of this plugin,
 specify the command line option "-r" and load the plugin as usual:
  -P 'osdteletext -r'
 You need this unless you additionally load the teletext plugin.

Keys:
     Up:     page+
     Down:   page-
     Right:  sub page+
     Left:   sub page-
     
   For other user interaction, the plugin uses the concept of "actions".
   You can e.g. configure that you jump to page 100 when you press Red.
   In this example, the Action "Jump to 100" is assigned to key "Red".
   
   Available Keys: Blue, Red, Yellow, Green, Play, Pause, Stop, Record, FastFwd, FastRwd
   Actions: "Zoom", "Half page", "Switch channel", "Suspend Receiving", "Switch background",
            "Jump to..." a specific page.
            
   Description of the actions:
     Zoom:          Zoom to upper half/lower half/back to full page
     Half Page:     Reduce OSD window to the lower half of the screen and display upper half/lower half/back to full size
     Switch channel:Show pages of a channel different from the one currently tuned to.
                    This does _not_ include any tuning or channel switching with vdr's core. 
                    You must have tuned to the channel chosen some time before so that the pages have been stored on disk.
                    When you press the key associated with that action, you are asked for the channel number.
                    Press OK after you entered it with the number keys.
     Jump to...:    Jumps to the page you configure.
     Suspend Receiving: EXPERIMENTAL, patch to VDR needed, see below!
                        Stop the receiving until you press the button again. You then
                        should be able to use your TV set's teletext decoder again. Already received
                        pages are of course still available.
                        (action works only if you use the plugin's own receiving code)
     Switch background: Changes the in the setup configurable background color immediately
                        to black and back to your degree of transparency.
                        
   How to configure the key bindings:
   In the plugins setup menu, you can assign one of actions to each key.
   You can choose freely which actions you need, you are not forced to assign
   an action to a key at all if you do not need it.
   If you select "Jump to...", specify the page number in the line immediately below.
   These "page number" options have no meaning if "Jump to..." is not selected.
   
   
Other Setup options:
   Background transparency: number between 0 (transparent) and 255 (black). Default is 127 (also used by VDR)
   Show Clock: Toggles whether an additional clock is drawn approximately every second.
               The clock shows the current system time, not any time broadcast via teletext.
               Let VDR set the system time from a transponder to have the exact time.
   Suspend Receiving: EXPERIMENTAL, patch to VDR needed, see below!
                      This is different from the action with the same name!
                      If you select yes, then receiving will always stop after 20 seconds
                      and resume 5 minutes later.
                      This may be useful if a member of your family really does not want
                      to use this beautiful plugin...
   Auto-update pages: Continuously checks whether a page has changed and updates it if yes.
   OSD width, OSD height: Adjusts the width and height of the OSD independent from VDR's settings.
                          The valid range is 40 to 56 for the width and 12 to 21 for the height.                        
   Key bindings:      See above.
   

Colors:
 You can change the colors in "colormapping.h".
 Due to the limited OSD memory of the DVB-cards, the color depth had
 to be limited to 2 Bits which means four colors.
 As teletext seems to support eight colors these eight colors have to be mapped
 to the available four colors, including the background (transparent) color.
 Currently the mapping is optimized for German ARD and ZDF 
 (according to my personal taste). You can easily  change the mapping
 in the file "colormapping.h" (Recompile afterwards).
 
Suspend Receiving:
 Aim:
   Use your TV's teletext decoder with the plugin loaded.
   If you are not interested, skip this section.
 Technical details:
   Currently the firmware seems to be unable to
      -send teletext packages both to the frontend and VDR
      -reinsert teletext packages from VDR in a sort of transfer mode
   In order to use the teletext decoder of your TV set, receiving time must be shared:
   20 seconds the packages go to the plugin, 5 min to the decoder, 20 seconds to the plugin...
 Patch:
   In order to use the experimental suspending feature, apply the patch "reinsert-teletext.patch".
   It should work with all recent versions of VDR.
 
