====== Travel Cam ======

grp02
  - Naseer Ahmad
  - Fawad Ahmad
  -Zahir ul Din Babur

===== Idea =====
Take pictures as you travel and they are uploaded automatically on facebook.
The basic idea of the application was that user would be able to create an album on his facebook and would be able to upload photos to the respective album along with the coordinates of the place where the pic is take. And later on user would be able to connect to his facebook account via cellphone and would be able to view a google map showing pointers on the maps indicating different places from where user has taken pictures. 

==== Features ====
Taping on the pin would open a baloon, showin image, image name and location.
We changed the idea after two days of work, because we were having problems working with the facebook API. We managed to connect to the facebook and were able to get the basic information of the user as well; however facebook API did not allowing use to access the album table of the user. The only apparent reason for this was that the required functions of the API might have been deprecated. Therefore, we planed to cary out the similar idea but on our own FTP server. Basic steps which we had to carry out towards the completion of the project are listed below.

===== Implementation Plan and Goals =====
  - Creating accounts on the FTP server. Each user will have their own accounts. They can register by giving their email address and password.(Not achieved)
  - Connect to FTP server using the existing account.(Achieved)
  - Upload images on the FTP server. (Achieved)
  - Maintain a native database of images, their description and geo-coordinates of each image(Achieved)
  - Maintain a database on the server, keeping information of the images.(Achieved)
  - Synchronizing the native and server database(Achieved)
  - Browse the native photo album and create a list of photos to be uploaded. This task can be done offline.(Achieved)
  - User can view mapview on his cellphone showing pointers on the maps indicating different places from where user has taken pictures.(partially achieved)




===== Screen shots =====
{{:qt2010:grp2:screenshot_pic2.jpg|}}

===== Project Artefacts =====
==== Presentation slides ====

{{:qt2010:grp2:travel_cam.ppt|}}

==== Broucher ====
{{:qt2010:grp2:broucher.pdf|}}



==== Report document ====
{{:qt2010:grp2:travelcamreport.pdf|}}

==== Source Package ====
{{:qt2010:grp2:clientbackend.zip|}}

=== How to run software ===
The package was zipped in windows environment. After unpacking it, the project can be opened using 'Qt Creator' and built and executed using the UI.

Most of the settings are hard-coded so the 'serverAddress' and 'localHomeDir' variables should be initialized accordingly in the constructor of the 'FileManager' class. e.g. If a local ftp server is used for testing; you should use:

serverAddress= "127.0.0.1";
instead of...
serverAddress= "ftp.saimaa.1g.fi";

The given server should still be running, but since it is a valid server, the username and password which were hard-coded in the FileManager are now removed. You can contact group members personally if you need to test with this server.

The home directory for the pictures is currently "C:\\Workspace\\TCam\\myImages\\". So the images to be uploaded must be  placed at that path. Though the 'localHomeDir' variable can also be changed. 

'imageData.xml' (provided in the files folder in the package) should also be present in the debug/release folder while running the software.

===== Conclusion =====
It was great to work as a team and try to learn something new. The theme was good to provide some solution about the uploading of images as they are snapped and after working in the QT environment we found it quite exciting to fulfill the requirements.