# Map This!/Operation
## Map selection screen

The first screen in Map This! is the map selection screen. If you have configured a STARTUPMAP in system/config.txt, this screen will be skipped, and the map will be opened with GPS mode on.

### Controls

* Up/Down: select map;
* Cross/Circle: open map;
* Select: exit Map This!.

## Map screen

After you choose a map, it will be displayed. Map This! will remember the previous location and zoom level on this map. This information is stored in MAP_PREF.TXT in the map directory, but only when exiting the map screen by pressing Select.
The functions below are accessible directly. Other functions are accessible in the Start menu. You can reach this menu by pressing Start.

### Moving around

There are a number of ways to change the view. The analog nub moves the cursor, Up/Down zooms in/out, L/R trigger rotates the map (L+R puts north up) and Right cycles through the different view modes.

### View modes

Pressing Right cycles through North up, Track up and 3D mode. In North up mode, north will always stay up. In Track up mode and 3D mode, the direction in which you're going is up. In 3D mode the map is viewed at an angle.
If you don't have GPS mode on, then North up is disabled.
When you've gone through all view modes, night mode is enabled, inversing the colors on the map. In darker conditions, the screen then won't produce that much light. After going through the view modes again, night mode is disabled.

### GPS/NMEA recording

For testing purposes you can record the GPS/NMEA data to a file. This function is (de)activated using Left. GPS/NMEA data is recorded to gps.txt. In config.txt you can specify the FAKEFEED directive to be either 0 or 1. When 1, GPS data is read from gps.txt instead of from the GPS receiver. Reading from gps.txt can also be selected in the Start menu.

### Toggle POI

When you have loaded a POI file (see Start menu) you can unload it and load it again using Triangle. When loading a POI file that contains a route, the marker will be turned on automatically. When unloading, the marker is not turned off automatically.

### Enable GPS mode

Pressing Square enables GPS mode. When the receiver has gotten a fix on at least 3 satellites, Map This! will show your current location on the map (if the map covers your current location). You can view GPS information in the GPS info screen (see Start menu).
You will also notice an info bar on the right. The indicator at the bottom left of this bar indicates your GPS signal. All 6 bars empty (in red) means 2 or fewer fixes (at least 3 are necessary). The more green bars, the more fixes: 1 bar = 3 fixes, 6 bars = 8 fixes.
You can disable GPS mode by moving the cursor using the analog nub.

### Marker

You can set a marker at your current position by pressing Cross. A white line will be drawn from your current location to the location of the marker. At the top of the screen you will see the distance to the marker.
You can add extra segments by pressing Circle. The total length of all segments is shown directly above the cursor. It is not possible to save this path to a file.
If you have loaded a route (POI file), then the marker is automatically set and segments are added between the waypoints. Again, you can add extra segments by pressing Circle, but these are not stored.
You can remove the path and turn off the marker by again pressing Cross.

### Controls

* Analog nub: move cursor / disable GPS mode;
* Up/Down: zoom in/out;
* Right: cycle through view modes / enable/disable night mode;
* Left: enable GPS/NMEA recording (works only in GPS mode);
* L/R trigger: rotate map;
* L+R trigger: put north up;
* Triangle: load/unload POI file;
* Square: enable GPS mode and show GPS info bar;
* Cross: set/remove marker;
* Circle: add extra segments (works only when marker is set);
* Start: open Start menu;
* Select: close map and return to Map selection screen.

## Start menu

In the Start menu you'll see 12 actions. Some of these open new screens, others toggle a setting. You can select an action by pressing Cross.
In many of these new screens you need to input text. You can do this using the Danzeff method.

### Danzeff

