BlinkenAppletEnglish

From BlinkenArea Wiki
Revision as of 19:57, 1 October 2007 by JulianePilster (talk | contribs)
Jump to: navigation, search
project overview
Zur deutschsprachigen Version dieser Seite
Nopic.png
Year
Number of pixels
Grayscales / Colors
Illuminant
Power input
Contact person Guido Pannenbecker
Project website
Zur deutschsprachigen Version dieser Seite

back to summary

BlinkenApplet is a universal blinken player which displays various file types and works cross-platform. The project is under GPL.

To guarantee availibility and easy installation on many platforms, BlinkenApplet is built in Java. The application can both be run from console and be embedded as an applet. A version running on cellphones capable of MIDP2.0 is planned.

BlinkenApplet05-12-16.png

Download

Current source code and a complete .jar file can be found over at Sourceforge.

The first historcial source code (unfinished!): BlinkenApplet.zip [6 KB]

Contact

If you have questions, suggestions, problems or just like to help out, don't hesitate to drop Guido Pannenbecker a line!

Current status

All 4 file formats and UDP streams using BLP protocol are already supported. Random and even undocumented frame sizes up to 3 channels are displayed with vector graphics (elipses). It's still lacking of enhanced network protocols and importing a config file (featuring a simple playlist).

Documentation

This is a step-by-step manual describing how <nop>BlinkenApplet can be run as an application on a windows pc:

  1. To use BlinkenApplet, you have to install »<a target="_blank" href="http://java.sun.com/j2se/1.4.2/download.html">Java</a> on your PC. It can be downloaded at the given site for free.
  2. You then download the latest version of BlinkenApplet.jar from »<a target="_blank" href="http://sourceforge.net/projects/blinkenapplet/">Sourceforge</a>
  3. Save it to something like C:\blinken\.
  4. Download some »<a target="_blank" href="http://www.blinkenlights.de/gallery/index.de.html">BlinkenMovies</a> to that directory
  5. Open up a dos box by clicking "Start", "Run" run and entering cmd
  6. Change to your blinken folder by typing cd C:\blinken\
  7. Enter java -jar BlinkenApplet.jar -f movie.blm. You should now see a short intro followed by the specified <nop>BlinkenMovie file (here: movie.blm).

Should you experience any problems, please don't hesitate to drop Main.GuidoPannenbecker a line!


Command line parameters

The current command line parametes for application usage can be found out by typing "--help". $ java -jar BlinkenApplet.jar --help $ java blinkenapplet/BlinkenApplet --help

Valid commands could look something like this:

$ java -jar BlinkenApplet.jar -f movie.blm $ java -jar BlinkenApplet.jar --udp --lamp-on 250,250,0 \ --lamp-off 100,100,200 &

In UDP mode, BlinkenSend is the best way to to pipe data to BlinkenApplet. The first statement shows a call from bash playing all *.blm files from one directory three times in a row infinitely. The second statement shows how this could be done much easier.

$ for ((;;)); do for i in ~/path/to/movies/*.blm; \ do ~/path/to/BlinkenSend -i $i -l 3; done; done; $ ./BlinkenSend -i movie.blm

Applet parameters

These parameters can already be used when running the program as applet:

debugLevel <0-5>
showDemo1 off>
showDemo2 off>
file_names <files>
url_file_names <url>
delayFaktor <double> (0.1 = 10x faster, 10 = 10x slower)
loop_files off>
portUDP <1-65536>
LampOnColor <0-255>,<0-255>,<0-255>
LampOffColor <0-255>,<0-255>,<0-255>
bgColor <0-255>,<0-255>,<0-255>

Example

Here's an »<a target="_blank" href="http://www.sd-gp.de/?page_id=BlinkenApplet">online example</a> of the applet. BlinkenApplet.jar is located in the same folder as the HTML file which contains the following code in it's body.

<applet codebase = "." code=blinkenapplet.BlinkenApplet.class archive="BlinkenApplet.jar" width="150" height="110" >
<param name="showDemo1" value="no">
<param name="showDemo2" value="no">
<param name="loop_files" value="ON">
<param name="bgColor" value="60,60,80">
<param name="LampOffColor" value="0,0,50">
<param name="LampOnColor" value="0,50,255">
<param name="url_file_names" value="http://www.sd-gp.de/movies/blubb.blm">
</applet>

project description

The "BlinkenScreen" can display lots of different formats, even any undocumented framce sizes. The current version of BlinkenApplet can play-back two demo streams to show different frame sizes (demo: 5x5) and MultiColorLEDs which colors are determined by several channels.

Only vector graphics are used to draw the LEDs. Bitmaps aren't supported. BlinkenSimJava is a player which projects movies onto bitmap facades.

Supported protocols

http://www.sd-gp.de/?page_id=BlinkenApplet
The next version will support EBLP. MCUF with several channels will be implemented later for which the base data type already provide several channels. ISDN protocols such as BIP, EBIP will not be supported. Considering SBTP, we haven't made any plans about that yet. Succeeding versions of BlinkenApplet could possibly transfer streams via UDP to clients which would enable a simple proxy functionality.

Supported file formats

http://www.sd-gp.de/?page_id=BlinkenApplet

All 4 file formats (blm, bmm, bml and bbm) can be read by BlinkenApplet. BlinkenApplet is not supposed to become a converter. There's excellent software to do that (c.f. file formats). In case BlinkenApplet will be able to write files in the future (i.e. recording a UDP stream), bml seems to be the appropriate format. It's most likely that BlinkenApplet will only export this filetype.

Playlist, GUI, command line parameters

First, BlinkenApplet is supposed to be an easy to use application. A playlist which will be editable during the program's runtime is not planned. However, there's a simple loop function which can contain several movies in a row. Further on, it's planned to have a config file read by BlinkenApplet which could contain a list of streams to play.

There's no GUI in the current version but the output window; that's not gonna change. Some command line and applet parameters will be evaluated to play a specific file or to listen on a specific port for an UDP stream.

Handling several channels in a stream

In case a stream contains several channels, channels 1-3 will be used for colors red, green, blue and will be displayed in one MultiColor-LED per pixel. Other channels will be ignored.

Other blinken projects using Java =

Blimp

BlinkenApplet uses a base class BlinkenFrame which is mostly the same as the one used in blinken editor Blimp by 1stein. Furthermore, FileIO functions from class <nop>BlinkenMovie were adopted. In contrast to Blimp, BlinkenApplet is not using Swing but AWT without Swing to allow portability to MIDP2.0 cellphones and to simplify installing on some computers if necessary. Blimp is downloadable in a fully functional and well documented version incl. source code.

BlinkenSimJava

Another blinken player coded in Java is BlinkenSimJava by 1stein as well. This player uses bitmaps and displays the movies on the original buildings which makes it less universal concerning the supported stream formats. BlinkenSimJava is released as pre alpha version incl. source code.

MIDP player

To display movies on a cellphone using bitmaps, you can download MIDP-Player by headmax in this thread. There's a .jar file to run on a cellpone and source code.

BlinkenLib

BlinkenLib by 1stein is no java project but a useful extension to BlinkenApplet. First of all the application BlinkenSend included in BlinkenLib is very useful when using BlinkenApplet: you can send any UDP stream to BlinkenApplet.

Screenshots

BlinkenApplet 256grey.png
Example: 5x5 pixels, up to 256 greyscale with red LED


MediaWiki Extension

BlinkenApplet can now be integrated into any MediaWiki using MediaWiki Extension