Make sure you have Processing3 and reacTIVision installed. Then check out this repository. If you're not comfortable with git, you can just download the code as a zip file.
Manipul8 uses semantic versioning to keep track of versions. This helps with communication,
so that we know which code has errors or new features. You can always see the current version of your
code at the top of Settings, and in the log when you start the app. You can select a version to download
by selecting a particular tag in the Branch
dropdown on this page.
If fiducials are not showing up where you expect them on the screen, you probably need to run configuration.
Press n
to start configuration. You will see four crosshairs appear, one at a time, in each corner of the screen.
Position a fiducial over each crosshairs and then press c
.
If the sizes of objects on the screen are wonky, change values in Settings.
Manipul8 can be tested indepentently of the TUIO table using the reacTIVision TUIO simulator.
After you download and upack the files, replace resources/config.xml
with the version included in this repository so
that you will have access to the proper fiducial IDs.
There is also a built-in testing interface, where the mouse cursor serves as a fiducial and you can use different
keys to switch the fiducial ID. To use this mode, set USE_TEST_INTERFACE
to true
in Settings. More information
on the controls will be printed to the log when you start the app.