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:
=========

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


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

-install SeaSee.jar on the device,
-copy the map (the file extension .png or. jpg) in the device memory or memory stick,
-copy the calibration data (the name of the file is file.jpg.txt or file.png.txt) - optionally in the case of transfer from the device, which have already entered data,
-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 starta, after the first successful map view and the correct exit the application, the map was last called will be shown.
When starting the application and choosing the image, program enters in calibration mode, if the file with calibration data doesn't exists.


Options menu:
=================

- Map: the map view,
- Settings: set the units in nm or km, choose the language
- Help: a description of the button functions when the map shows,
- Exit: exit the application.


Function keys (map shown):
==================================

1 display whole,
2 rotate
3 to actual size (with note of the image and the screen dimensions, except in case of error),
4 zoom in,
5 large/small pan,
6 zoom out,
7 select point,
8 geographic coordinates (for "calibration")
9 delete selection,
* choose working mode,
0 to menu,
# exit.


Course and length of the path (map shown)
=========================================

Course and length of time displayed in the title picture if:
- program is in mode "path"
- small pan is selected  (by key 5),
- calibration data are entered (file with calibration data exists),
- the starting and end point of path are entered.


Map rotation (map shown)
===========================================

Rotation of the map (=angle of the North on the map and the top of the screen) is displayed in the title picture if:
- program is in mode "calibration"
- 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 is smaller.


Error messages:
===============

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 code,
IC 04 EX - error code,
IC 05 EX - error code,
IC 06 OM - not enough, 
CF 01 - incorrect coordinates (longuitude or latitude).

"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 "


TODO:
=====

-view of the data and the current position from GPS device
-works only in first quadrant: in the range of N from 0 to 90 deg and E from 0 to 180 deg (one quadrant),
-works only on a proportional bitmap,
-it is questionable how big is an error in path calculation,
-paths with more than 2 points,
-view of the same path on many cards,
-data export in XML format for off-line processing (route planning, time and cost analysis of travel)
-touch-screen functions.
