Thread: [Redbutton-devel] SF.net SVN: redbutton: [32]

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Revision: 32
Author:   skilvington
Date:     2006-04-03 03:22:45 -0700 (Mon, 03 Apr 2006)
ViewCVS:  http://svn.sourceforge.net/redbutton/?rev=32&view=rev

Log Message:
-----------
import redbutton.sourceforge.net index.html

Added Paths:
-----------
    www/
    www/index.html
Added: www/index.html
===================================================================

--- www/index.html	                        (rev 0)
+++ www/index.html	2006-04-03 10:22:45 UTC (rev 32)
@@ -0,0 +1,145 @@
+<HTML>
+<HEAD>
+<TITLE>RedButton MHEG Engine</TITLE>
+</HEAD>
+<BODY>
+<a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=158629&type=2" width="125" height="37" border="0" alt="SourceForge.net Logo" /></a>
+<H1>RedButton MHEG Engine</H1>
+RedButton allows you to use the interactive MHEG applications broadcast with DVB digital TV services.
+MHEG replaces the text only services available with analogue TV.
+<P>
+RedButton consists of two parts. The first, rb-download, allows MHEG data to be downloaded from a DVB service. The second, rb-browser, allows the downloaded MHEG applications to be displayed.
+<P>
+The source for both is released under the GPL and can be
+<A HREF="http://sourceforge.net/project/showfiles.php?group_id=158629">downloaded here.</A>
+<P>
+Just un-tar them and type 'make'.
+<P>
+You can browser the latest version of the source
+<A HREF="http://svn.sourceforge.net/redbutton/">here.</A>
+You can download the latest source code with the following Subversion command:
+<PRE>
+svn checkout https://svn.sourceforge.net/svnroot/redbutton/
+</PRE>
+<P>
+You can subscribe to the development mailing list
+<A HREF="http://lists.sourceforge.net/lists/listinfo/redbutton-devel">here.</A>
+<H2>rb-download</H2>
+Usage:
+<PRE>
+rb-download [-d &lt;demux_device&gt;] [-b &lt;base_dir&gt;] [-t &lt;timeout&gt;] [-c &lt;carousel_id&gt;] [&lt;service_id&gt;]
+</PRE>
+Download the DVB Object Carousel for the given channel onto the local hard disc.
+<P>
+The default demux device is /dev/dvb/adapter0/demux0.
+<P>
+If no directory is given with -b, files will be stored under the current directory.
+Note that &lt;base_dir&gt; must already exist and be writeable.
+<P>
+The default timeout is 10 seconds.
+If no DSM-CC data is found after this time, it is assumed none is being broadcast.
+<P>
+The &lt;carousel_id&gt; will normally be read from the PMT, but you can use the -c option to explicitly choose a carousel.
+<P>
+If no &lt;service_id&gt; is given, a list of possible channels (and their &lt;service_id&gt;) is printed.
+These will be the channels available on the MUX your DVB card is currently tuned to. Use dvbtune or equivalent to tune your card.
+<P>
+The file structure stored under &lt;base_dir&gt; will be:
+<PRE>
+./services/&lt;service_id&gt;
+</PRE>
+this is a symlink to the root of the carousel for the given service.
+<P>
+The actual carousel files and directories are stored under:
+<PRE>
+./carousels/&lt;PID&gt;/&lt;CID&gt;/
+</PRE>
+where &lt;PID&gt; is the PID the carousel was downloaded from
+and &lt;CID&gt; is the Carousel ID.
+<P>
+Just leave it running and any updated files will be downloaded as they are broadcast.
+<H2>Notes</H2>
+I've compiled and run it under Gentoo and Mandr{ake,iva} Linux on x86, but it should work on any (big- or little-endian) Linux distro.
+<P>
+It only implements a subset of the whole DSM-CC specs.
+However, it is enough to download everything that is currently being broadcast
+on the 'Freeview' DVB-T channels in the UK.
+<P>
+Once the data is downloaded, you can use rb-browser (see below) to view it.
+<H2>rb-browser</H2>
+Usage:
+<PRE>
+rb-browser [-v] [-f] [-k &lt;keymap_config_file&gt] [-t &lt;timeout&gt;] &lt;service_gateway_dir&gt;
+</PRE>
+Display the MHEG apps downloaded with rb-download.
+The &lt;service_gateway_dir&gt; should be one of the entries in the services directory, eg
+<PRE>
+rb-browser services/4165
+</PRE>
+It will display the app in a window, use -f for full screen mode.
+<P>
+The -v flag enables verbose/debug mode.
+<P>
+The -t flag determines how long (in seconds) it will poll for missing files before passing an error to the MHEG application.
+The default is 10 seconds.
+<P>
+Use the -k option to load a keymap (keymap config files can be generated with the rb-keymap command).
+The default keys to navigate around the apps are:
+<P>
+<TABLE border="1" cellpadding="5">
+<TR><TH>Key</TH><TH>Function</TH></TR>
+<TR align="center"><TD>Cursor Keys</TD><TD>Up/Down/Left/Right</TD></TR>
+<TR align="center"><TD>0 - 9</TD><TD>0 - 9</TD></TR>
+<TR align="center"><TD>r</TD><TD>Red</TD></TR>
+<TR align="center"><TD>g</TD><TD>Green</TD></TR>
+<TR align="center"><TD>b</TD><TD>Blue</TD></TR>
+<TR align="center"><TD>y</TD><TD>Yellow</TD></TR>
+<TR align="center"><TD>Return</TD><TD>OK/Select</TD></TR>
+<TR align="center"><TD>Escape</TD><TD>Cancel</TD></TR>
+<TR align="center"><TD>t</TD><TD>Text</TD></TR>
+</TABLE>
+<P>
+You will need the "expat" XML parsing library and the xsltproc XML stylesheet processor that comes with "libxslt" to compile it.
+On Gentoo, you can just:
+<PRE>
+emerge expat libxslt
+</PRE>
+If the compile fails with errors about missing .c files, expat is not installed.
+If the compile fails with errors about function names ending in "_dup" being missing, libxslt is not installed.
+<P>
+To run it you need an X server that supports the Xrender extension and you need to have libpng, libmpeg2 and freetype2 installed.
+<H2>Notes</H2>
+It's not finished yet!
+It'll only draw text, rectangles and PNG bitmaps at the moment and some of the ElementaryActions are not yet implemented.
+However, it is enough to be usable.
+The main things missing are video and audio streams, at the moment it'll just draw a green box where any video should be.
+<P>
+It will only display apps that conform to the UK MHEG Profile (available from
+<A href="http://www.dtg.org.uk/">www.dtg.org.uk</A>).
+<P>
+If you get a blank screen when it starts, try pressing 'r' (for BBC) or 't' (for ITV/C4) to activate
+any MHEG app that may be waiting for you to do something.
+<P>
+The default font for the UK MHEG Profile is Tiresias Screenfont which was
+developed with the RNIB to be readable on TV screens.
+You can download this font as part of the DigiTV iTuner package from
+<A href="http://www.nebula-electronics.com/">Nebula Electronics</A>.
+Extract the file called tt7268m_802.ttf and add it to your X Windows fonts.
+The easiest way is to install DigiTV iTuner on a Windows box and then copy the
+C:\Windows\Fonts\tt7268m_802.ttf file onto your Linux box.
+To install new X fonts in KDE, open the Control Centre application,
+go to the System Administration section and select Font Installer.
+<P>
+Alternatively, if you know someone in Australia, ABC is currently broadcasting
+Tiresias.pfr as part of their TV guide application.
+You can download it with rb-download.
+The Australian applications are MHP, not MHEG, so you should probably look at
+<A href="http://www.openmhp.org/">www.openmhp.org</A> for something to display them.
+<P>
+If the Tiresias Screenfont is not available, rb-browser uses whatever scalable font Xft returns for "sans" instead.
+Note that this font will have different metrics and so may not fit into the spaces in the MHEG apps designed for Tiresias.
+<H2>Contact Details</H2>
+I can be contacted here: s.kilvington at eris dot qinetiq com.
+</BODY>
+</HTML>
+


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.



