***********************************
*                                 *
*         SeaSee v. 2.2           *
*                                 *
* http://SeaSee.EndOfInternet.net *
*                                 *
***********************************


Purpose of the pogram:
======================

-calculats course and distance between two geographic points,
-determining the deviation of the sailing course from planned course,
-off-line planning and analysis of maritime travel.


Features:
=========

-shows GPS position and other data,
-calculates course and the distance between 2 points,
 (before use, the map is necessary to calibrate = enter coordinates for a 2 known points),
-views of user provided maps in .png and .jpg formats,
-works without any data transfer from the Internet,
-program tested on Sony Ericsson K770i, Nokia 6220 classic
-data can be transfered from mobile to mobile or to a PC,
-internal and external (Bluetooth) GPS supported


Instalation:
============

-install SeaSee.jar on the device,
-copy the map (the file extension .png or. jpg) in the device memory or memory stick,
-optionally, copy the calibration data (the name of the file is file.jpg.txt or file.png.txt) if you have it,
-enable read/write data.

Example: Adriatic_Sea_map.jpg, Adriatic_Sea_map.jpg.txt


Starting the application:
=========================

When starting the application it is necessary to allow the read/write data.
When you first start, the application displays a menu to choose image.
On second and more starts, after the first successful map view and the correct exit the application,
the map last called will be shown.


Working modes:
==============

* - navigation: displays GPS data, position and planed path
/ - calculation: calculate course and distance betwen two points, display geographic coordinates of a point
: - calibration: select two known points and enter their coordinates in order to calibrate the map


Functions of the soft keys:
===========================

depends on a mobile phone, for Nokia:

LEFT  => displays menu
RIGHT => exit application

for Sony Ericsson:

LEFT  => exit application
RIGHT => display menu  


Functions of the navigation keys:
=================================

LEFT   => move left (modes :/)
RIGHT  => move right (modes :/)
UP     => move up (modes :/, browser)
DOWN   => move down (modes :/, browser)
SELECT => center map (modes :/), load map (browser)


Functions of the numeric keys:
==============================

1 whole image (modes */:)
2 rotate 90o CW (modes */:)
3 to actual size (modes */:)
4 zoom in (modes */:)
5 large/small pan (modes /:), stop/start cycle display (mode *)
6 zoom out (modes */:)
7 pick point (modes /:)
8 enter coordinates (mode :)
9 clear points (modes /:)
0 load map (modes */:)
* select mode (modes */:)
# exit (modes */:)


Menu:
=====

Map shown:
- Calculation / => enters Calculation mode
- Navigation *  => enters Navigation mode
- Calibration : => enters Calibration mode
- Load map      => enters File Browser where you can load map
- Info          => displays additional information, depending on mode
- Help          => displays Help, a description of the button functions and other

File browser:
- Select        => loads selected map
- Settings      => set the units in nm or km, choose the language, sets backlight
- GPS Settings  => choose GPS device


Navigation mode *
=================

Data from GPS (position, moving direction, coordinates/speed/altitude) are displayed in this mode.

Coordinates are displayed when the GPS connection is realised. Position is displayed on map in case when calibration is 
completed and cordinates are within the map. Otherwise only coordinates and direction is displayed. Moving direction is 
dispayed with arrow, which changes colour from red to white, and vice versa, when new position is accepted.
At low speeds (less then 150 m/min), the moving direction error is great and arrow is unusable. 


Calculation mode /
==================

Course and path length are displayed in the title picture if small pan is selected (by key 5),
the map is calibrated and the start and the end point of path are entered.


Calibration mode :
==================

Pick two points and enter their coordinates in order to calibrate the map.

Rotation of the map (=angle of the North on the map and the top of the screen) is displayed in the title picture if:
- small pan is selected  (by key 5),
- calibration data are entered (file with calibration data exists).

The calculations are more precise if the map rotation deviation is smaller.


Error messages with error code:
===============================

