Skip to content

Commit e7fd575

Browse files
committed
Squashed 'doc/manual/pages/' changes from 6bbcf14..a542b28
a542b28 Update Android manual page git-subtree-dir: doc/manual/pages git-subtree-split: a542b28
1 parent 1042d76 commit e7fd575

File tree

2 files changed

+42
-26
lines changed

2 files changed

+42
-26
lines changed

android-app.md

+42-26
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ authors:
44
- Kai Pastor
55
- Thomas Schoeps
66
keywords: Android
7-
edited: 24 January 2018
7+
edited: 3 February 2018
88
redirect_from:
99
- /android/
1010
- '/Android Manual/'
@@ -35,12 +35,12 @@ On startup, the app shows a list of map files available from the [supported stor
3535

3636
The map editor is slightly different from the desktop version. This page focuses on specific features of the mobile version. To find out about the other symbols, see [Toolbars](toolbars.md) in the desktop application's manual.
3737

38-
#### ![ ](../mapper-images/arrow-thin-upleft.png) Hide the top bar (1)
38+
#### ![ ](../mapper-images/arrow-thin-upleft.png) Hide the top bar
3939

4040
Using this button, you may hide the top bar, leaving more screen for the map. A similar button will remain visible for restoring the top bar again.
4141

4242

43-
#### ![ ](../mapper-images/compass.png) Compass display toggle (2)
43+
#### ![ ](../mapper-images/compass.png) Compass display toggle
4444

4545
When this item is activated, a compass is shown in the top-left corner of the screen. The red line indicates the north direction, while the black-white lines show the up direction of your device. If both are aligned, the device is aligned with magnetic north. When the needle is close to the north direction, a green circle appears which quickly shows how well the device is aligned: the larger it is, the better the alignment is. The compass works three-dimensionally, so you do not need to hold the device in a flat pose for it to work.
4646

@@ -49,26 +49,33 @@ Note: the usefulness of the compass depends on the presence of a gyroscope, as m
4949
Attention: the compass is very sensitive to magnetic materials. Android tries the eliminate the influence of local magnetic fields, but this requires calibration. To do this, move the device around in the shape of an 8 while rotating it and while the compass is active. If the local influence changes, re-calibration is required.
5050

5151

52-
#### ![ ](../mapper-images/tool-gps-display.png) Location display toggle (3)
52+
#### ![ ](../mapper-images/tool-gps-display.png) Location display toggle
5353

5454
If the currently active map work has valid georeferencing, this control will be enabled and will show a dot at your current position as obtained from GPS or other positioning services. In addition, in case an accuracy estimate (HDOP) is available, this shows a circle around the dot which indicates the positioning accuracy. The chance of your real position being in the circle is approximately 70%.
5555

56-
While this is active, your track is automatically recorded into a GPX file in the directory of your map, named "<map> - GPS-<YYYY-MM-DD>.gpx". This file is included as a template in the map. You can simply show it using button (7) to view your track.
56+
While this is active, your track is automatically recorded into a GPX file in the directory of your map, named "<map> - GPS-<YYYY-MM-DD>.gpx". This file is included as a template in the map. You can simply show it using the template visibility control button to view your track.
5757

5858
Note that track recording might be interrupted while the screen is off or the app is in the background to save battery. Keep the app active if you want to ensure continuous track recording.
5959

6060

61-
#### ![ ](../mapper-images/gps-distance-rings.png) Distance rings toggle (4)
61+
#### ![ ](../mapper-images/gps-distance-rings.png) Distance rings toggle
6262

6363
This button is active if location display is active. When activated, this will display rings in 10 meter and 20 meter distance from the current location which can be used to do rough distance estimates.
6464

6565

66-
#### ![ ](../mapper-images/rotate-map.png) Automatic north alignment toggle (5)
66+
#### ![ ](../mapper-images/rotate-map.png) Automatic north alignment toggle
6767

6868
When this toggle is active, the map is automatically rotated to north using the device's internal compass. The update frequency is 1 update per second. This is quite low on purpose to save battery, but you probably still need some replacement batteries when using this mode. While interacting with the map and for another 1.5 seconds after that, the map is not rotated to allow editing without unwanted rotations. If GPS position display is activated at the same time, a line starting from the GPS position and going in the direction of the up direction of your device is displayed which shows your viewing direction (assuming you are holding the device upright).
6969

7070

71-
#### ![ ](../mapper-images/tool-touch-cursor.png) Touch cursor toggle (6)
71+
-----
72+
73+
#### ![ ](../mapper-images/map-parts.png) Map parts selector
74+
75+
This button opens a popup for changing the active map part.
76+
77+
78+
#### ![ ](../mapper-images/tool-touch-cursor.png) Touch cursor toggle
7279

7380
This symbol activates a helper cursor which allows slow, but precise editing with fingers only. The cursor consists of a circular area and a pointer above the circle.
7481

@@ -77,59 +84,68 @@ This symbol activates a helper cursor which allows slow, but precise editing wit
7784
Touching the map anywhere outside the circle moves the pointer to this position. Touching the circle simulates a real touch at the pointer position above the circle.
7885

7986

80-
#### ![ ](../mapper-images/templates.png) Template visibility toggle (7)
87+
#### ![ ](../mapper-images/templates.png) Template control
8188

8289
This shows a list of all opened templates. Touching a template toggles its visibility.
8390

8491

85-
#### ![ ](../mapper-images/close.png) Close button (8)
92+
#### ![ ](../mapper-images/close.png) Close button
8693

8794
This closes the active map and returns to the map selection screen.
8895

8996

90-
#### ![ ](../mapper-images/three-dots.png) Overflow button (9)
97+
#### ![ ](../mapper-images/three-dots.png) Overflow button
9198

9299
Depending on the screen size of your device, some of the symbols available not fit onto the screen. They are instead placed in a list which is shown on touching the overflow button. If all symbols fit on the screen, this button is unused.
93100

94101

95-
#### ![ ](../mapper-images/gps-temporary-path.png) Record temporary trace (10)
102+
-----
96103

97-
This symbol is enabled when the location display is active. It records a temporary trace of the location, which is intended to act as a guideline for drawings. Using the trace directly is rarely useful because of the inaccurateness of location services.
98-
Note that the temporary trace is not saved in the map.
104+
#### ![ ](../mapper-images/view-zoom-out.png) Zoom out / Zoom to fixed
105+
106+
A short press will zoom out by one step. A long press will open a menu where you can jump to a fixed zoom (cf. screenshot).
99107

100108

101-
#### ![ ](../mapper-images/gps-temporary-clear.png) Clear temporary markers (11)
109+
#### ![ ](../mapper-images/move-to-gps.png) Move to location
102110

103-
This removes the traces and markers created with (10) and (12). (They will also be discarded when closing the map file.)
111+
When positioning services are enabled, this will move the map so that your current location is in the middle of the screen.
104112

105113

106-
#### ![ ](../mapper-images/gps-temporary-point.png) Mark temporary position (12)
114+
#### ![ ](../mapper-images/gps-temporary-point.png) Mark temporary position
107115

108116
This records a single point at your current location to act as a drawing help. Note that this marker is not saved in the map.
109117

110118

111-
#### ![ ](../mapper-images/paint-on-template-settings.png) Paint-on-template settings (13)
119+
#### ![ ](../mapper-images/gps-temporary-path.png) Record temporary trace
120+
121+
This symbol is enabled when the location display is active. It records a temporary trace of the location, which is intended to act as a guideline for drawings. Using the trace directly is rarely useful because of the inaccurateness of location services.
122+
Note that the temporary trace is not saved in the map.
123+
124+
125+
#### ![ ](../mapper-images/gps-temporary-clear.png) Clear temporary markers
126+
127+
This removes the temporay traces and position markers. (They will also be discarded when closing the map file.)
128+
129+
130+
#### ![ ](../mapper-images/paint-on-template-settings.png) Paint-on-template settings
112131

113132
This button allows to select the active image for scribbling (using the symbol above it).
114133

115134

116-
#### ![ ](../mapper-images/draw-freehand.png) Free-hand draw tool (14)
135+
-----
136+
137+
#### ![ ](../mapper-images/draw-freehand.png) Free-hand draw tool
117138

118139
Allows to draw paths free-handedly.
119140

120141

121-
#### ![ ](../mapper-images/draw-point-gps.png) Draw at location tool (15)
142+
#### ![ ](../mapper-images/draw-point-gps.png) Draw at location tool
122143

123144
Sets a point object at your current location. Selecting this button first enters an averaging mode. While it is active, the input from the location service is averaged to get a more accurate estimate. Touch the map display anywhere to finish the averaging.
124145

125146

126-
#### Symbol selector (16)
147+
#### Symbol selector
127148

128149
Displays the active symbol, and opens the symbol selection screen on short press.
129150

130151
A long press of the symbol selector opens a popup menu which allows to read the symbol name and description, and to toggle the visibility and the protection state of the symbol.
131-
132-
133-
#### ![ ](../mapper-images/map-parts.png) Map parts selector (17)
134-
135-
This button opens a popup for changing the active map part.

images/Android_UI_explanation.png

44.7 KB
Loading

0 commit comments

Comments
 (0)