AtmoUnityAPI interfaces Atmo with Unity. AtmoTracking is responsible for providing information about marker detections, AtmoLight is used to control the light strip in Atmo.
- Download the repository.
- Download the Atmo application.
- Create a new Unity project.
- Add a new resolution on the Game view with fixed resolution of 1280x800.
- Go to Edit | Project Settings | Player | PC, Mac & Linux Standalone settings | Other Settings | Optimization | API Compatibility Level and select ".Net 2.0".
- Copy the content of the AtmoUnityAPI-master/Assets folder in your Unity project's Assets folder.
- (a) Open the Example scene in the Example folder.
- (b) Start development with the Template scene in the AtmoUnityAPI folder.
- Start the Atmo application anc click Tracking to get marker detection information in Unity. If more cameras are attached to your computer, you'll have to choose the right camera id in the application.
The AtmoTracking gameobject is responsible for marker tracking. The TrackingHandler script provides marker detection information with the help of three events with a Marker object argument: onDetected, onRedetected and onLost.
This event is invoked when a new marker is detected on the table.
This event is invoked when a marker disappears from the table. This can also happen if a marker is hidden by another object or by someone's hand.
Lost markers are saved in a history for 5 seconds. In case the same marker appears on the same location within this 5 seconds, this event is invokeded instead of the onDetected.
The marker object contains the following information about a marker:
int markerID; // id of the marker, same for identical markers
int uniqueID; // unique id of detection, remains the same for all three events invoked by the same detection
Vector2 Position; // postion of the marker in Unity world space
Listeners to the events can be either added on the editor or in script.
GetComponent<TrackingHandler>().onDetected.AddListener(HandleOnDetected);
GetComponent<TrackingHandler>().onReDetected.AddListener(HandleOnRedetected);
GetComponent<TrackingHandler>().onLost.AddListener(HandleOnLost);
void HandleOnDetected(Marker marker) {
//Your code to handle new markers
}
void HandleOnRedetected(Marker marker) {
//Your code to handle redetected markers
}
void HandleOnLost(Marker marker) {
//Your code to handle lost markers
}
The AtmoLight gameobject is responsible for controlling the 144 pixel LED strip in Atmo.
The public functions in the Strip script can be used for controlling the LED pixels. Best way to use it is to add a new script to AtmoLight, get the Strip script from there and call the needed functions.
Strip strip;
void Start() {
strip = GetComponent<Strip>();
// This sets all pixel colors to red
strip.SetAll(new Color32(200,0,0,255));
}
Functions usally take a Vector3 or Color32 color argument. In case of Vector3, (x,y,z) attributes stand for (r,g,b). In case of Color32, the a (alpha) argument is only used for the virtual representation of the LED pixels but not for the real ones.
LED pixels are also visualised on the Scene as spheres. This can help to sync orientation of light animations with projections.
Open the Example scene in the Example folder. This basic application provides a basic summary of the AtmoUnityAPI. It highlight markers on the table with the corresponding colors denoted on the interface. Furthermore, lights can be controled with buttons and sliders on the screen.