IC 01 EX - invalid image or some other reason,
IC 01 IO - failed reading images,
IC 01 OM - not enough memory,
IC 02 OM - not enough memory,
IC 02 EX - not enough memory or some other reason,
IC 03 EX - error description, error during fit to screen action
IC 04 EX - error description, error during zoom-out action
IC 05 EX - error description, error during zoom-in action
IC 06 OM - not enough memory, 
CF 01 - incorrect calibration geographic coordinates (longuitude or latitude),
BT 01 BSE - error description, unable to use a bluetooth device
BT 01 BSE EX - error description, unable to use a bluetooth device
BT 02 SER EX - error during connecting to satelit
BT 02 DEV EX - connection to bluetooth failed
BT 03 EX - error description, error during external GPS data reading
BT 03 DEV EX - error description, error during discovering external GPS
BT 04 SER EX - error description, error during external GPS data reading

Notes:

There is no message when someone turn-off connected GPS. To reconnect, user must open GPS Settings and exit with OK, 
or exit from program and reenter to it.

"Image can not be displayed", note in the middle of the screen - out of memory or some other reason.

In the case of low memory, program shows the whole map, if for that view has enough memory.


Licenses:
=========

Adriatic_Sea_map.jpg

http://en.wikipedia.org/wiki/File:Adriatic_Sea_map.png

"This file is licensed under the Creative Commons Attribution ShareAlike 3.0 License.
In short: you are free to share and make derivative works of the file under the conditions that
you appropriately attribute it, and that you distribute it only under a license identical to this one.
Official license "

Application development is based on samples:

-Photo Album (Net Beans sample),
-UIDemo (Net Beans sample),
-raster image support (various samples),
-file browser and image canvas (Copyright 2004 Nokia Corporation):

 "THIS SOURCE CODE IS PROVIDED 'AS IS', WITH NO WARRANTIES WHATSOEVER,
  EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY, FITNESS
  FOR ANY PARTICULAR PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE
  OR TRADE PRACTICE, RELATING TO THE SOURCE CODE OR ANY WARRANTY OTHERWISE
  ARISING OUT OF ANY PROPOSAL, SPECIFICATION, OR SAMPLE AND WITH NO
  OBLIGATION OF NOKIA TO PROVIDE THE LICENSEE WITH ANY MAINTENANCE OR
  SUPPORT. FURTHERMORE, NOKIA MAKES NO WARRANTY THAT EXERCISE OF THE
  RIGHTS GRANTED HEREUNDER DOES NOT INFRINGE OR MAY NOT CAUSE INFRINGEMENT
  OF ANY PATENT OR OTHER INTELLECTUAL PROPERTY RIGHTS OWNED OR CONTROLLED
  BY THIRD PARTIES

  Furthermore, information provided in this source code is preliminary,
  and may be changed substantially prior to final release. Nokia Corporation
  retains the right to make changes to this source code at
  any time, without notice. This source code is provided for informational
  purposes only.

  Nokia and Nokia Connecting People are registered trademarks of Nokia
  Corporation.
  Java and all Java-based marks are trademarks or registered trademarks of
  Sun Microsystems, Inc.
  Other product and company names mentioned herein may be trademarks or
  trade names of their respective owners.

  A non-exclusive, non-transferable, worldwide, limited license is hereby
  granted to the Licensee to download, print, reproduce and modify the
  source code. The licensee has the right to market, sell, distribute and
  make available the source code in original or modified form only when
  incorporated into the programs developed by the Licensee. No other
  license, express or implied, by estoppel or otherwise, to any other
  intellectual property rights is granted herein."

-calculations based on geographic coordinates (various samples),
-GPS (Copyright ? 2009 Silent Software (Benjamin Brown):

"All rights reserved. This program and the accompanying materials
are made available under the terms of the Common Public License v1.0
which accompanies this distribution, and is available at
http://www.opensource.org/licenses/cpl1.0.php)"
