README.md 2.93 KB
Newer Older
Phyks's avatar
Phyks committed
1
Touchless 3D Tracking
Lucas Verney's avatar
Lucas Verney committed
2
3
===================

Phyks's avatar
Phyks committed
4
5
This is based on an original project by [Kyle Mc Donald](https://github.com/kylemcdonald) : http://www.instructables.com/id/DIY-3D-Controller/.

Phyks's avatar
Phyks committed
6
Our slightly adapted setup is documented on my hacklab website [hackens.org)](http://hackens.org/) (in french, I may write english doc if some people are interested in that). All the documentation can be found here : http://hackens.org/Projets/TouchlessTracking **(in french, documentation will be written soon, after some extra tests)**.
Phyks's avatar
Phyks committed
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

In this repository, you'll find :

- A script to upload on the Arduino (we used an Arduino Uno) in the touchless_tracking folder
- Some python scripts to play with it on your computer

## Arduino script

Basically, the Arduino script reads discharge times for the three electrodes (this time is related to the distance between your hand and the electrode). 
It returns formatted lines on the Serial output like the following line :

```
value1␣value2␣value3␣\n
```

where `value1`, `value2`, `value3` are values directly proportional to the discharge time for the electrode (see the code for more infos).

## Python scripts

You'll also find some basic Python scripts as examples on possible use of the setup.

28
### Colors
Phyks's avatar
Phyks committed
29
30
31

This script represents the position of your hand in the RGB space. You can then pick a color by placing your hand at a specific point in the box of the electrodes.

32
### Chorizo player
Phyks's avatar
Phyks committed
33
34
35
36
37

__(working on)__

A script to play music using chorizo pads as a musical keyboard. See [our website](http://hackens.org/Projets/TouchlessTracking) (french, but vids are available, more coming soon) for infos and demos.

38
### 3d view
Phyks's avatar
Phyks committed
39
40
41
42
43

__(working on)__

Same as _colors.py_ but represents the position in real space (cube view) rather than in RGB space.

Phyks's avatar
Phyks committed
44
45
46
47
### Some ideas (TODO List)

* Then, use the previous code as a control interface for your computer, just like Minority Report :)
* Other ideas ? It's up to you :)
Phyks's avatar
Phyks committed
48
49

## Note about the license
Phyks's avatar
Phyks committed
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

TLDR; I don't give a damn to anything you can do using this code. It would just
be nice to quote where the original code comes from.

* -----------------------------------------------------------------------------
* "THE NO-ALCOHOL BEER-WARE LICENSE" (Revision 42):
* Phyks (webmaster@phyks.me) wrote this file. As long as you retain this notice
* you can do whatever you want with this stuff (and you can also do whatever
* you want with this stuff without retaining it, but that's not cool...). If we
* meet some day, and you think this stuff is worth it, you can buy me a
* <del>beer</del> soda in return.
*																		Phyks
* ------------------------------------------------------------------------------

## Thanks

* `Baltazar` from hackEns for his help to set it up and for the original idea.
* [Kyle Mc Donald](https://github.com/kylemcdonald) for his documentation on his setup
* [PRKTRNIC](http://vimeo.com/68763028) (video in french) for the idea about playing music with chorizo and sausages !