# This is my README

Vuforia-Wall is a Virtual Reality iPhone App based on Vuforia-SDK from Qualcomm.
The simple idea is to provide a virtual image wall. Pick images from your iPhone camera or photo library, arrange them and watch them in Augmented Reality.

# INSTALLATION

* XCode IDE and Apple Developer Program
Make sure XCode is installed (https://developer.apple.com/xcode/) or install from the Mac App Store. To build Apps on the device, membership in the Apple iPhone Developer Program is required ($99/year)

* Qualcomm Vuforia SDK
Vuforia-Wall requires Qualcomm Vuforia SDK for iOS available from "https:// ar.qualcomm.at/qdevnet/sdk/ios". Download and install the SDK (vuforia-sdk- ios-1-5-8.zip). As of date, the working version is 1-5-8.
Per default the SDK is installed to ~/Development/iOS/vuforia-sdk-ios-1-5-8/.

To be sure everything works correct with your installation, try to compile the samples in ~/ Development/iOS/vuforia-sdk-ios-1-5-8/samples/.
You might get an error like "no valid provisioning device found". The problem is, in order to compile for devices, you need to have a valid Developer Certificate from the Apple Developer Program. Thus, without paying for the membership, you won't be able to simulate the Vuforia-SDK, as the Vuforia library only contains symbols for iOS devices, but does not work only with the iPhone Simulator.
Also note, that the ARC feature (Automatic Reference Counting) is quite new and the Vuforia SDK doesn't compile with ARC. When using ARC, you have to fix retain, release, and NSAutoReleasePool calls, as well as some retain properties to weak/strong. Therefore, prefer to disable ARC when you do a new project.


* Vuforia-Wall Xcode Project
Download and open Vuforia-Wall Xcode Project from github (https://github.com/Duffycola/ Vuforia-Wall). Alternatively, checkout the git repository using git:
	$ mkdir vuforia-wall
	cd vuforia-wall
	git init
	git remote add origin https://github.com/Duffycola/Vuforia-Wall.git
	git pull
	open vuforia-wall.xcodeproj

Possibly, the library paths are not correct. If libQCAR.a appears red (ext/Vuforia-SDK/ libQCAR.a) try to remove it from the project and manually add it again per Drag-and-Drop located at ~/Development/iOS/vuforia-sdk-ios-1-5-8/build/lib/arm/libQCAR.a.

Furthermore, make sure the project settings are similar to the following:
• HEADER_SEARCH_PATHS points to ~/Development/iOS/vuforia-sdk-ios-1-5-8/build/ include/
• LIBRARY_SEARCH_PATHS points to ~/Development/iOS/vuforia-sdk-ios-1-5-8/build/lib/ arm/

When you have installed a developer certificate correctly following the instructions in from the iPhone developer program website, CODE_SIGN_IDENTITY should point to your certificate, like in this screenshot.
Note, the project has a simulator target, but it will build without Vuforia SDK and thus Augmented Reality view will not be visible. This is useful for testing SDK unrelated code.


== EOF ==