--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/front_idill/extern/fajran-npTuioClient/README.md	Fri Apr 06 10:44:54 2012 +0200
@@ -0,0 +1,98 @@
+npTuioClient
+============
+
+npTuioClient is a TUIO Client implemented as an NPAPI-based browser
+plugin. It uses [reacTIVision's](http://reactivision.sourceforge.net/)
+TUIO Client as a base.
+
+The plugin constantly calls a javascript function `tuio_callback`
+whenever a new touch event arrives. Having this function called, you
+can start using javascript to manipulate HTML, Canvas, SVG, etc in
+order to create a multi-touch application!
+
+Check the included examples to see how to use this plugin. Check also
+[TUIOjs](http://github.com/fajran/tuiojs/tree/master) to see more
+examples.
+
+The plugin has been tested and works on
+
+* Windows XP: Firefox 3.0.10, Google Chrome 2.0.172.33, and Safari 4.0.
+* Linux (Ubuntu 8.04): Firefox 3.0.11
+* Mac OS X 10.4.11: Firefox 3.5rc3 and Safari 4.0
+
+It doesn't work on Opera 9.64 on Windows XP nor Internet Explorer.
+
+To make the plugin works on Internet Explorer, the plugin has to be
+ported (or wrapped) to an ActiveX-based plugin first. This is needed
+since Internet Explorer doesn't support NPAPI-based plugin.
+
+Download
+--------
+
+* [Windows](http://cloud.github.com/downloads/fajran/npTuioClient/npTuioClient-0.2-win.zip)
+* [Linux](http://cloud.github.com/downloads/fajran/npTuioClient/npTuioClient-0.2-linux.tar.gz) (Ubuntu 8.04 i386)
+* [Mac OS X](http://cloud.github.com/downloads/fajran/npTuioClient/npTuioClient-0.2-mac.zip)
+
+Compilation
+-----------
+
+### Windows
+
+Open the Visual C++ project/solution file and build. I use Visual C++
+2008 Express Edition.
+
+### Linux
+
+Go to the project directory and type `make`.
+
+### Mac OS X
+
+Open the Xcode project and build. I use Xcode 2.5 under Mac OS X 10.4.11.
+
+Installation
+------------
+
+### Windows
+
+Put the plugin file `npTuioClient.dll` under Firefox'/Mozilla's
+`plugin` directory. Mine is `C:\Program Files\Mozilla
+Firefox\Plugins`.
+
+If you are using Google Chrome, put the plugin under
+`C:\Users\<user>\AppData\Local\Google\Chrome\Application\Plugins`. Create the
+directory if necessary.
+
+### Linux
+
+Put the plugin file `npTuioClient.so` under `~/.mozilla/plugins`.
+
+### Mac OS X
+
+Put the plugin bundle `npTuioClient.plugin` under `~/Library/Internet Plug-Ins/`.
+
+Usage
+-----
+
+Install the plugin, open one of the example files on your browser and
+start using your multi-touch display!
+
+You can open multiple tabs or windows as long as they belong to the
+same browser instance. The plugin can't be used from multiple browsers
+at a time. This is because the TUIO Client library can only be started
+once at a time.
+
+Issues
+------
+
+* Firefox on Mac OS X crashes when the plugin is unloaded (all pages
+  that use the plugin are closed). This doesn't happen on Safari 4.0.
+  
+  TODO: check plugin's shutfown and bundle unloading.
+
+* Firefox on Linux can't cleanly close the TUIO connection. So, the
+  browser has to be restarted if the plugin want to be loaded again.
+  
+  TODO: check TUIO Client's stop function.
+
+
+