Download Print this page

Advertisement

Quick Links

This tutorial focuses on installing and calibrating the software, but doesn't cover the details of the hardware
setup. (Note: Do not plug the Kinect or projector unit until instructed by the tutorial.)
For detailed information on the hardware setup, see the AR Sandbox hardware tutorial.
Diversified Woodcrafts' ARS Series includes:
A Our first generation Kinect
B: Our short-throw digital projector (BenQ MW632ST)
C: Our Linux-friendly computer
D: Our 40"w x 30"D x 8"H Sandbox
(No t Included) Roughly 200 pounds of white sand like Sandtastik White Sandbox Sand
ARS | AUGMENTED REALITY SERIES
REQUIRED HARDWARE
https://system76.com/weekendproject/

Advertisement

loading
Need help?

Need help?

Do you have a question about the AUGMENTED REALITY Series and is the answer not in the manual?

Questions and answers

Summary of Contents for DIVERSIFIED WOODCRAFTS AUGMENTED REALITY Series

  • Page 1 ARS | AUGMENTED REALITY SERIES REQUIRED HARDWARE This tutorial focuses on installing and calibrating the software, but doesn’t cover the details of the hardware setup. (Note: Do not plug the Kinect or projector unit until instructed by the tutorial.) For detailed information on the hardware setup, see the AR Sandbox hardware tutorial.
  • Page 2 ARS | AUGMENTED REALITY SERIES INSTALL SOFTWARE A: Turn the computer on; make sure internet is connected B: Open a terminal and run these three commands (Note: All commands must be typed exactly as shown; upper and lowercase will make a difference):...
  • Page 3 ARS | AUGMENTED REALITY SERIES The image on the left is the depth view, the right is the standard camera view: The Augmented Reality Sandbox only uses the depth view (left), but the camera view (right) is still helpful in aligning your Kinect.
  • Page 4 ARS | AUGMENTED REALITY SERIES B: From a terminal, launch: the RawKinectViewer: RawKinectViewer -compress 0 C: Maximize this window so it’s easier to see your sandbox: D: Press and hold the right mouse button, move your cursor over Average Frames, then release the mouse button: https://system76.com/weekendproject/...
  • Page 5 ARS | AUGMENTED REALITY SERIES E: Press and hold the key, move your cursor over Extract Planes, then release the 1 key: F: You now need to draw a rectangle that fits within the interior of your flat surface (in the depth view).
  • Page 6 ARS | AUGMENTED REALITY SERIES G: Hit Esc to close the RawKinectViewer. H: In the terminal you’ll see two lines printed. Select the portion of the 2nd line shown below, then right click and select Copy: Edit the BoxLayout.txt file by running this command from the terminal: gedit /etc/SARndbox-1.6/BoxLayout.txt...
  • Page 7 ARS | AUGMENTED REALITY SERIES MEASURE 3D EXTENTS OF SAND SURFACE A: This step requires you to have filed your sandbox with sand. You want the sand surface to be as level as possible, but it doesn’t need to be perfectly level.
  • Page 8 ARS | AUGMENTED REALITY SERIES You’ll now measure the 3D extents of the interior of the sandbox F: Use the color-coded depth map to make sure you position your cursor over the sand surface and not over the sides of your sandbox. Position your cursor so that there’s a small amount of space between the sand surface and the sides of your sandbox.
  • Page 9 ARS | AUGMENTED REALITY SERIES G: Second, move your cursor to the lower-right interior corner, then press the key: H: Third, move your cursor to the upper-left interior corner, then press the key: https://system76.com/weekendproject/...
  • Page 10 ARS | AUGMENTED REALITY SERIES Finally, move your cursor to the upper-right interior corner: then press the key: J: Hit to exit RawKinectViewer . K: In the terminal you’ll see four lines printed. You need to highlight these four lines as shown below,...
  • Page 11 ARS | AUGMENTED REALITY SERIES L: Edit the BoxLayout.txt file by running this command from the terminal: gedit /etc/SARndbox-1.6/BoxLayout.txt M: Replace the bottom four lines in BoxLayout.txt with the four lines you just copied, so you end up with something like this:...
  • Page 12 ARS | AUGMENTED REALITY SERIES D: Launch the XBackground tool from a terminal like this: XBackground E: You’ll need to position the projector so that it fills the interior of your sandbox. It’s okay if it overlaps slightly. Use the p and q buttons on the projectors remote to fill the interior of the sandbox.
  • Page 13 ARS | AUGMENTED REALITY SERIES Replacing WIDTH and HEIGHT with the settings for your projector. The Kinect itself has a 4:3 aspect ratio, so a resolution like 1024x768 or 1600x1200 is best. To match the resolution of the laptop we used in this tutorial, we set our projector to 1920x1080, but our particular BenQ projector allows us to force a 4:3 aspect ratio even when the resolution is a 16:9 aspect ratio.
  • Page 14 ARS | AUGMENTED REALITY SERIES G: Press the key to capture the background image, after which you’ll briefly see a uniform red color projected onto your sandbox: After this is completed, you can proceed with the calibration. H: Next, you’ll capture tie-points at the lowest height. Using your shortest spacer, line-up your...
  • Page 15 ARS | AUGMENTED REALITY SERIES Now you’ll capture tie-points at the middle height. Using a taller spacer, line-up your alignment target under the white cross-hairs projected onto the sand surface: Then press the key to capture this tie-point. After a brief moment, the software will automatically move the projected cross-hairs to the next tie-point.
  • Page 16 ARS | AUGMENTED REALITY SERIES ADJUST THE “SEA LEVEL” A: Launch the main SARndbox application by searching for “sandbox” in the Ubuntu dash: B: Then maximize the application so it fills: your entire sandbox: C: If in step 4 you calculated the base plane with a piece of poster board (or a similar flat surface) on top of your sandbox, your sea level will be too high, and you’ll see something like this:...
  • Page 17 ARS | AUGMENTED REALITY SERIES D: Hit to close the AR Sandbox D: application. E: To adjust the sea level, edit the by running this command from /etc/SARndbox-1.6/BoxLayout.txt the terminal: gedit /etc/SARndbox-1.6/BoxLayout.txt The value highlighted below in controls the sea-level: BoxLayout.txt...
  • Page 18 ARS | AUGMENTED REALITY SERIES You can experiment with different values for the sea-level to suite your preferences, but our recommendations here will give you a good starting point. Note that you can adjust the sea level at any time in the future without recalibrating your sandbox.
  • Page 19 ARS | AUGMENTED REALITY SERIES This is a shortcut to launch with the following arguments (which you can also do directly SARndbox from a terminal): SARndbox -uhm -fpv -evr -0.01 -evr -0.01 bit of the above command sets the evaporation rate. Without any evaporation rate set, the sandbox will steadily fill with more and more water as you “make it rain”, which eventually...