MINT-core 1.0.0 → 1.0.1

data/Gemfile

@@ -1,17 +1,4 @@
 source :rubygems
 
-gem "MINT-statemachine","1.2.3"
-gem "MINT-scxml",  "1.0.0"
-gem "rspec", "1.3.1"
-gem "dm-core","0.10.2"
-gem "dm-rinda-adapter", "0.1.2"
-gem "cassowary","1.0.0"
-gem "eventmachine", "0.12.10"
-gem "rake","0.9.2"
-gem "rmagick","2.12.2"
-gem "hoe", "2.9.6"
-gem "newgem","1.5.3"
-gem "rdoc","3.11"
-gem "json","1.5.1"
-gem "redis","2.2.1"
-gem "dm-types","0.10.2"
+gemspec
+gem "rdoc"

data/Gemfile.lock

@@ -1,69 +1,34 @@
+PATH
+  remote: .
+  specs:
+    MINT-core (0.0.1)
+      MINT-statemachine (~> 1.2.2)
+      cassowary (~> 1.0.0)
+      dm-rinda-adapter (~> 0.1.0)
+
 GEM
   remote: http://rubygems.org/
   specs:
-    MINT-scxml (1.0.0)
-      MINT-statemachine (~> 1.2.3)
     MINT-statemachine (1.2.3)
-    RedCloth (4.2.8)
-    activesupport (2.3.14)
     addressable (2.2.6)
-    bcrypt-ruby (2.1.4)
     cassowary (1.0.0)
     dm-core (0.10.2)
       addressable (~> 2.1)
       extlib (~> 0.9.14)
     dm-rinda-adapter (0.1.2)
       dm-core (~> 0.10.2)
-    dm-types (0.10.2)
-      bcrypt-ruby (~> 2.1.2)
-      dm-core (~> 0.10.2)
-      fastercsv (~> 1.5.0)
-      json_pure (~> 1.2.0)
-      stringex (~> 1.1.0)
-      uuidtools (~> 2.1.1)
-    eventmachine (0.12.10)
     extlib (0.9.15)
-    fastercsv (1.5.4)
     hoe (2.9.6)
       rake (~> 0.8)
-    i18n (0.6.0)
-    json (1.5.1)
-    json_pure (1.2.4)
-    newgem (1.5.3)
-      RedCloth (>= 4.1.1)
-      activesupport (~> 2.3.4)
-      hoe (>= 2.4.0)
-      rubigen (>= 1.5.3)
-      syntax (>= 1.0.0)
-    rake (0.9.2)
+    json (1.5.4)
+    rake (0.9.2.2)
     rdoc (3.11)
       json (~> 1.4)
