View source for Mobile Tracker 3D

== Objective ==

The Mobile Tracker project consists of a set of mobile-device applications that utilize gesture recognition and pointing abilities to transform 3D models.  Each application is unique to a platform and interfaces with Slicer3 using the OpenIGTLink tracker interface.  The applications are designed to communicate with Slicer3 via a wireless TCP interface and are able to remotely discover services via various layered TCP discovery protocols.  Each application must be installed on a mobile device and the current version is compatible with all builds that include teh OpenIGTLink, available on Slicer 3.4 and later.

== History ==

*'''September 1, 2010''', Alpha version available for the iPhone4

== Screenshots ==

Please see attached screenshots

[[Image:MobileTrackerScreenshot1.png|300px|thumb|Tracking page of the iPhone mobile tracker showing the current transform matrix]]
[[Image:MobileTrackerScreenshot2.png|300px|thumb|Storing and editing a custom transform]]
[[Image:MobileTrackerScreenshot3.png|300px|thumb|The mobile application use the Bonjour networking protocol for discovery of available services]]
[[Image:MobileTrackerScreenshot4.png|300px|thumb|Saved tranformations]]

== Documentation ==

===iPhone4===

The iPhone package consists of 2 components, an installable app targeted at an iPhone4 running iOS 4.0 and higher, and a discovery application that is targeted at a host machine running Mac OS X 10.5 or greater.  Due to Apple restrictions, the iPhone app cannot be installed on a mobile device without being built in a compatible environment.  The source files referenced below contain an XCode project which can be built and installed on your device.  If you wish to be provided with an installable binary, please email me your device ID, and I will build you a demo app.  Instructions for obtaining the device ID are below.

==== Installing the Application ====

Download the software package and install it on your development machine.  You will need the iOS 4.0 SDK from the Apple developer website and a copy of the XCode software workplace.  

1) Open the Tracker3D folder, and then Tracker3D.xcodeproj file.

2) Connect your iPhone device and set it up for development, instructions are on the Apple developer website

3) Use the Window->Organizer link to verify that your mobile device is configured for development and that a provisioning profile is available.  If a provisioning profile is not installed, you can create a generic one by clicking on the + icon and entering your Apple developer login info.

4) Return to the project window and use the build menu in the upper left corner to select "Device"

5) Use the Build->Build and Run menu option to build and install the application on your device

6) Once the application is installed you can disconnect your device.

==== Installing the Server ====

1) Copy the server.app application to the Mac OS X machine that is hosting slicer 3.

2) Open slicer 3, and using the OpenIGTLink module, create a new connector.

3) Click on the "Server" and the "Active" button to run the server.  Leave the port at its default value of 18944.

4) Run the server.app application on your machine

==== Connecting to Slicer 3 ====

1) Open the Tracker3D application on your phone

2) Navigate to the "Settings" tab and click in "Search"

3) When the name of your host machine appears, select the item in the table

4) Wait for the status to change to "Connected"

5) Use the "Track" tab to enable/disable real time tracking data.  If the data communication is working the current matrix transform will be displayed by the server

6) Use the Data module in Slicer3 to move items to track under the "iPhoneTracker" link


== Download ==

Please email me for a copy of the binary if you want the latest version.  You can also access the package at the temporary link below:

[http://www.wikiupload.com/YMW1JHxh http://www.wikiupload.com/YMW1JHxh]