This software is an application sending TUIO messages describing the Chilitags fiducial markers detected by a camera. Its goal is to facilitate the use of Chilitags in any TUIO capable application, even if it is written in a different language than the one used by the Chilitags library (C++). For further information about Chilitags, please visit Chili's Webpage. For further information on the TUIO protocol and framework, please visit TUIO.org.
This software depends on the chilitags library and OpenCV's highgui and core package.
chilitags-tuio [x-cam-resolution y-cam-resolution] [camera-index] [host port] [hideFeedback]
x-cam-resolution y-cam-resolution are the resolution parameters to give to the camera. The default resolution is 640x480 pixels.
camera-index is the index of the camera to use to detect chilitags. By default, it is 0, which corresponds to the first camera of the system. If multiple cameras are attached to the computer, you can select them by increasing this index.
host port are the parameters to configure the connection between the tuio server and clients.
The defaults value correspond to the port 3333 on localhost.
hideFeedback if there is a 6th parameter (any) no video feedback will be shown
The TUIO messages sent by this software describe chilitags as 2D Objects, which means that they provide their identifier, position, orientation, speed, acceleration, rotational speed and rotational acceleration.
The TUIO messages do not contain the scale, width and height of the chilitags, even though they would be easily computed. It would be similarly easy to send messages describind the tags in 3D, given that the 3D estimation is built in Chilitags.
You are welcome to manifest your interest in such features, or your own contribution implementing them!
This software is based on the TUIO C++ Reference Implementation and Demo Applications (Copyright 2005-2009 Martin Kaltenbrunner), which is part of reacTIVision, an open source fiducial tracking and multi-touch framework based on computer vision.
This program uses the oscpack OpenSound Control library.
Chilitags Tuio Server is released under the GPL.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
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 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA02111-1307USA
We especially appreciate a reference in your paper, should you use Chilitags for a research project. Let us make that easy for you:
- Chilitags: Robust Fiducial Markers for Augmented Reality. Q. Bonnard, S.
Lemaignan, G. Zufferey, A. Mazzei, S. Cuendet, N. Li, P. Dillenbourg.
CHILI, EPFL, Switzerland.
http://chili.epfl.ch/software. 2013.
@misc{chilitags,
title = {Chilitags 2: Robust Fiducial Markers for Augmented Reality and Robotics.},
author={Bonnard, Quentin and Lemaignan, S\'{e}verin and Zufferey, Guillaume and Mazzei, Andrea and Cuendet, S\'{e}bastien and Li, Nan and Dillenbourg, Pierre},
publisher={CHILI, EPFL, Switzerland},
url={http://chili.epfl.ch/software},
year={2013}
}