The Danzeff On Screen Keyboard (OSK) is a means of inputting text on the PSP. When the OSK is active, you will see the alphabet at the bottom right of the screen, divided over 3x3 blocks.
In order to input a character, you move the analog nub to the block you need and press Triangle, Square, Cross or Circle depending on which character from that block you need.
By holding the R trigger you can type upper case letters (these usually don't have a different effect in Map This!). If you have set up localization, holding the R trigger may bring up a different alphabet (e.g. Cyrillic).
Pressing the L trigger will bring up decimals. Holding the R trigger here will give you special characters. Pressing the L trigger again will bring you back to the alphabet.

### Add POI

The Add POI screen allows you to create your own Points of Interest (POI). The four fields correspond to desc1, desc2, lat and lon respectively as mentioned at Points of Interest (POI) and routes.
When you're done filling out the fields, you can press Start to save the POI. Select cancels adding a POI.
New POIs are stored in the file _MY_POIS in the map directory.

### POI Lookup

The POI Lookup screen allows you to open a POI file. Press Cross to show a POI file on the map. Here you can also open the POIs you have added using the Add POI screen by opening the file MY POIS.
Pressing Circle in the POI Lookup screen allows you to search for specific POIs in a certain POI file. Fill out the search field and press Start to search. You will see a list of all the matched entries. Selecting one (press Cross) will bring you to the location of that specific POI. Only those POIs that matched the search will be showed.

### Address Lookup

Address Lookup allows you to search for a specific street and house number in a particular city, state or zip code area. In order for this to work you will need geodata for the current map.
The data needs to be input using US standards. Street can e.g. be 1 Roosevelt Drive (you may leave out the house number) and State can e.g. be TX. It is advisable to speed up the search by providing the city, since the geodata file is indexed using city names and zip codes.
Press Start to start the search. First an exact match is tried, where street name and house number have to match. Second a relaxed match is tried (TODO: what's different from exact match?). Third and last a wide match is tried, where house number is ignored.
You will see a list of all the matched entries. Selecting one (press Cross) will bring you to the location of that specific street and house number.
Map This! cannot calculate a route from your current location to this location. For downloading route files, see Getting POI files.

### Address Reverse

Instead of looking up a particular street and house number, Map This! can also show you the closest street and house number, or possibly intersection (if two streets are equally close to your current location).
If the nearest street is more than 300 meters away no result will be returned.

### Read GPS from file/unit

For testing purposes you can read GPS/NMEA data from a file. GPS/NMEA data is read from gps.txt. If the FAKEFEED directive from config.txt is set to 1, then GPS/NMEA data is read from file at startup.

### Set CPU to 222/333 MHz

Change the current CPU speed to be either 222 or 333 MHz. Setting the CPU to 222 MHz will make your battery last longer, but it will make Map This! run slower. Setting the CPU to 333 MHz will drain your battery faster, but it will make Map This! run faster.

### Hide/Show Panels

Choosing Hide Panels will remove all the panels in the map screen. Show Panels will make them appear again.

### Take Screenshot

Map This! will make a screenshot of the map screen (including info bars) and save it to ms0:/PSP/PHOTO/.

### GPS Info

The GPS Info screen gives you information from the GPS receiver. The fields present are:
* GPS state (on, off, activating): shows if the GPS receiver is functioning or not;
* Time: the current time in GMT according to the GPS receiver;
* Sat-In-View: the numbers of satellite the GPS receiver sees;
* Fixed: the numbers of satellites the GPS receiver has a fix on;
* HDOP: see http://en.wikipedia.org/wiki/HDOP;
* Lat: your current latitude;
* Lon: your current longitude;
* Alt: your current altitude;
* Speed: your current speed in knots;
* Bearing: your current direction;
* Loc: see INITLOCATION at Configuring Map This! (PSP-290 only);
* Quality: TODO (generic receivers only);
* CPU: current CPU speed.
You can change Loc by pressing Left and Right. You can change CPU speed by pressing Up and Down.
Per satellite you will also see the following information:
* Sat ID: ID of the GPS satellite;
* Elevation: elevation of satellite relative to the horizon (together with the azimuth gives you the point in the sky where the satellite is);
* Azimuth: see http://en.wikipedia.org/wiki/Azimuth;
* SNR: Signal-to-Noise Ratio;
* Fix: indicates whether the GPS receiver has a fix on the satellite (PSP-290 only).

### Reset Trip data

This action resets the distance covered, the average speed and the trip timer.

### Help

The help screen shows the controls and credits.

### Config

This screen shows the Map This! configuration from config.txt. White lines can be edited, but changes are only reflected when you restart Map This!.