﻿+--------------------------------------------------+
|Map2X - a simple navigation system for GP2X       |
+-------------------[ version 0.0.6 - 22.08.2008 ]-+
         __________________________________
__..--=={[[[        Installlation:      ]]]}==--..__
         ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨

Application doesn't contain any map package in order to save archive size.
Created map packages put into maps/ directory.

         __________________________________
__..--=={[[[         Controls :         ]]]}==--..__
         ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨

Using keyboard:

+---------+------+-------------------------------------+
|Windows  |GP2X  |Description                          |
+---------+------+-------------------------------------+
|ESC      |Y     |Show / hide toolbar or menu          |
|Arrows   |D-Pad |Movement in menu / toolbar / map     |
|Shift    |Select|Accelerated movement on the map      |
|Enter    |B     |Select menu item / icon on toolbar   |
|Backspace|X     |Return to parent menu or             |
|         |      |show / hide toolbar or menu          |
|Page Up  |L     |Move page up in menu                 |
|Page Down|R     |Move page down in menu               |
|NUM+     |VOL+  |Zoom in map                          |
|NUM-     |VOL-  |Zoom out map                         |
|Ctrl-C   |Start |Exit application                     |
+---------+------+-------------------------------------+

Using touchscreen:

Toolbar:
- click on icon to perform an action
- click besides icons to hide menu (if open)
- click outside the toolbar to hide

Menu:
- click on the heading (caption) to return to parent menu, or hide menu (if
  parent menu not exists)
- click on scrollbar to move menu to given position
- click on scrollbar arrows to move menu page up / page down
- click outside the menu to hide

Map:
- click anywhere on map to hide menu and toolbar
- push and hold map borders (32 pixels wide) to move on map, moving direction
  is from center of display to position of a click. Release to stop moving.
- click on a center of map to show toolbar

         __________________________________
__..--=={[[[          Functions:        ]]]}==--..__
         ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨

1) Map movement, zoom

2) Selection of map package
    You can open map packages saved in maps/ direcotry. If you want to create
your own package, follow the tutorials on the web:
http://mosra.bloguje.cz/tema-12-map2x-in-english.php

3) Choosing map type and overlay
    You can choose different map types (e.g. basic or terrain) and turn on map
overlay (e.g. land relief etc.). Overlay can cause slower performance when
loading new map tiles.

4) Menu and toolbar
    Menu and toolbar support localization into foreign languages, in lang/ dir
are conf files with translations (cz.conf, en.conf), if you want to, copy and
translate parameter values (read more below in the file about editing conf
files).
     If appears a long item in menu / toolbar, after a short delay begins
rolling to easy read all the text.
     After moving on an icon short help text appears on the toolbar.

5) Options
    Here you can set up behaviour of the application.

* Language - You can choose from all available languages in lang/ directory,
  setting will apply after restart of the application.
* Max FPS - Maximum count of frames per second, choose value from 15 to 150
  including unlimited FPS, if map movement seems to be jerky, increase the
  value.
* Show FPS - Whether show actual FPS on display.
* Show battery state - Whether show actual battery state on display.
* Smooth text - Smooth out sharp edges of text, can cause slower performance
  of application (not proved).
* Map move speed - Choose basic speed of map movement. Values from 25 to 200
  pixels per second.
* Speed multiply when moving fast - When fast move is activated (SHIFT or SELECT
  on GP2X), movement speed is multiplied by chosen value (from 2 to 5).
* Center cross - Enables or disables center pointing cross.

     You can set up the values from menu in application or in commented file
map2x.conf, if you want to set some non-standard value (e.g. 5 FPS). Read below
in file about editing conf files.

5) Save last position on map
    You can save position in toolbar, or application will ask on exit whether
to save last position. After next opening of the map package it will start on
the saved position.

         __________________________________
__..--=={[[[        Conf files:         ]]]}==--..__
         ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨

     Entire configuration of Map2X is saved into conf files. Main configuration
file is named map2x.conf and its configuration is also available from the menu
(see above). In lang/ directory are conf files with translations, in maps/ dir
are conf files describing individual map packages. Conf files are commented for
better understanding the meaning of the parameters.
     Comments begins with # or ;. For two-state parameters (e.g. smooth text in
map2x.conf file) use one of these pairs: on/off, 1/0, true/false, yes/no. Values
with more words (and spaces) enclose with quotes.
     Conf files save with UTF-8 encoding.
     When applicaions writes into conf file, preserve its structure including
blank lines and comments. Old conf file is backed up into a file with tilde ~ at
the end of filename, if some error happens, configuration can be restored from
this backup file.

Translations:

     You can try to translate the application into other languages, it's simple.
In lang/ directory are conf files with translations, just copy one of them and
translate the values into another language. First parameter __language shows
name of the language, which will be displayed in the menu. Language file must be
with .conf extension, just for order choose short abbreviations of language
names (cz, en).
     Because of UTF-8 support and international font used it will not be
problem with national characters and other alphabets (Cyrillic, Greek).
     I will be glad for any translation sent to me (contact below), it will
appear in the next release of Map2X.

         __________________________________
__..--=={[[[  Plans to next versions:   ]]]}==--..__
         ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨

+ Saving positions on map into favorites
+ POI (Points Of Interest) - http://en.wikipedia.org/wiki/Point_of_Interest
+ Speed up loading next map tiles (idividual thread to avoid freezing)
+ Support of another map servers: O2, Centrum.cz, Atlas.cz, OpenStreetMap, Yahoo
  etc. (suggest next...)
+ Route highlighting
+ etc.

         __________________________________
__..--=={[[[ Error reporting, suggests: ]]]}==--..__
         ¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨

I will be glad for your comments, found errors and ideas, write on:

E-mail:   mosra@centrum.cz
Jabber:   mosra@jabbim.cz
