
MDTeleText v0.62 (2002-06-01)
-----------------------------

This plugin provides basic teletext support to MultiDec and other TV apps that
support the MultiDec plugin API.

Changes since since v0.61:

- Added a charset menu with the possibility to override the charset in case the
  plugin gets it wrong. Please note that it only applies to "software" mode.

- Fixed the issue with doubleheight text and hyperlinks. The entire text is now
  clickable.



Instructions:

To view a page, type the number on your keyboard. If the page displays colored
shortcut labels at the bottom, press r for red, g for green, y for yellow or
c for cyan shortcut. To jump to the page index press i.

Step to the next available page using the right arrow key or n, step backwards
using the left arrow key or p. If the page is divided into subpages use the
up and down arrows or u and d keys to manually rotate through the available
subpages.

All three digit numbers and the colored shortcuts act as hyperlinks, click them
to jump the the corresponding page.

Click the X button or hit q to close the plugin.

Toggle fullscreen mode with f.


To use your remote control in MultiDec add the following snippet to your
Remote.ctl file:

*[MDTeleText]*
KEY 000 0000 0000 0 0
KEY 001 0000 0000 0 1
KEY 002 0000 0000 0 2
KEY 003 0000 0000 0 3
KEY 004 0000 0000 0 4
KEY 005 0000 0000 0 5
KEY 006 0000 0000 0 6
KEY 007 0000 0000 0 7
KEY 008 0000 0000 0 8
KEY 009 0000 0000 0 9

The above example will give you keys 0-9. To map other functions make the key
on the remote send the same letter as you press on the keyboard.

You can configure various options like fonts and subtitle positions. See the
included INI file for more information.



DDE links:

The plugin implements a simple DDE server. Use the following parameters to
connect:


Service Name:   MDTeleText

Link topic:     PPP[:SSSS]

  Where PPP is the three digit page number and SSSS is an optional four digit
  subpage number. (Don't include the []s.)

Link item:      page|ROW[:COLUMN[:LENGTH]]

  Specify "page" to receive the entire page, or specify the row number, column
  (optional) and string length (optional) to extract a row or part of a row.
  Top left corner is at row 0, column 0. (Don't include the []s.)


No processing or character translation is done, the client receives the raw
teletext data (allmost 7-bit ASCII), including control codes. The data may
include null bytes.

If the page requested isn't in the cache the client receives a blank page.

Advice loops are currently not supported, the client must manually poll the
server to find out if the page content has changed.



History:

v0.61 (2002-05-18)
- Added DDE server support.
- Made the maximized window look better.
- Added a fullscreen mode, toggle with 'f'.
- Three new settings added to the INI file: IgnoreFirstColumn, FullscreenMargin 
  and WindowPostion.

v0.6 (2002-05-12)
- Added INI file for varions config options.
- The main window font and antialiasing mode can be set in the INI file.
- The "software" mode subtitle font, antialiasing and postitioning can be set
  in the INI file.
- Removed the dependency on the TechnoLD font.
- Made the main window sizeable.
- Hit 'q' to close the plugin.
- Fixed some minor bugs.

v0.5 (2002-05-06)
- Added "software" subtitles.

v0.41 (2002-04-15)
- All pagenumbers and colored labels are clickable hyperlinks.
- Subpages are now placed in the cache.
- Various minor bugfixes.

v0.4 (2002-04-01)
- Received pages are now cached in memory for instant access.
- Switch to the next/previous page using the arrow keys.
- Subtitles are now erased when they expire (for real this time).

v0.32 (2002-03-16)
- Fixed a bug in the PES packet reassembly that dropped a lot of data.
- Subtitles are now erased when they expire.
- Various small cosmetic fixes.

v0.31 (2002-03-15)
- Added Red/Green/Yellow/Cyan button navigation.
- Fixed a bug when rendering doubleheight text.

v0.3 (2003-03-01)
- Rewrote the decoder to use Unicode.
- Created mappings to Unicode for all languages.
- Removed the silly messagebox when turning pages.
- Replaced the Techno font with Lucida Console.
- Fixed some bugs in the OSD subtitles.
- Fixed a big bunch of bugs and missing features in the rendering engine.

v0.2 (2003-02-15)
- Fixed crash with Multidec 9.3
- Added experimental OSD subtitles.

v0.1 (2003-02-13)
- Initial release



Known issues:

- Only the most basic teletext features are supported (and even those few
  features are buggy).

- Doesn't work with ProgDVB prior to version 4.0.9.1.

- Doesn't work with DVBPortal prior to version 0.97.

- Can only display the teletext page in a window on the desktop. Display
  on the tv-out of the DVB card is NOT supported.

- The charactermappings for OSD subtitles are completley borked.

- OSD subtitles are broken in WatchTVPro.

- The following characters seems to be missing in Lucida Console:

  Latin small letter E with cedilla (in Lettish / Lithuaninan charset)
  Latin capital letter Z with stroke (in Polish charset)
  Cryllic capital letter I with grave (in Cryllic charset)
  Cryllic small letter I with grave (in Cryllic charset)
  Prime (in Greek charset)
  All Arabic letters
  All Hebrew letters

- Handling of the Arabic charset is missing. I'm unable to figure out the proper
  Unicode chars. If anyone want to contribute a translationtable from teletext
  to Unicode feel free to drop me a line.

- The few Eastern European channels I receive doesn't seem to transmit the
  charset in use.



Things planned for future releases:

* Improve the user interface.

* Add a preferences dialog box.

* Add a history buffer  la webbrowsers.

* Add DDE advice loops.

* Implement the TeleText Level 2 and 3 feature sets.

* Fix bugs.



License:

You may use this plugin free of charge. You may redistribute this plugin as
long as you do it for free. You may NOT distribute modified versions. You may
NOT bundle this plugin with a commercial product or otherwise make money of it,
unless you cut me in for a share. ;)



Questions?

Sorry, I don't have time to answer e-mail. Post your questions on the DVBN
message board (http://forums.dvbnetwork.com/).



Enjoy!

/Fredrik hrn
