[Redbutton-devel] SF.net SVN: redbutton: [32]
Brought to you by:
skilvington
|
From: <ski...@us...> - 2006-04-03 10:22:53
|
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 <demux_device>] [-b <base_dir>] [-t <timeout>] [-c <carousel_id>] [<service_id>] +</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 <base_dir> 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 <carousel_id> will normally be read from the PMT, but you can use the -c option to explicitly choose a carousel. +<P> +If no <service_id> is given, a list of possible channels (and their <service_id>) 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 <base_dir> will be: +<PRE> +./services/<service_id> +</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/<PID>/<CID>/ +</PRE> +where <PID> is the PID the carousel was downloaded from +and <CID> 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 <keymap_config_file>] [-t <timeout>] <service_gateway_dir> +</PRE> +Display the MHEG apps downloaded with rb-download. +The <service_gateway_dir> 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. |