Home

David-Alexandre Chanel edited this page Jun 23, 2018 · 44 revisions
Clone this wiki locally

Presentation

Read the general presentation

(You can download the PDF from the website if needed)

Libs and examples

https://github.com/Theoriz

Simulator

Simulate moving people to test your app

simulator

download : https://github.com/Theoriz/Augmenta-Simulator/releases

source : https://github.com/Theoriz/Augmenta-Simulator

Augmenta Area2Osc

Optional app to trigger OSC messages depending of the people’s position in the scene

area2osc

download : https://github.com/Theoriz/Augmenta-Area2Osc/releases

source : https://github.com/Theoriz/Augmenta-Area2Osc

Data

    * Augmenta OSC Protocol :

        /au/personEntered   args0 arg1 ... argn
        /au/personWillLeave args0 arg1 ... argn
        /au/personUpdated   args0 arg1 ... argn

        where args are :

        
        0: pid (int)                        // Personal ID ex : 42th person to enter stage has pid=42
        1: oid (int)                        // Ordered ID ex : if 3 person on stage, 43th person might have oid=2
        2: age (int)                        // Time on stage (in frame number)
        3: centroid.x (float 0:1)           // Position projected to the ground
        4: centroid.y (float 0:1)               
        5: velocity.x (float -1:1)           // Speed and direction vector
        6: velocity.y (float -1:1)
        7: depth (float 0:1)                // Distance to sensor (in m) (not implemented)
        8: boundingRect.x (float 0:1)       // Top view bounding box
        9: boundingRect.y (float 0:1)
        10: boundingRect.width (float 0:1)
        11: boundingRect.height (float 0:1)
        12: highest.x (float 0:1)           // Highest point placement
        13: highest.y (float 0:1)
        14: highest.z (float 0:1)           // Height of the person

        /au/scene   args0 arg1 ... argn

        0: currentTime (int)                // Time (in frame number)
        1: percentCovered (float 0:1)       // Percent covered
        2: numPeople (int)                  // Number of person
        3: averageMotion.x (float 0:1)          // Average motion
        4: averageMotion.y (float 0:1)
        5: scene.width (int)                // Scene size
        6: scene.height (int)
        7: scene.depth (int)

Debug

You might need to check and see the data that you are receiving.

OSC

Osculator (Mac only) is a nice tool that can do graphs : http://www.osculator.net/

OSCTestApp (Mac only) is simple and useful : http://vidvox.com/rays_oddsnends/vvopensource_downloads/OSCTestApp_0.2.4.zip

OSC Data monitor (Mac / Windows / Linux) is opensource and good : https://code.google.com/p/osc-tools/

Syphon / Spout

(Mac) Syphon client/server

(Win) Spout Controls

Tools

To go further, some useful tools

Workshop download links

Contribute

You can contribute ! Follow the guide !