Here you will find all the information required to set up your own custom sandbox.
To run our software on you will need:
How to correctly place both Kinect sensor and the projector.
Sensor and projector placement without (left) and with (right) lens shift.
There are two things you'll have to bear in mind: the Augmented Reality Sandbox Software works best when the sensor is close to the light beam source and at the same time, it [sensor] should be placed approximately above the center of the sandpit. To meet both of these requirements we suggest using a lens shift projector. It may be slightly costlier, but will provide great quality of simulation and minimize errors.
Having the projector and Kinect far apart may result in parallel shifts in the projection. Those are usually not significant, but visible. We found that the best way to avoid this issue is to mount a lens shift projector close to the kinect and place them above the center of the sandpit. Such solution is only possible with this certain type of projector.
Remember that the Kinect sensor should be placed exactly above the center of the sandpit, facing downwards. See the overhead view image for clarification.
Drivers and packages necessary to run KinectSandbox and modules
Before you go to next steps check if software is working. Start software with given calibration. You will make your own later.press TAB
Step by step tutorial.
For best results the application requires scrupulous calibration. The outcome of the process depends heavily on surrounding conditions, especially the lighting. It should be constant, evenly distributed and very slightly dimmed, soft daylight-like.
Make sure there are no flashing lights nearby, such as TV screens, or faulty light bulbs. Also cover the windows in case weather conditions (clouds, etc.) could affect lighting in the room.
The areas right next to the sandbox have to be nonreflective – avoid things such as oil-painted walls or tile floors. If necessary, cover them with white paper sheets.
To correctly gather calibration data, sensor needs smooth, flat and preferably white surfaces.
Our suggestion is to use cardboard boxes of three different sizes listed below. They should be arranged so that the edges of the same length contact each other and only the height varies. It’s best to not leave any gaps between boxes, however if they occur (eg. because of size of the sandpit), fill them with white paper sheets, so that the lowest surface is also plain white. Also, keep in mind that the boxes should cover all the space lit by your projector and ideally even stick out a bit.
Box 1 – 20x20x20cm
Box 2 – 20x20x15cm
Box 3 – 20x20x10cm
Use this scheme to set up the boxes, starting from the edge of the sandpit:
During the calibration process you should be able to see a changing pattern, looking like the one on the right. Make sure it is on top of the projection and no other window is displayed above it.
Before running the calibration check if your display’s resolution matches that of your projector.
Calibration automatic mode:
Calibration manual mode:
It may happen that the calibration process doesn’t immediately give perfect results. This is mainly because it uses and depends on physical objects and can be affected by their imperfections. Usually it’s a matter of few simple steps to reach the wanted level of accuracy.
Should you still have problems with your calibration, keep the old and new calib files and contact us at [email protected]
Quick overview of the most important settings inside the application.
In this chapter you will find a simplified description of the software’s most important settings. They are pretty important to acknowledge before you start using your device. Press ‘Tab’ to open Settings Menu inside the application.
A detailed, full-lenght specification can be found here.
Note: to save setting changes made inside the app press Alt + F4 (exit).
Perhaps the most crucial parameters are 'Sandbox Top' and 'Bottom Level'. They specify the physical range of the Kinect sensor. See image for more details. Values of both levels are the distances in mm. The best way to achieve good results is to tape-measure and input the resulting numbers. We recommend that the values you enter have a margin of about 50-100 mm in both directions.In the picture you can also see a parameter called 'WaterDropOffset'. It is the distance [mm] above 'SandboxTopLevel' required to activate waterflow. The higher the value, the higher you will have to lift your arm to make it rain. To directly control basic water options use computer keyboard or mouse. Press space or middle-click mouse to reset water - it will sink into the ground. To disable waterflow press 'b' or right-click mouse. The same goes for enabling water flow again.
Another essential settings are the 'Borders'. Because Kinect has a 90º field of wiev, the area it sees is much larger than any sandpit and needs to be restricted. In the picture you can see an example of how the borders can turn out with default values. Kinect sees the whole sandpit, but also some of the surrounding area. It may happen that there is an obstacle in that region, e.g. a reflective wall. Restrict Kinect's field of view by setting your borders along the arrows to the point when they become visible in your sandpit. This will also ensure that no light escapes the box and your device looks much more professional.
Two last parameters you will need to adjust are 'TerrainTop & BottomLevel'. They control the projected level of terrain in your sandbox. (unlike 'SandboxTop/BottomLevel' which described physical values) If you set the two values close to each other, distances between neighboring isohypses will shrink. If you want to build high mountains and deep valleys, set the two values farther apart. Important thing to acknowledge: 'TerrainBottomLevel' value has to be lower than 'TerrainTopLevel' – the number is higher, since the values are negative. Note: pretty common mistake is to blame malfunctioned calibration for the projection being completely dark/white, when actually it is a matter of setting the 'TerrainLevels' right. If your 'SandboxBottomLevel' exceeds 1200, you will probably need to decrease 'TerrainBottomLevel' a bit to be able to see colours.
Button controller is used to switch the water simulation on and off, or reset it. With many people around the sandbox it is easy to flood the area. To avoid it, switch the water off and then back on after you are finished building. The water that is already flowing won’t disappear, until you reset it.
The button uses keyboard/mouse controls to interact with the application – space/middle-click is water reset and ‘b’/right-click is water on/off. You will need a control board that emulates a computer keyboard (e.g. Arduino Leonardo). It will write space when the button is pushed and ‘b’ when held. You can download the script here (you will also need software to upload it onto the board) and connection scheme here. Another way is to use a standard computer mouse, but replace its original buttons with external ones.
You can choose any button you want, as long as it is a normally open, monostable one. Mount it to your sandbox in a well-exposed place. To avoid it getting stuck with sand, choose a place above the sandpit level.
Below you will find a video tutorial with step-by-step instructions.
Additional feature for expanded functionality
As the touchscreen module is now available as a software extension, you can easily implement it in your custom Sandbox. This allows for quick control over the application via easy to use interface. Read more about touchscreen’s features and functionality here.
Now with the latest build of our KinectSandbox software you no longer have to match the resolutions of touchscreen and projector. The GUI will be automatically scaled to the size of the screen.
When setting up both screens in Windows, make sure they are next to each other (horizontally, not vertically). The projector should be the main display and touchscreen the secondary one.
Instead of a standard touchscreen you can use a tablet, your mobile phone or any other device capable of connecting to a wi-fi network. First set up the connection. You can either connect both devices to the same wireless network or, in case you want a faster and more reliable connection, use an additional router you will connect to your PC and use as a hub.
Next step is installing a screen-casting software on both devices. We use and recommend this app. After the installation open spacedesk on your mobile device and connect with the PC. If you have the KinectSandbox software running, it will restart automatically. You may need to configure Windows display settings. Make sure the projector is the main screen and the setup is ready to go.
Below you will find a video tutorial with step by step istructions.
Bring automation to your project
Automatic startup is a standard feature in almost all of our products. With a single push of a button the device powers up and starts the application. Same goes for shutdown.
You can automate your own sandbox under two conditions. First one is that your projector has a RS-232 port. Second is that you buy a license for the KinectSandbox app. You will then receive a software package with all required scripts and an instruction on how to install them.
For now, let’s focus on the hardware part. You will need:
From this point the procedure is very simple. Connect the projector to your computer and install all scripts as instructed. One thing that may actually cause problems is the cables. Never go for the cheapest ones and reduce their length if possible. Buy the adapter cable that uses PL2303 chipset if you manage to find one. For some adapters you will need to install additional drivers. Check in Windows’ device manager if you are missing any.
Alternatively you can use a null modem double female adapter to connect the USB – RS-232 cable to your projector. Decreasing the total length of wires can contribute to reliability of your system. However, remember it is never good to stretch the cables. If you are running out of length, just use a null modem cable as described above. Again, don’t buy the cheapest adapter you can find or the result can be counterproductive.
You will need Kinect 2 PC (it is Xbox ONE + PC adapter) You can buy refurbished one from the eBay.
Our system doesn't work with realsense. It is much much worse depth detector than Kinect 2. With Kinect 2 we get very accurate 3d model. We wish to use Azure Kinect in future.
We are going to release full video tutorial, as well as we want to update existing one. Operating buttons is very simple. You can use mouse or wireless mouse to be interface. Just get wires out form mouse buttons and connect your button. We also provide Arduino code for Arduino Leonardo/Micro pro control.
If you will make rigid frame for kinect + projector it will be stable. We have unit with wheels and tower that automatically goes up and there is no need to re-calibrate when moving unit. Calibration is very simple by the way - you need just white boxes.
Contact us, write about your project and let us think. At this moment price is very competitive.
We don't 🙂 We only estimate basing on our experience. We wanted to have affordable price even for small organizations but if there is a science center with thousands of visitors a day they have to pay. It's just about being fair.