Skip to content
Ross D Milligan edited this page May 2, 2016 · 16 revisions

ArkwoodAR Documentation

ArkwoodAR is a Python Augmented Reality application for Google Cardboard.

To see how it works, check out my ArkwoodAR video.

Software requirements

Here are the dependencies, each with their recommended version number:

  • Python 2.7.11
  • PyOpenGL 3.1.1b1
  • OpenCV 2.4.9
  • NumPy 1.10.1
  • PIL 1.1.7

Setting up the application

To learn how to use the application with Google Cardboard, check out my posts:

Augmented Reality with Google Cardboard

Augmented Reality with Google Cardboard (Mark II)

Features

Media Cube feature

Set MediaCube=True in the ArkwoodAR appsettings.ini file.

Two markers are supplied with the feature, to print out and use: marker_one.png and marker_two.png

The Media Cube feature puts a 3D shape on a marker, right in front of our eyes. We can walk around each side of the cube. On one side of the cube, a video is playing of a skeleton in a chair.

Media Cube One

On another marker the book cover of The Inscrutable Diaries Of Rodger Saltwash appears.

Media Cube Two

If we turn the marker around, the book cover of Plastic Halo (a Hong Kong adventure novel) appears.

Media Cube Two Rear

Secret Item feature

Set SecretItem=True in the ArkwoodAR appsettings.ini file.

The Secret Item feature allows us to look around the room like a proper spy. If the secret item (in this case, a skull badge) is detected, a green rectangle is sketched about it. We have found our treasure!

Secret Item

Related posts

To learn how the application uses stereoscopic images, check out my post:

Stereoscopic images with OpenGL

To learn how the application displays video, check out my post:

Display video using OpenGL

To learn how the application caches, check out my post:

Caching with Augmented Reality

Further information

Any questions, please feel free to drop me a line over at my blog.