ArtifactVis with Android Device

Project Overview

This project allows the users to use the android device (as client) to connect with CalVR (as server) by TCP protocol, then they can move and interact with any object in the virtual world by using the android device with CalVR system. This project allows the users to move the object on the CalVR by using any kind of mode such as Move World, Scale, Drive and Fly then they can see the object movement changes on the android devise. Also, they can use the android device (client side) to move the camera around the object to see the object from all side. Finally, they can use the android device (client side) for picking object to receive pictures about this object. They can use all these techniques with Artifact Archeology project to interact with the historical object in the real world. Also they can use this plug-in with other projects.

Usage Instructions

• Server
  • This is the path to find the server code /home/saseeri/CVRPlugins/calit2/MagicLens
  • IP Address: Use this command line to find the IP address ifconfig
  • Use this PORT 28888
  • We can find objects on /home/saseeri/Development/OpenSceneGraph-Data folder

• Client
  • This is the path to find the client code /home/saseeri/CVRPlugins/calit2/MagicLens, the name of the folder OSGTest1-AndroidClient
  • IP Address: Use the same IP address on the server side and put it on the code
  • Use this PORT 28888
  • Use the same object that used in server side and put the object on the android memory card and wrtie this path on the code /mnt/sdcard/create_any_file name/object_name

To compile and run the code do the following:

Start with the server

• Go to this path on the terminal /home/saseeri/CVRPlugins/calit2/MagicLens

Write on the terminal

  make
  ...  
  CalVR

After that Copy the client code to the eclips workspase and do compile to the Android ndk (C++) by using the following:

• Go to this path on the terminal /home/saseeri/workspace/OSGTest1-AndroidClient

Write on the terminal

  ndk-build

Then go to the eclipse right click on the project then run it after you connect the android device

Software Tools and Equipment

Software Tools

On PC (Server):

• Linux Operating System
• OpenSceneGraph 3.1
• CalVR

On Phone Device (Client):

• Eclips
• Linux-sdk
• Android-ndk
• OpenSceneGraph 3.1 Android

Equipment

• Android Device (I used Galaxy Phone Samsung)

Installing OSG for Android on Linux OS

This is the path to find installing OSG for Android on Linux OS

/home/saseeri/CVRPlugins/calit2/MagicLens/Installing OSG for Android on Linux OS.pdf

Developers

Software Developer

• Sahar Aseeri

Project Advisor

• Jurgen schulze

Progress

Week 1

- look for tutorials on OSG (Done part of them)

- creating boxes and spheres (Done)

- displaying images from JPEG files (Working on it)

- mouse control: move/rotate objects in 3D (Done the rotation)

- understand the concept of a scene graph (Done)

Week 2

First: OpenSceneGraph

The resources that I used to learn OSG

"OpenSceneGraph 3.0 Beginner's Guide book" and the OpenSceneGraph website.

I read the following chapters:

Chapter 1: The Journey into OpenSceneGraph

Chapter 3: Creating Your First OSG Program

Chapter 4: Building Geometry Models

Chapter 5: Managing Scene Graph

Chapter 6: Creating Realistic Rendering Effects

Chapter 9: Interacting with Outside Elements

And some tutorial related to the following topics:

• Geometry

• 2D Text write function to set camera position in osg from head node: for

testing, transfer 4x4 matrix of head pos

• Transformation (Translation, Rotation, Scaling)

• Shapes (Box, Cone, Sphere, Capsule, Cylinder)

• Polygon mode

• 2D Texture (load image from images file)

• Interaction with outside element (keyboard and mouse)

I read the previous topics and ran them on my PC and made some changes to the code to understand what each method does in the code.

Second: CalVR

I read the CalVR website, and I will focus on it more on Monday

Third: Android

I started with android: installed it on my laptop, done the "Hello World" program and ran it in my android devise. I also read about the following topics:

• Camera

• Kind of sensor

• Activity

• Create list, buttons

roadblocks I have encountered:

• Working with OSG installation

• Write a makefile

• Working with some linux commands.

• Understanding CalVR (but I did not give CalVR much time to work on)

• There were no simple Examples for OSG on the internet so I used the book "OpenSceneGraph 3.0 Beginner's Guide book" to practice some simple examples.

• I couldn't understand some mathematical equations in your slides.

Summery

Look for tutorials on OSG and compile them on your PC in my lab Done

Creating boxes and spheres Done

Displaying images from JPEG files Done (I used the image as texture)

Mouse control: move/rotate objects in 3D Done (move/rotate objects in 3D and Picking objects)

Understand the concept of a scene graph Done

Go through the slides on this web site Done (Lecture 1, 2, 3, 4, 5, 6, 10) I read in general and will continue reading

Week 3

Reading and understanding the code (Done 60%)

Read about socket programming (Done without any practical code)

Week 4

Install OSG on the Android device (Motorola Xoom tablet) Done But it's doesn't work Load any Object and I apply rotation, translation, and scaling it by touch screen Done

Week 5

Continu install OSG on the Android device but on the Galaxy mobile Done' Load any Object and I apply rotation, translation, and scaling it by touch screen Done load excavation site model (osg file) into mobile with OSG Done But the output is a black screen

Week 6

osg::MatrixTransform * getObjectTransform () returns the position of the data set in room coordinates; send this to phone; on phone, put it in a MatrixTransform just above the node with the cow

TODO

• load excavation site model (VRML file) into tablet with osg:
  • osg::MatrixTransform * getObjectTransform () returns the position of the data set in room coordinates; send this to phone; on phone, put it in a MatrixTransform just above the node with the cow
  • Goal: when flying around data set in CalVR, the view on the phone should change accordingly
  • getHeadMat() returns the head position in room coordinates: this is constant at a desktop, but changes in the caves

- write function to set camera position in osg from head node: for testing, transfer 4x4 matrix of head position over wifi to tablet: this will effectively copy the view on the Calvr system to the tablet

- sense touch on artifact, then send touched artifact ID to Calvr computer, which will send associated photograph to tablet; display photograph on tablet. This will allow the user to view pictures associated with artifacts on the screen

- connect tracking system to tablet to allow moving tablet around starcave and view excavation site model from arbitrary perspectives on tablet screen.