-    redis (2.2.1)
-    rmagick (2.12.2)
-    rspec (1.3.1)
-    rubigen (1.5.6)
-      activesupport (>= 2.3.5)
-      i18n
-    stringex (1.1.0)
-    syntax (1.0.0)
-    uuidtools (2.1.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  MINT-scxml (= 1.0.0)
-  MINT-statemachine (= 1.2.3)
-  cassowary (= 1.0.0)
-  dm-core (= 0.10.2)
-  dm-rinda-adapter (= 0.1.2)
-  dm-types (= 0.10.2)
-  eventmachine (= 0.12.10)
-  hoe (= 2.9.6)
-  json (= 1.5.1)
-  newgem (= 1.5.3)
-  rake (= 0.9.2)
-  rdoc (= 3.11)
-  redis (= 2.2.1)
-  rmagick (= 2.12.2)
-  rspec (= 1.3.1)
+  MINT-core!
+  hoe (~> 2.9)
+  rdoc

data/History.txt

@@ -1,3 +1,7 @@
+=== 1.0.1 2011-11-09
+
+* Included all dependencies stored in Gemfile into the Rakefile / gemspec
+
 === 1.0.0 2011-11-01
 
 * Initial release

data/MINT-core.gemspec

@@ -2,32 +2,27 @@
 
 Gem::Specification.new do |s|
   s.name = %q{MINT-core}
-  s.version = "0.0.1"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = [%q{Sebastian Feuerstack}]
-  s.date = %q{2011-11-02}
-  s.description = %q{Multimodal systems realizing a combination of speech, gesture and
-graphical-driven interaction are getting part of our everyday life.
-
-Examples are in-car assistance systems or recent game consoles.
-Future interaction will be embedded into smart environments offering
-the user to choose and to combine a heterogeneous set of interaction
-devices and modalities based on his preferences realizing an ubiquitous
-and multimodal access.
-
-The MINT Framework enables the design, creation, and execution of
-multimodal interfaces.
-
-The MINT core gem contains all basic AUI and CUI models as well as
-the basic  infrastructure to create interactors and mappings. Please
-not that you need at least a CUI adapter gem to be able to actually
-run a system, e.g. the MINT-rails gem.}
+  s.date = %q{2011-11-08}
+  s.description = %q{Multimodal systems realizing a combination of speech, gesture and graphical-driven interaction are getting part of our everyday life.
+
+Examples are in-car assistance systems or recent game consoles. Future interaction will be embedded into smart environments offering the user to choose and to combine a heterogeneous set of interaction devices and modalities based on his preferences realizing an ubiquitous and multimodal access.
+
+This framework enables the modeling and execution of multimodal interaction interfaces for the web based on ruby and implements a server-sided synchronisation of all connected modes and media. Currenlty the framework considers gestures, head movements, multi touch and the mouse as principle input modes. The priciple output media is a web application based on a rails frontend as well as sound support based on the SDL libraries.
+
+Building this framework is an ongoing effort and it has to be pointed out that it serves to demonstrate scientific research results and is not targeted to we applied to serve productive systems as they are several limitations that need to be solved (maybe with your help?) like for instance multi-user support and authentification.  
+
+The MINT core gem contains all basic AUI and CUI models as well as the basic infrastructure to create interactors and mappings. Please note that you need at least a CUI adapter gem to be able to actually run a system, e.g. the MINT-rails gem. But for initial experiements ist enough to follow the installation instructions of this document.
+
+There is still no documentation for the framework, but a lot of articles about the concepts and theories of our approach have already been published and can be accessed from our project site http://www.multi-access.de .}
   s.email = [%q{Sebastian@Feuerstack.org}]
   s.executables = [%q{mint-aui}, %q{mint-cui-gfx}, %q{mint-juggernaut.sh}, %q{mint-tuplespace}]
   s.extra_rdoc_files = [%q{History.txt}, %q{Manifest.txt}, %q{PostInstall.txt}]
   s.files = [%q{Gemfile}, %q{Gemfile.lock}, %q{History.txt}, %q{MINT-core.gemspec}, %q{Manifest.txt}, %q{PostInstall.txt}, %q{README.rdoc}, %q{Rakefile}, %q{bin/mint-aui}, %q{bin/mint-cui-gfx}, %q{bin/mint-juggernaut.sh}, %q{bin/mint-tuplespace}, %q{lib/MINT-core.rb}, %q{lib/MINT-core/agent/agent.rb}, %q{lib/MINT-core/agent/aui.rb}, %q{lib/MINT-core/agent/auicontrol.rb}, %q{lib/MINT-core/agent/cui-gfx.rb}, %q{lib/MINT-core/agent/cuicontrol.rb}, %q{lib/MINT-core/mapping/complementary.rb}, %q{lib/MINT-core/mapping/mapping.rb}, %q{lib/MINT-core/mapping/on_state_change.rb}, %q{lib/MINT-core/mapping/sequential.rb}, %q{lib/MINT-core/model/aui/AIC.rb}, %q{lib/MINT-core/model/aui/AIChoice.rb}, %q{lib/MINT-core/model/aui/AIINChoose.rb}, %q{lib/MINT-core/model/aui/AIMultiChoice.rb}, %q{lib/MINT-core/model/aui/AIMultiChoiceElement.rb}, %q{lib/MINT-core/model/aui/AIO.rb}, %q{lib/MINT-core/model/aui/AIOUTDiscrete.rb}, %q{lib/MINT-core/model/aui/AISingleChoice.rb}, %q{lib/MINT-core/model/aui/AISingleChoiceElement.rb}, %q{lib/MINT-core/model/aui/AISinglePresence.rb}, %q{lib/MINT-core/model/aui/aic.png}, %q{lib/MINT-core/model/aui/aic.scxml}, %q{lib/MINT-core/model/aui/aichoice.png}, %q{lib/MINT-core/model/aui/aichoice.scxml}, %q{lib/MINT-core/model/aui/aio.png}, %q{lib/MINT-core/model/aui/aio.scxml}, %q{lib/MINT-core/model/aui/aisinglechoiceelement.png}, %q{lib/MINT-core/model/aui/aisinglechoiceelement.scxml}, %q{lib/MINT-core/model/aui/aisinglepresence.png}, %q{lib/MINT-core/model/aui/aisinglepresence.scxml}, %q{lib/MINT-core/model/aui/model.rb}, %q{lib/MINT-core/model/body/gesture_button.rb}, %q{lib/MINT-core/model/body/handgesture.rb}, %q{lib/MINT-core/model/body/head.png}, %q{lib/MINT-core/model/body/head.rb}, %q{lib/MINT-core/model/body/head.scxml}, %q{lib/MINT-core/model/cui/gfx/CIC.rb}, %q{lib/MINT-core/model/cui/gfx/CIO.rb}, %q{lib/MINT-core/model/cui/gfx/model.rb}, %q{lib/MINT-core/model/cui/gfx/screen.rb}, %q{lib/MINT-core/model/device/button.rb}, %q{lib/MINT-core/model/device/joypad.rb}, %q{lib/MINT-core/model/device/mouse.rb}, %q{lib/MINT-core/model/device/pointer.rb}, %q{lib/MINT-core/model/device/wheel.rb}, %q{lib/MINT-core/model/interactor.rb}, %q{lib/MINT-core/model/task.rb}, %q{lib/MINT-core/overrides/rinda.rb}, %q{script/console}, %q{script/destroy}, %q{script/generate}, %q{spec/AIC_spec.rb}, %q{spec/AISinglePresence_spec.rb}, %q{spec/MINT-core_spec.rb}, %q{spec/aio_agent_spec.rb}, %q{spec/aio_spec.rb}, %q{spec/aisinglechoice_spec.rb}, %q{spec/aisinglechoiceelement_spec.rb}, %q{spec/cio_spec.rb}, %q{spec/core_spec.rb}, %q{spec/music_spec.rb}, %q{spec/rcov.opts}, %q{spec/spec.opts}, %q{spec/spec_helper.rb}, %q{tasks/rspec.rake}, %q{.gemtest}]
-  s.homepage = %q{http://github.com/sfeu/MINT-core}
+  s.homepage = %q{http://www.multi-access.de}
   s.post_install_message = %q{PostInstall.txt}
   s.rdoc_options = [%q{--main}, %q{README.rdoc}]
   s.require_paths = [%q{lib}]
@@ -40,19 +35,61 @@ run a system, e.g. the MINT-rails gem.}
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<dm-rinda-adapter>, ["~> 0.1.0"])
-      s.add_runtime_dependency(%q<MINT-statemachine>, ["~> 1.2.2"])
+      s.add_runtime_dependency(%q<MINT-statemachine>, ["~> 1.2.3"])
+      s.add_runtime_dependency(%q<MINT-scxml>, ["~> 1.0.0"])
+      s.add_runtime_dependency(%q<cassowary>, ["~> 1.0.0"])
+      s.add_runtime_dependency(%q<dm-core>, ["~> 0.10.2"])
+      s.add_runtime_dependency(%q<dm-rinda-adapter>, ["~> 0.1.2"])
       s.add_runtime_dependency(%q<cassowary>, ["~> 1.0.0"])
+      s.add_runtime_dependency(%q<eventmachine>, ["~> 0.12.10"])
+      s.add_runtime_dependency(%q<rake>, ["= 0.9.2.2"])
+      s.add_runtime_dependency(%q<rmagick>, ["~> 2.12.2"])
+      s.add_runtime_dependency(%q<json>, ["~> 1.5.1"])
+      s.add_runtime_dependency(%q<redis>, ["~> 2.2.1"])
+      s.add_runtime_dependency(%q<dm-types>, ["~> 0.10.2"])
+      s.add_development_dependency(%q<rspec>, ["= 1.3.1"])
+      s.add_development_dependency(%q<hoe>, ["~> 2.9.6"])
+      s.add_development_dependency(%q<newgem>, ["~> 1.5.3"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.11"])
       s.add_development_dependency(%q<hoe>, ["~> 2.9"])
     else
       s.add_dependency(%q<dm-rinda-adapter>, ["~> 0.1.0"])
-      s.add_dependency(%q<MINT-statemachine>, ["~> 1.2.2"])
+      s.add_dependency(%q<MINT-statemachine>, ["~> 1.2.3"])
+      s.add_dependency(%q<MINT-scxml>, ["~> 1.0.0"])
       s.add_dependency(%q<cassowary>, ["~> 1.0.0"])
+      s.add_dependency(%q<dm-core>, ["~> 0.10.2"])
+      s.add_dependency(%q<dm-rinda-adapter>, ["~> 0.1.2"])
+      s.add_dependency(%q<cassowary>, ["~> 1.0.0"])
+      s.add_dependency(%q<eventmachine>, ["~> 0.12.10"])
+      s.add_dependency(%q<rake>, ["= 0.9.2.2"])
+      s.add_dependency(%q<rmagick>, ["~> 2.12.2"])
+      s.add_dependency(%q<json>, ["~> 1.5.1"])
+      s.add_dependency(%q<redis>, ["~> 2.2.1"])
+      s.add_dependency(%q<dm-types>, ["~> 0.10.2"])
+      s.add_dependency(%q<rspec>, ["= 1.3.1"])
+      s.add_dependency(%q<hoe>, ["~> 2.9.6"])
+      s.add_dependency(%q<newgem>, ["~> 1.5.3"])
+      s.add_dependency(%q<rdoc>, ["~> 3.11"])
       s.add_dependency(%q<hoe>, ["~> 2.9"])
     end
   else
     s.add_dependency(%q<dm-rinda-adapter>, ["~> 0.1.0"])
-    s.add_dependency(%q<MINT-statemachine>, ["~> 1.2.2"])
+    s.add_dependency(%q<MINT-statemachine>, ["~> 1.2.3"])
+    s.add_dependency(%q<MINT-scxml>, ["~> 1.0.0"])
+    s.add_dependency(%q<cassowary>, ["~> 1.0.0"])
+    s.add_dependency(%q<dm-core>, ["~> 0.10.2"])
+    s.add_dependency(%q<dm-rinda-adapter>, ["~> 0.1.2"])
     s.add_dependency(%q<cassowary>, ["~> 1.0.0"])
+    s.add_dependency(%q<eventmachine>, ["~> 0.12.10"])
+    s.add_dependency(%q<rake>, ["= 0.9.2.2"])
+    s.add_dependency(%q<rmagick>, ["~> 2.12.2"])
+    s.add_dependency(%q<json>, ["~> 1.5.1"])
+    s.add_dependency(%q<redis>, ["~> 2.2.1"])
+    s.add_dependency(%q<dm-types>, ["~> 0.10.2"])
+    s.add_dependency(%q<rspec>, ["= 1.3.1"])
+    s.add_dependency(%q<hoe>, ["~> 2.9.6"])
+    s.add_dependency(%q<newgem>, ["~> 1.5.3"])
+    s.add_dependency(%q<rdoc>, ["~> 3.11"])
     s.add_dependency(%q<hoe>, ["~> 2.9"])
   end
 end

data/README.rdoc

@@ -1,63 +1,229 @@
-= MINT-core
+= MINT Framework Core Platform
 
-* http://github.com/sfeu/MINT-core
+* http://www.multi-access.de
 
 == DESCRIPTION:
 
-Multimodal systems realizing a combination of speech, gesture and
-graphical-driven interaction are getting part of our everyday life.
+Multimodal systems realizing a combination of speech, gesture and graphical-driven interaction are getting part of our everyday life.
 
-Examples are in-car assistance systems or recent game consoles.
-Future interaction will be embedded into smart environments offering
-the user to choose and to combine a heterogeneous set of interaction
-devices and modalities based on his preferences realizing an ubiquitous
-and multimodal access.
+Examples are in-car assistance systems or recent game consoles. Future interaction will be embedded into smart environments offering the user to choose and to combine a heterogeneous set of interaction devices and modalities based on his preferences realizing an ubiquitous and multimodal access.
 
-The MINT Framework enables the design, creation, and execution of
-multimodal interfaces.
+This framework enables the modeling and execution of multimodal interaction interfaces for the web based on ruby and implements a server-sided synchronisation of all connected modes and media. Currenlty the framework considers gestures, head movements, multi touch and the mouse as principle input modes. The priciple output media is a web application based on a rails frontend as well as sound support based on the SDL libraries.
 
-The MINT core gem contains all basic AUI and CUI models as well as
-the basic  infrastructure to create interactors and mappings. Please
-not that you need at least a CUI adapter gem to be able to actually
-run a system, e.g. the MINT-rails gem.
+Building this framework is an ongoing effort and it has to be pointed out that it serves to demonstrate scientific research results and is not targeted to we applied to serve productive systems as they are several limitations that need to be solved (maybe with your help?) like for instance multi-user support and authentification.  
 
-== FEATURES/PROBLEMS:
+The MINT core gem contains all basic AUI and CUI models as well as the basic infrastructure to create interactors and mappings. Please note that you need at least a CUI adapter gem to be able to actually run a system, e.g. the MINT-rails gem. But for initial experiements ist enough to follow the installation instructions of this document.
 
-* still first alpha
+There is still no documentation for the framework, but a lot of articles about the concepts and theories of our approach have already been published and can be accessed from our project site http://www.multi-access.de .
+
+== FEATURES:
+
+* Interactor-based modeling (Widgets) of interface elements by using statemachines (see http://github.com/sfeu/MINT-statemachine )
+* Different to approaches like e.g. XHTML+Voice the mode and media synchronisation is implemented on the web server side, which enables interactions including several devices at the sam time and dynamically adding further media and modes during the interaction.
+* The srver side is implemented as a distributed system based on software agents and a tuple space that enables to distribute arbitrary parts of the system to different machines.  
+* Interactors can also be modelled using s basic subset of SCXML (in work, see http://github.com/sfeu/scxml )
+* A basic set of abstract (modality independent) interactors
+* A very limited set of concrete interactors for the web based on a rails frontend (see http://github.com/sfeu/MINT-rails )
+* Sound support (see http://github.com/sfeu/MINT-sdl )
+* A basic model inspector to observe the state of all interactors during runtime (see http://github.com/sfeu/MINT-debugger )
+* Automatic synchronisation of an abritary set of connected webbrowsers 
+* Basic constraint-driven automated ayouting on the server side that calculates pixel-exact coordinates for all interface elements based on the Cassowary constraint solver (see http://github.com/sfeu/cassowary )
+
+== LIMITATIONS:
+
+* No multi-user support or authentification, if another user connects to an application the presentation of the first user is mirrored to the second one.
+* The framework only runs on Ubuntu and installation has only be tested for version 10.04 LTS
+* We require ruby 1.8, the application threading model inside one agent is currently limited, but critical parts can be distributed to several agents instead.
+* we currenlty only support rails 2.3, because we rely on the execute action plugin that has no been ported to rails 3 so far. 
 
 == SYNOPSIS:
 
-run the agents
+For testing the framework please try first to run our example application! - See the install section for the instructions to get it running. 
+
+To start a new project:
+
+* install the MINT core gem
+
+ sudo gem install MINT-core
+
+* create a new rails application
+
+ rails sample_app
+
+* add the MINT-rails and the embedded-actions plugin
+
+ cd sample_app
+ ./script/plugin install https://github.com/sd/embedded-actions.git
+ ./script/plugin install https://github.com/sfeu/MINT-rails.git
+
+* copy the relevant javascript files and images to the rails app public folder
+ 
+ rake mint_rails:copy_assets
+
+* You need to add the following lines into your config/environment.rb file to disable active_record and to set your IP address. The former one disables active_record, which the MINT framework does not require (it also eliminates the sql-lite database requirement). The latter IP needs to be set to the IP from that you computer can be contacted from outside (if you want to offer the application to the internet) otherwise you can set it to the local 127.0.0.1 IP. 
+
+ config.frameworks -= [ :active_record ]
+ HOST_IP = '127.0.0.1' 
+
+* use the startup script to start the application
+
+ ./script/mint/startup.sh
+
+* Use Chrome our Chromium browser to access the application:
+
+ http://127.0.0.1:3000/mint
+ 
+* You should see the MINT-Logo as well as a working mouse pointer synchronisation (the green/red dot that follows the mouse pointer)
+
+* If your have troube, please contact us.
 
 == REQUIREMENTS:
 
-* MINT-statemachine
+* Ubuntu LTS 10.04 !! (we have not ported cassowary to newer versions!)
+* Ruby 1.8
+* WxWidgets (MINT-debugger)
+* libSDL (MINT-sdl for sound support)
+* libCassowary (for constraint solver)
+* libMagick (for layouting) 
+* several gems managed by bundler
 
 == INSTALL:
 
-sudo gem install MINT-core
+The following instructions work only with Ubuntu 10.04 - we have chosen this release because it is an officially long-term supported release (LTS).  
 
-== LICENSE:
+* Install ruby 1.8 your Ubuntu 10.04 machine and set a symlink 
+  
+  sudo apt-get install ruby1.8 ruby1.8-dev libopenssl-ruby rake
+  sudo ln -s /usr/bin/ruby1.8 /usr/bin/ruby
+
+* Install a recent ruby gems version from source and set a symlink (the 10.04 one is too old)
+
+ wget http://production.cf.rubygems.org/rubygems/rubygems-1.8.5.tgz
+ tar -xzvf rubygems-1.8.5.tgz
+ cd rubygems-1.8.5/
+ sudo ruby setup.rb
+ sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
+ sudo gem update --system
+
+* install native library dependencies that some gems like eventmachine, SDL or Magick or our framework requires and a working C compiler to compile them
+ 
+ sudo apt-get install build-essential libsdl-dev libsdl-mixer1.2-dev libmagickcore-dev libmagickwand-dev libwxbase2.8-0 libwxgtk2.8-0 libssl-dev ibfreetype6-dev gsfonts libjpeg62-dev
+
+* prevent installation of docs for all dependend gems (optional - but this will save you a lot of time) 
+
+include into file .gemrc in home folder  
+ 
+ gem: --no-ri --no-rdoc
+
+* install latest stable git for ubuntu 10.04 LTS (we require git with --recursive option support)
+ 
+ sudo apt-get install python-software-properties
+ sudo add-apt-repository ppa:git-core/ppa
+ sudo apt-get update
+ sudo apt-get install git-core
+
+* Install redis 2.2.4 from source (10.04 comes with redis v1 only)
+
+ wget http://redis.googlecode.com/files/redis-2.2.4.tar.gz
+ tar -xzvf redis-2.2.4.tar.gz
+ cd redis-2.2.4
+ make
+ sudo make install
 
-(The MIT License)
+* Install node.js version 0.4.12 
 
-Copyright (c) 2011 Sebastian Feuerstack
+ wget http://nodejs.org/dist/node-v0.4.12.tar.gz
+ cd node-v0.4.14
+ ./configure
+ make
+ sudo make install
 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
+* To install Juggernaut 2 install node package manager "npm" after node.js has been installed
+
+ sudo curl http://npmjs.org/install.sh | sudo sh
+ 
+* install juggernaut using the package manager
+
+ sudo npm  install -g juggernaut
+
+* Install libcassowary by adding a new package repository to /etc/apt/sources.lst
+
+ deb http://packages.multi-access.de lucid/
+
+* update system to consider new repository
+
+ sudo aptitude update
+
+* install cassowary library
+
+ sudo apt-get install libcassowary0
+
+* Install bundler
+
+ sudo gem install bundler
+
+* checkout an example app (MINT-MoBe2011) and let bundle install all gem dependencies (this will take a while if you have not disabled doc generation - see above)
+
+ git clone git://github.com/sfeu/MINT-MoBe2011.git
+ cd MINT-MoBe2011
+ bundle install 
+
+* start the example app (this will start a new tabbed console terminal 
+
+ ./script/mint/startup.sh
+
+* wait 30 seconds the use the latest google chrome or chromium browser to access the platform:
+
+ http://localhost:3000/mint
+
+* This should show a table with a letter in each cell above the MINT framework logo. You should also realize the server-sided mouse synchronisation that prints a green/red dot under the current mouse pointer location. You can test the synchronisation by opening another browser window and access the same url. While you are moving the mouse in one window, that dot should be synced on both browsers.
+
+* If you just see the MINT-Logo without a table your computer you should wait a bit more an reload the url.
+
+* If it is stil not working - write us an email.
+
+* Now you can play around with the debugger ( see http://github.com/sfeu/MINT-debugger for source code ) to observe all interactors state changes during runtime within the tuple space
+
+ ./schript/mint/debugger.sh
+
+* Check if the sound is working ( see http://github.com/sfeu/MINT-sdl for source code ) - a clicking sound should be played while pointing to the different cells.
+
+* Buy colored gloves and try our gesture recognition app ( will be releasen soon ) to navigate through the cells using hand postures.
+
+* Browse the source code, read (and cite) our papers to get a basic understanding of the framework components.
+
+* You have further ideas? Email us and help us improving the framework.
+
+== LICENSE:
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+The MINT framework is  developed by Sebastian Feuerstack Copyright (C)
+2010 and 2011 Sebastian Feuerstack
+
+This program is  free software; you can redistribute  it and/or modify
+it under the terms of the  GNU Affero General Public License version 3
+as published by the Free Software Foundation.
+ 
+This program  is distributed in the  hope that it will  be useful, but
+WITHOUT   ANY  WARRANTY;   without  even   the  implied   warranty  of
+MERCHANTABILITY  or FITNESS  FOR A  PARTICULAR PURPOSE.   See  the GNU
+General Public License for more details.
+ 
+You  should have  received a  copy of  the GNU  Affero  General Public
+License     along     with    this     program;     if    not,     see
+http://www.gnu.org/licenses or write  to the Free Software Foundation,
+Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ 
+You can contact Sebastian Feuerstack using the contact formular on his
+homepage http://www.feuerstack.org.
+ 
+The  modified source  and object  code versions  of this  program must
+display Appropriate Legal Notices, as  required under Section 5 of the
+GNU Affero General Public License version 3.
+ 
+In  accordance with  Section 7(b)  of the  GNU Affero  General Public
+License version  3, these Appropriate  Legal Notices must  retain the
+display of  the "Powered by MINT Framework" logo. If  the display of
+the  logo  is not  reasonably  feasible  for  technical reasons,  the
+Appropriate  Legal  Notices must  display the  words  "Powered by the
+MINT Framework".
 
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -3,7 +3,6 @@ gem 'hoe', '>= 2.1.0'
 require 'hoe'
 require 'fileutils'
 require 'rdoc/task'
-require './lib/MINT-core'
 
 Hoe.plugin :newgem
 # Hoe.plugin :website
@@ -15,9 +14,24 @@ $hoe = Hoe.spec 'MINT-core' do
   self.developer 'Sebastian Feuerstack', 'Sebastian@Feuerstack.org'
   self.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
   self.rubyforge_name       = self.name # TODO this is default value
-   self.extra_deps         = [['dm-rinda-adapter','~> 0.1.0'],
-                              ['MINT-statemachine','~> 1.2.2'],
-                              ['cassowary','~> 1.0.0']]
+  self.extra_deps         = [['dm-rinda-adapter','~> 0.1.0'],
+                             ['MINT-statemachine','~> 1.2.3'],
+                             ['MINT-scxml','~> 1.0.0'],
+                             ['cassowary','~> 1.0.0'],
+                             ["dm-core","~>0.10.2" ],
+                             ["dm-rinda-adapter", "~>0.1.2"],
+                             ["cassowary","~>1.0.0"],
+                             ["eventmachine", "~>0.12.10"],
+                             ["rake","0.9.2.2"],
+                             ["rmagick","~>2.12.2"],
+                             ["json","~>1.5.1"],
+                             ["redis","~>2.2.1"],
+                             ["dm-types","~>0.10.2"]]
+  self.extra_dev_deps   =    [["rspec","1.3.1"],
+                              ["hoe", "~>2.9.6"],
+                              ["newgem","~>1.5.3"],
+                              [ "rdoc","~>3.11"]  ]
+
 
 end
 

data/lib/MINT-core.rb

@@ -2,7 +2,7 @@ $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 module MINTCore
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'
 end
 
 require 'rubygems'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: MINT-core
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 21
   prerelease: 
   segments: 
   - 1
   - 0
-  - 0
-  version: 1.0.0
+  - 1
+  version: 1.0.1
 platform: ruby
 authors: 
 - Sebastian Feuerstack
@@ -15,10 +15,12 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-11-02 00:00:00 Z
+date: 2011-11-09 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id001 !ruby/object:Gem::Requirement 
+  name: dm-rinda-adapter
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -30,27 +32,43 @@ dependencies:
         - 0
         version: 0.1.0
   type: :runtime
-  requirement: *id001
-  prerelease: false
-  name: dm-rinda-adapter
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id002 !ruby/object:Gem::Requirement 
+  name: MINT-statemachine
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 27
+        hash: 25
         segments: 
         - 1
         - 2
-        - 2
-        version: 1.2.2
+        - 3
+        version: 1.2.3
   type: :runtime
-  requirement: *id002
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: MINT-scxml
   prerelease: false
-  name: MINT-statemachine
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id003
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id003 !ruby/object:Gem::Requirement 
+  name: cassowary
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
@@ -62,41 +80,242 @@ dependencies:
         - 0
         version: 1.0.0
   type: :runtime
-  requirement: *id003
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: dm-core
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 51
+        segments: 
+        - 0
+        - 10
+        - 2
+        version: 0.10.2
+  type: :runtime
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: dm-rinda-adapter
   prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 0
+        - 1
+        - 2
+        version: 0.1.2
+  type: :runtime
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
   name: cassowary
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id007
 - !ruby/object:Gem::Dependency 
-  version_requirements: &id004 !ruby/object:Gem::Requirement 
+  name: eventmachine
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 17
+        hash: 59
+        segments: 
+        - 0
+        - 12
+        - 10
+        version: 0.12.10
+  type: :runtime
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 0
+        - 9
+        - 2
+        - 2
+        version: 0.9.2.2
+  type: :runtime
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: rmagick
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 59
+        segments: 
+        - 2
+        - 12
+        - 2
+        version: 2.12.2
+  type: :runtime
+  version_requirements: *id010
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 1
+        - 5
+        - 1
+        version: 1.5.1
+  type: :runtime
+  version_requirements: *id011
+- !ruby/object:Gem::Dependency 
+  name: redis
+  prerelease: false
+  requirement: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 2
+        - 2
+        - 1
+        version: 2.2.1
+  type: :runtime
+  version_requirements: *id012
+- !ruby/object:Gem::Dependency 
+  name: dm-types
+  prerelease: false
+  requirement: &id013 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 51
+        segments: 
+        - 0
+        - 10
+        - 2
+        version: 0.10.2
+  type: :runtime
+  version_requirements: *id013
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id014 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 1
+        - 3
+        - 1
+        version: 1.3.1
+  type: :development
+  version_requirements: *id014
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id015 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 39
         segments: 
         - 2
         - 9
-        version: "2.9"
+        - 6
+        version: 2.9.6
   type: :development
-  requirement: *id004
+  version_requirements: *id015
+- !ruby/object:Gem::Dependency 
+  name: newgem
   prerelease: false
+  requirement: &id016 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 1
+        - 5
+        - 3
+        version: 1.5.3
+  type: :development
+  version_requirements: *id016
+- !ruby/object:Gem::Dependency 
+  name: rdoc
+  prerelease: false
+  requirement: &id017 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 3
+        - 11
+        version: "3.11"
+  type: :development
+  version_requirements: *id017
+- !ruby/object:Gem::Dependency 
   name: hoe
+  prerelease: false
+  requirement: &id018 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 2
+        - 9
+        version: "2.9"
+  type: :development
+  version_requirements: *id018
 description: |-
-  Multimodal systems realizing a combination of speech, gesture and
-  graphical-driven interaction are getting part of our everyday life.
+  Multimodal systems realizing a combination of speech, gesture and graphical-driven interaction are getting part of our everyday life.
+  
+  Examples are in-car assistance systems or recent game consoles. Future interaction will be embedded into smart environments offering the user to choose and to combine a heterogeneous set of interaction devices and modalities based on his preferences realizing an ubiquitous and multimodal access.
+  
+  This framework enables the modeling and execution of multimodal interaction interfaces for the web based on ruby and implements a server-sided synchronisation of all connected modes and media. Currenlty the framework considers gestures, head movements, multi touch and the mouse as principle input modes. The priciple output media is a web application based on a rails frontend as well as sound support based on the SDL libraries.
   
-  Examples are in-car assistance systems or recent game consoles.
-  Future interaction will be embedded into smart environments offering
-  the user to choose and to combine a heterogeneous set of interaction
-  devices and modalities based on his preferences realizing an ubiquitous
-  and multimodal access.
+  Building this framework is an ongoing effort and it has to be pointed out that it serves to demonstrate scientific research results and is not targeted to we applied to serve productive systems as they are several limitations that need to be solved (maybe with your help?) like for instance multi-user support and authentification.  
   
-  The MINT Framework enables the design, creation, and execution of
-  multimodal interfaces.
+  The MINT core gem contains all basic AUI and CUI models as well as the basic infrastructure to create interactors and mappings. Please note that you need at least a CUI adapter gem to be able to actually run a system, e.g. the MINT-rails gem. But for initial experiements ist enough to follow the installation instructions of this document.
   
-  The MINT core gem contains all basic AUI and CUI models as well as
-  the basic  infrastructure to create interactors and mappings. Please
-  not that you need at least a CUI adapter gem to be able to actually
-  run a system, e.g. the MINT-rails gem.
+  There is still no documentation for the framework, but a lot of articles about the concepts and theories of our approach have already been published and can be accessed from our project site http://www.multi-access.de .
 email: 
 - Sebastian@Feuerstack.org
 executables: 
@@ -189,7 +408,7 @@ files:
 - spec/spec_helper.rb
 - tasks/rspec.rake
 - .gemtest
-homepage: http://github.com/sfeu/MINT-core
+homepage: http://www.multi-access.de
 licenses: []
 
 post_install_message: PostInstall.txt