Commit 3414745174c70a79e7c7474b75ea233506928f92 - mkgmap

Merge tag 'upstream/0.0.0+svn3660' Upstream version 0.0.0+svn3660 Bas Couwenberg 8 years ago

9 changed file(s) with 219 addition(s) and 198 deletion(s). Raw diff Collapse all Expand all

+186

-184

doc/options.txt less more

12	12	: Output program version to stderr.
13	13
14	14	=== File options ===
	15
15	16	;--input-file=filename
16	17	: Read input data from the give file. This option (or just a
17	18	filename) may be given more than once.

30	31	line can be used, however you omit the leading '--'. The short
31	32	option names with a single '-' cannot be used, simply use the
32	33	long name instead.
33
	34	<p>
34	35	;--output-dir=filename
35	36	: The directory in which all output files are written. It defaults
36	37	to the current working directory, i.e. the directory the command is
37	38	executed from.
38
	39	<p>
39	40	;-n name
40	41	;--mapname=name
41	42	: Set the name of the map. Garmin maps are named by 8 digit
42	43	numbersList. The default is 63240001. It is best to use a different
43	44	name if you are going to be making a map for others to use so
44	45	that it is unique and does not clash with others.
45
	46	<p>
46	47	;--description=text
47	48	: Sets the descriptive text for the map. This may be displayed in
48	49	QLandkarte, MapSource or on a GPS, where it is normally shown

51	52	and use -c template.args, then that file may contain a
52	53	"description" that will override this option. Use "--description" in
53	54	splitter.jar to change the description in the template.args file.
54
	55	<p>
55	56	;--country-name=name
56	57	: Sets the map's country name. The default is "COUNTRY".
57
	58	<p>
58	59	;--country-abbr=abbreviation
59	60	: Sets the map's abbreviated country name. The default is "ABC".
60
	61	<p>
61	62	;--region-name=name
62	63	: Sets the map's region name. By default, the map has no region name.
63
	64	<p>
64	65	;--region-abbr=abbreviation
65	66	: Sets the map's abbreviated region name. By default, the map has
66	67	no abbreviated region name.
67
	68	<p>
68	69	=== Label options ===
69	70
70	71	;--latin1
71	72	: This is equivalent to --code-page=1252.
72
	73	<p>
73	74	;--unicode
74		: This is equivalent to --code-page=65001. Note that only newer devices support Unicode.
75
	75	: This is equivalent to --code-page=65001. Note that only newer devices support Unicode.
	76	<p>
76	77	;--code-page=number
77	78	: This option enables the use of international characters. Only 8 bit
78	79	character sets are supported and so you have to specify which code page
79	80	you want to use.
80
81		: It is entirely dependent on the device firmware which code pages are
	81	<p>
	82	It is entirely dependent on the device firmware which code pages are
82	83	supported.
83
	84	<p>
84	85	;--charset=name
85	86	: This option is obsolete. Change the character set with the --code-page
86	87	option.
87
	88	<p>
88	89	;--lower-case
89	90	: Allow labels to contain lower case letters. Note that most or all
90	91	Garmin devices are not able to display lower case letters at an angle
91	92	so this option is not generally useful.
92
	93	<p>
93	94	=== Address search options ===
94	95	;--index
95	96	: Generate a global address search index. If the --gmapsupp option is
96	97	also given, then the index is generated within the resulting
97	98	gmapsupp.img file so that address search will work on a GPS
98	99	device.
99
100		: If instead the --tdbfile option is given then the index consists
	100	<p>
	101	If instead the --tdbfile option is given then the index consists
101	102	of two files named osmmap.mdx and osmmap_mdr.img which can be used
102	103	with mapsource. (For compatibility, you do not need the tdbfile
103	104	option if gmapsupp is not given).
104
105		: If both the --gmapsupp and --tdbfile options are given alongside
	105	<p>
	106	If both the --gmapsupp and --tdbfile options are given alongside
106	107	the --index option, then both indexes will be created. Note that
107	108	this will require roughly twice as much memory.
108
109		: The --overview-mapname option can be used to change these names. If
	109	<p>
	110	The --overview-mapname option can be used to change these names. If
110	111	the mapset is sent to the device from MapSource, it will enable
111	112	find by name and address search on the GPS.
112	113
113	114	: The address fields are assigned by special mkgmap address
114	115	tags using the style file:
	116
115	117	mkgmap:country
116	118	mkgmap:region
117	119	mkgmap:city

125	127	same code page and sorting options (e.g. --code-page, --latin1) must
126	128	be used as were used to compile the individual map tiles.
127	129
	130	;--x-split-name-index
	131	: A temporary option to enable indexing each part of a street name separately.
	132	So for example if the street is "Aleksandra Gryglewskiego" then you will be able to
	133	search for it as both "Aleksandra" and "Gryglewskiego". It will also increase the
	134	size of the index. Useful in countries where searching for the first word in name
	135	is not the right thing to do.
	136	<p>
	137	Note that this option is still experimental and there may be problems. If you find
	138	any let us know!
	139	<p>
128	140	;--bounds=directory\|zipfile
129	141	: A directory or a zip file containing the preprocessed bounds files.
130	142	Bounds files in a zip file must be located in the zip file's root directory.
131
132		: The preprocessed boundaries are used to add special tags to all elements
	143	<p>
	144	The preprocessed boundaries are used to add special tags to all elements
133	145	(points, lines and polygons) containing the elements location information.
134	146	The style file can be used to assign the address tags mkgmap:country,
135	147	mkgmap:region etc. using these values.
136
137		: The following special tags are added:
	148	<p>
	149	The following special tags are added:
	150	<pre>
138	151	mkgmap:admin_level2 : Name of the admin_level=2 boundary
139	152	mkgmap:admin_level3 : Name of the admin_level=3 boundary
140	153	..
141	154	mkgmap:admin_level11
142	155	mkgmap:postcode : the postal_code value
143
144		: Preprocessed bounds can be created with the following command:
145		java -cp mkgmap.jar
146		uk.me.parabola.mkgmap.reader.osm.boundary.BoundaryPreprocessor
147		<inputfile> <boundsdir>
148
149		: The input file must contain the boundaries that should be preprocessed.
150		It can have OSM, PBF or O5M fileformat. It is recommended that it
	156	</pre>
	157	Preprocessed bounds can be created with the following command:
	158	<pre>
	159	java -cp mkgmap.jar
	160	uk.me.parabola.mkgmap.reader.osm.boundary.BoundaryPreprocessor
	161	<inputfile> <boundsdir>
	162	</pre>
	163	The input file must contain the boundaries that should be preprocessed.
	164	It can have OSM, PBF or O5M file format. It is recommended that it
151	165	contains the boundary data only to avoid very high memory usage.
152	166	The boundsdir gives the directory where the processed files are stored.
153	167	This directory can be used as --bounds parameter with mkgmap.
154
	168	<p>
155	169	;--location-autofill=[option1,[option2]]
156	170	: Controls how the address fields for country, region, city and zip info
157	171	are gathered automatically if the fields are not set by using the special
158	172	mkgmap address tags (e.g. mkgmap:city - see option index).
159	173	Warning: automatic assignment of address fields is somehow a best guess.
160	174	:;is_in
161		::The is_in tag is analyzed for country and region information.
162
	175	:: The is_in tag is analyzed for country and region information.
	176	<p>
163	177	:;nearest
164		::The city/hamlet points that are closest to the element are used
	178	:: The city/hamlet points that are closest to the element are used
165	179	to assign the missing address fields. Beware that cities located
166	180	in the same tile are used only. So the results close to a tile
167	181	border have less quality.
168	182
169
170	183	;--housenumbers
171		: Enables house number search for OSM input files.
172
173		: All nodes and polygons having addr:housenumber set are matched
	184	: Enables house number search for OSM input files.
	185	All nodes and polygons having addr:housenumber set are matched
174	186	to streets. A match between a house number element and a street is created if
175	187	the street is located within a radius of 150m and the addr:street tag value of
176		the house number element equals the mgkmap:street tag value of the street
177		or the addr:street tag is missing and the number is plausible for the street.
	188	the house number element equals the mgkmap:street tag value of the street.
178	189	The mkgmap:street tag must be added to the street in the style file.
179	190	For optimal results, the tags mkgmap:city and mkgmap:postal_code should be
180	191	set for the housenumber element. If a street connects two or more cities

184	195	:: Node - addr:street=Main Street addr:housenumber=2
185	196	:: Way 1 - name=Main Street
186	197	:: Way 2 - name=Main Street, mkgmap:street=Main Street
187		:: Way 3 - mkgmap:street=Mainstreet
	198	:: Way 3 - mkgmap:street=Mainstreet
188	199	:: Way 4 - name=Main Street [A504]
189		: The node 1 matches to Way 2. It has mkgmap:street set with a value equal to
190		the addr:street tag value of the house number node.
191		: If the street is not given with addr:housenumber, mkgmap uses heuristics
192		to find the best match.
	200	: The node matches to Way 2. It has mkgmap:street set with a value equal to
	201	the addr:street tag value of the house number node.
	202	<p>
	203	If the street is not given with addr:housenumber, mkgmap uses heuristics
	204	to find the best match.
193	205
194	206	=== Overview map options ===
195	207	;--overview-mapname=name
196	208	: If --tdbfile is enabled, this gives the name of the overview
197	209	.img and .tdb files. The default map name is osmmap.
198
	210	<p>
199	211	;--overview-mapnumber=8 digit number
200	212	: If --tdbfile is enabled, this gives the internal 8 digit
201	213	number used in the overview map and tdb file. The default
202	214	number is 63240000.
203
	215	<p>
204	216	;--overview-levels
205	217	: like levels, specifies additional levels that are to be written to the
206	218	overview map. Counting of the levels should continue. Up to 8 additional
207	219	levels may be specified, but the lowest usable resolution with MapSource
208	220	seems to be 11. The hard coded default is empty.
209
	221	<p>
210	222	;--remove-ovm-work-files
211	223	: If overview-levels is used, mkgmap creates one additional file
212	224	with the prefix ovm_ for each map (*.img) file.
213	225	These files are used to create the overview map.
214	226	With option --remove-ovm-work-files=true the files are removed
215	227	after the overview map was created. The default is to keep the files.
216
	228	<p>
217	229	=== Style options ===
218	230	;--style-file=file
219	231	: Specify an external file to obtain the style from. "file" can

221	233	(see resources/styles/default for an example). The directory
222	234	path must be absolute or relative to the current working
223	235	directory when mkgmap is invoked.
224
225		: The file can be a zip file containing the files instead of a
	236	<p>
	237	The file can be a zip file containing the files instead of a
226	238	directory.
227
228		: The files can be at the top level or contained in a folder within
	239	<p>
	240	The files can be at the top level or contained in a folder within
229	241	the zip file. If the zip file contains more than one top level
230	242	folder then each folder is the name of a style that can be selected
231	243	with the --style option.
232
233		: The argument can also be a URL that specifies the location of a
	244	<p>
	245	The argument can also be a URL that specifies the location of a
234	246	style file.
235
	247	<p>
236	248	;--style=name
237	249	: Specify a style name. Must be used if --style-file points to a
238	250	directory or zip file containing multiple styles. If --style-file
239	251	is not used, it selects one of the built-in styles.
240
	252	<p>
241	253	;--list-styles
242	254	: List the available styles. If this option is preceded by a style-file
243	255	option then it lists the styles available within that file.
244
	256	<p>
245	257	;--check-styles
246	258	: Perform some checks on the available styles. If this option is
247	259	preceded by a style-file option then it checks the styles
248	260	available within that file. If it is also preceded by the style
249	261	option it will only check that style.
250
	262	<p>
251	263	;--levels=levels code
252	264	: Change the way that the levels on the map correspond to the zoom
253	265	levels in the device. See customisation help. The default is:
254	266	"0:24, 1:22, 2:20, 3:18, 4:16", although each style can have
255	267	its own default. Up to 8 levels may be specified.
256
	268	<p>
257	269	;--name-tag-list
258	270	: Get the tag that will be used to supply the name. Useful for
259	271	language variations. You can supply a list and the first one
260	272	will be used. e.g. --name-tag-list=name:en,int_name,name
261
	273	<p>
262	274	;--map-features=file
263	275	: This option is ignored; use the --style-file option instead.
264
265		=== Product description options ===
	276	<p>
	277	===Product description options===
266	278
267	279	;--family-id
268	280	: This is an integer that identifies a family of products.
269	281	Range: [1..9999]
270	282	Mkgmap default: 6324
271
	283	<p>
272	284	;--family-name
273	285	: If you build several maps, this option describes the
274	286	family name of all of your maps. Garmin will display this
275	287	in the map selection screen.
276
277		: Example: --family-name="OpenStreetmap mkgmap XL 2019"
278
	288	<p>
	289	Example: --family-name="OpenStreetmap mkgmap XL 2019"
	290	<p>
279	291	;--product-id
280	292	: This is an integer that identifies a product within a family.
281	293	It is often just 1, which is the default.
282
	294	<p>
283	295	;--product-version
284	296	: The version of the product. Default value is 1.
285
	297	<p>
286	298	;--series-name
287	299	: This name will be displayed in MapSource in the map selection
288	300	drop-down. The default is "OSM map".
289
	301	<p>
290	302	;--area-name
291	303	: Area name is displayed on Garmin units (or at least on eTrex) as the second
292	304	part of the mapname in the list of the individual maps.
293
	305	<p>
294	306	;--copyright-message=note
295	307	: Specify a copyright message for files that do not contain one.
296
	308	<p>
297	309	;--copyright-file=file
298	310	: Specify copyright messages from a file.
299	311	Note that the first copyright message is not displayed on a device, but is
300	312	shown in BaseCamp. The copyright file must include at least two lines.
301
	313	<p>
302	314	;--license-file=file
303	315	: Specify a file which content will be added as license.
304	316	All entries of all maps will be merged in the overview map.
305
	317	<p>
306	318	=== Optimization options ===
307	319
308	320	;--reduce-point-density=NUM

312	324	This distance gets shifted with lower zoom levels.
313	325	Recommended setting is 4, this should lead to only small differences
314	326	(Default is 2.6, which should lead to invisible changes)
315
	327	<p>
316	328	;--reduce-point-density-polygon=NUM
317	329	: Allows to set the maximal allowed error distance for the DP algorithm
318	330	to be applied against polygons. Recommended setting is 8.
319
	331	<p>
320	332	;--merge-lines
321	333	: Try to merge lines. This helps the simplify filter to straighten out
322	334	longer chunks at lower zoom levels. Decreases file size more.
323	335	Increases paint speed at low zoom levels.
324	336	Default is enabled, use --no-merge-lines to disable.
325
	337	<p>
326	338	;--min-size-polygon=NUM
327	339	: Removes all polygons smaller than NUM from the map.
328	340	This reduces map size and speeds up redrawing of maps.
329	341	Recommended value is 8 to 15, default is 8.
330	342	See also polygon-size-limits.
331
	343	<p>
332	344	;--polygon-size-limits=limits code
333	345	: Allows to specify different min-size-polygon values for each resolution.
334	346	Sample:

338	350	resolution 17 and 18 will use 10, and so on.
339	351	Value 0 means to skip the size filter.
340	352	Note that in resolution 24 the filter is not used.
341
	353	<p>
342	354	=== Miscellaneous options ===
343	355
344	356	;--max-jobs[=number]

347	359	is set equal to the number of CPU cores. If this option is not
348	360	given at all, the limit is 1 (i.e., the maps are processed
349	361	sequentially).
350
	362	<p>
351	363	;--keep-going
352	364	: Don't quit whole application if an exception occurs while
353	365	processing a map - continue to process the other maps.
354
	366	<p>
355	367	;--block-size=number
356	368	: Changes the block size that is used in the generated map. This
357	369	option is not usually needed, but sometimes an error message
358	370	will ask you to try a value for this option.
359
	371	<p>
360	372	;--net
361	373	: Obsolete, use --route instead.
362
	374	<p>
363	375	;--route
364	376	: Create maps that support routing.
365
	377	<p>
366	378	;--drive-on=left\|right\|detect\|detect,left\|detect,right
367	379	: Explicitly specify which side of the road vehicles are
368	380	expected to drive on.

374	386	of drive-on-left roads with the rest.
375	387	Use the --bounds option to make sure that the detection
376	388	finds the correct country.
377
	389	<p>
378	390	;--drive-on-left
379	391	;--drive-on-right
380	392	: Deprecated: Use drive-on instead.
381	393	The options are translated to drive-on=left\|right.
382
	394	<p>
383	395	;--check-roundabouts
384	396	: Check that roundabouts have the expected direction (clockwise
385	397	when vehicles drive on the left). Roundabouts that are complete
386	398	loops and have the wrong direction are reversed. Also checks
387	399	that the roundabouts do not fork or overlap other roundabouts.
388
	400	<p>
389	401	;--check-roundabout-flares
390	402	: Sanity check roundabout flare roads - warn if they don't point
391	403	in the correct direction or if they are not one-way or if they
392	404	extend too far.
393
	405	<p>
394	406	;--max-flare-length-ratio=NUM
395	407	: When checking flare roads, ignore roads whose length is
396	408	greater than NUM (an integer) times the distance between the

399	411	number of legitimate roads that are flagged as flare road
400	412	problems. Default value is 0 (disabled) because it's not a
401	413	completely reliable heuristic.
402
	414	<p>
403	415	;--ignore-maxspeeds
404		: Now ignored, former usage:
	416	: Now ignored, former usage:
405	417	When reading OSM files, ignore any "maxspeed" tags.
406
	418	<p>
407	419	;--ignore-builtin-relations
408		: Now ignored, former usage:
	420	: Now ignored, former usage:
409	421	When reading OSM files, skip the built-in processing of
410	422	relations. This speeds up the processing non-routable map
411	423	layers that do not contain multipolygons. This implies
412	424	--ignore-turn-restrictions.
413
	425	<p>
414	426	;--ignore-turn-restrictions
415	427	: When reading OSM files, ignore any "restriction" relations.
416
	428	<p>
417	429	;--ignore-osm-bounds
418	430	: When reading OSM files, ignore any "bounds" elements.
419	431	With this option selected generate-sea sometimes works better,
420	432	but routing across tiles will not work.
421
	433	<p>
422	434	;--preserve-element-order
423		: Process the map elements (nodes, ways, relations) in the order
	435	: Process the map elements (nodes, ways, relations) in the order
424	436	in which they appear in the OSM input. Without this option,
425	437	the order in which the elements are processed is not defined.
426
	438	<p>
427	439	;--remove-short-arcs[=MinLength]
428		: now ignored, former explanation:
	440	: Now ignored, former usage:
429	441	Merge nodes to remove short arcs that can cause routing
430	442	problems. If MinLength is specified (in metres), arcs shorter
431	443	than that length will be removed. If a length is not
432	444	specified, only zero-length arcs will be removed.
433
434
	445	<p>
435	446	;--adjust-turn-headings[=BITMASK]
436		: now ignored, former explanation:
	447	: Now ignored, former usage:
437	448	Where possible, ensure that turns off to side roads change
438	449	heading sufficiently so that the GPS believes that a turn is
439	450	required rather than a fork. This also avoids spurious
440	451	instructions to "keep right/left" when the road doesn't
441	452	actually fork.
442
443		: Optional BITMASK (default value 3) allows you to specify which
	453	<p>
	454	Optional BITMASK (default value 3) allows you to specify which
444	455	adjustments are to be made (where necessary):
	456	<p>
445	457	:* 1 = increase angle between side road and outgoing main road
446	458	:* 2 = increase angle between side road and incoming main road
447
	459	<p>
448	460	;--cycle-map
449		: Tells mkgmap that the map is for cyclists. This assumes that
	461	: Tells mkgmap that the map is for cyclists. This assumes that
450	462	different vehicles are different kinds of bicycles, e.g. a way
451	463	with mkgmap:car=yes and mkgmap:bicycle=no may be a road that is
452	464	good for racing bikes, but not for other cyclists.
453	465	This allows to optimise sharp angles at junctions of those roads.
454	466	Don't use with the default style as that is a general style!
455
	467	<p>
456	468	;--report-similar-arcs
457	469	: Issue a warning when more than one arc connects two nodes and
458	470	the ways that the arcs are derived from contain identical
459	471	points. It doesn't make sense to use this option at the same
460	472	time as using the cycleway creating options.
461
	473	<p>
462	474	;--report-dead-ends=LEVEL
463	475	: Set the dead end road warning level. The value of LEVEL (which
464	476	defaults to 1 if this option is not specified) determines
465		those roads to report:
466		:* 0 = none
467		:* 1 = multiple one-way roads that join together but go nowhere
468		:* 2 = individual one-way roads that go nowhere.
469
470
	477	those roads to report: 0 = none, 1 = multiple one-way roads
	478	that join together but go nowhere, 2 = individual one-way roads
	479	that go nowhere.
	480	<p>
471	481	;--road-name-pois[=GarminCode]
472		: Now ignored, former meaning:
473		Generate a POI for each named road. By default, the POIs'
	482	: Now ignored, former usage:
	483	Generate a POI for each named road. By default, the POIs'
474	484	Garmin type code is 0x640a. If desired, a different type code
475		can be specified with this option. This s a workaround for not
	485	can be specified with this option. This is a workaround for not
476	486	being able to search for roads.
477
478		: 0x2f15: a blue dot in the middle of the road, and if you select,
479		or 'hover' over it, the streetname appears.
480
	487	0x2f15: a blue dot in the middle of the road, and if you select,
	488	or 'hover' over it, the street name appears.
481	489	;--add-pois-to-lines
482	490	: Generate POIs for lines. For each line (must not be closed) POIs are
483	491	created at several points of the line. Each POI is tagged with the

488	496	:* end - The last point of the line
489	497	:* inner - Each point of the line except the first and the last
490	498	:* mid - The middle point
491		:
492
493	499	;--add-pois-to-areas
494	500	: Generate a POI for each polygon and multipolygon. The POIs are created
495	501	after the relation style but before the other styles are applied. Each

497	503	the area/multipolygon. Additionally the tag mkgmap:area2poi=true is
498	504	set so that it is possible to use that information in the points style
499	505	file. Artifical polygons created by multipolyon processing are not used.
500		The POIs are created at the following positions
501		:; polygons:
502		:: First rule that applies:
	506	The POIs are created at the following positions (first rule that applies):
	507	:;polygons:
	508	::First rule that applies of
503	509	::* the first node tagged with a tag defined by the pois-to-areas-placement option
504	510	::* the centre point
505		::
506
507		:;multipolygons:
508		:: First rule that applies:
	511	:; multipolygons:
	512	::First rule that applies of
509	513	::* the node with role=label
510	514	::* the centre point of the biggest area
511		:
512
513	515	;--pois-to-areas-placement[=taglist]
514	516	: A semicolon separated list of tag=value definitions. A POI is placed at the first
515	517	node of the polygon tagged with the first tag/value pair. If none of the nodes are

517	519	pair is used and so on. If none of the tag-value pairs matches or the taglist is empty
518	520	the centre of the polygon is used.
519	521	It is possible to define wildcards for tag values like entrance=*.
520
521		: Default: entrance=main;entrance=yes;building=entrance
522
	522	<p>Default: entrance=main;entrance=yes;building=entrance
	523	<p>
523	524	;--precomp-sea=directory\|zipfile
524	525	: Defines the directory or a zip file that contains precompiled sea tiles.
525		Sea files in a zip file must be located in the zip files root directory or in
	526	Sea files in a zip file must be located in the zip file's root directory or in
526	527	a sub directory sea. When this option is defined all natural=coastline tags
527	528	from the input OSM tiles are removed and the precompiled data is used instead.
528	529	This option can be combined with the generate-sea options multipolygon, polygons
529	530	and land-tag. The coastlinefile option is ignored if precomp-sea is set.
530
	531	<p>
531	532	;--coastlinefile=filename[,filename]
532	533	: Defines a comma separated list of files that contain coastline
533	534	data. The coastline data from the input files is removed if
534	535	this option is set. Files must have OSM or PBF fileformat.
535
	536	<p>
536	537	;--generate-sea[=ValueList]
537	538	: Generate sea polygons. ValueList is an optional comma
538	539	separated list of values:
	540	<p>
539	541	:;multipolygon
540		:: generate the sea using a multipolygon (the default
541		behaviour so this really doesn't need to be specified).
	542	:: generate the sea using a multipolygon (the default behaviour so this really doesn't need to be specified).
	543
542	544	:;polygons \| no-mp
543	545	:: don't generate the sea using a multipolygon - instead,
544	546	generate a background sea polygon plus individual land

551	553	:;no-sea-sectors
552	554	:: disable the generation of "sea sectors" when the
553	555	coastline fails to reach the tile's boundary.
554
555	556	:;extend-sea-sectors
556		:: same as no-sea-sectors. Additional adds a point so
557		coastline reaches the nearest tile boundary.
	557	:: same as no-sea-sectors. Additional adds a point so coastline reaches the nearest tile boundary.
558	558
559	559	:;land-tag=TAG=VAL
560		:: tag to use for land polygons (default natural=land).
561
	560	:: tag to use for land polygons (default natural=land).
562	561	:;close-gaps=NUM
563	562	:: close gaps in coastline that are less than this distance (metres)
564	563

568	567	(works only with multipolygon processing)
569	568
570	569	:;fbgap=NUM
571		:: flood blocker gap in metre (default 40) points that are closer to the sea polygon do not block
572
	570	:: flood blocker gap in metre (default 40)
	571	points that are closer to the sea polygon do not block
573	572	:;fbthres=NUM
574	573	:: at least so many highway points must be contained in
575	574	a sea polygon so that it may be removed by the flood

584	583	:: switches on the debugging of the flood blocker
585	584	generates GPX files for each polygon checked by
586	585	the flood blocker
587		:
588	586
589	587	;--make-poi-index
590	588	: Generate the POI index (not yet useful).
591
	589	<p>
592	590	;--nsis
593	591	: Write a .nsi file that can be used with the Nullsoft Scriptable Install System
594	592	(NSIS) to create a Windows Mapsource Installer.
595
	593	<p>
596	594	;--make-all-cycleways
597		: Deprecated, use --make-opposite-cycleways instead. Former meaning:
598		Turn on all of the options that make cycleways.
599
	595	: Deprecated, use --make-opposite-cycleways instead. Former meaning:
	596	<div class=preserve><nowiki>
	597	Turn on all of the options that make cycleways.
	598
	599	</nowiki></div>
600	600	;--make-opposite-cycleways
601	601	: Some one-way streets allow bicycle traffic in the reverse
602	602	direction and this option makes a way with the same points as
603	603	the original that allows bicycle traffic (in both directions).
604
	604	<p>
605	605	;--make-cycleways
606		: Now ignored, former meaning:
607		Some streets have a separate cycleway track/lane just for
	606	: Now ignored, former meaning:
	607	<div class=preserve><nowiki>
	608	Some streets have a separate cycleway track/lane just for
608	609	bicycle traffic and this option makes a way with the same
609	610	points as the original that allows bicycle traffic. Also,
610	611	bicycle traffic is prohibited from using the original way
611	612	(unless that way's bicycle access has been defined).
612	613
	614	</nowiki></div>
613	615	;--link-pois-to-ways
614		:This option may copy some specific attributes of a POI
	616	: This option may copy some specific attributes of a POI
615	617	to a small part of the way the POI is located on. This can be used
616	618	to let barriers block a way or to lower the calculated speed
617	619	around traffic signals.
618		POIs with the tags highway=* (e.g. highway=traffic_signals)
	620	POIs with the tags highway=* (e.g. highway=traffic_signals)
619	621	or barrier=* (e.g. barrier=cycle_barrier) are supported.
620	622	The style developer must add at least one of the access tags
621		(mkgmap:foot, mkgmap:car etc.), mkgmap:road-speed and/or
622		mkgmap:road-class to the POI.
623		The access tags are ignored if they have no effect for the way,
624		else a route restriction is added at the POI so that only
625		allowed vehicles are routed through it.
626		The tags mkgmap:road-speed and/or mkgmap:road-class are
	623	(mkgmap:foot, mkgmap:car etc.), mkgmap:road-speed and/or
	624	mkgmap:road-class to the POI.
	625	The access tags are ignored if they have no effect for the way,
	626	else a route restriction is added at the POI so that only
	627	allowed vehicles are routed through it.
	628	The tags mkgmap:road-speed and/or mkgmap:road-class are
627	629	applied to a small part of the way around the POI, typically
628	630	to the next junction or a length of ~25 m. The tags
629		are ignored for pedestrian-only ways.
630
	631	are ignored for pedestrian-only ways.
	632	<p>
631	633	;--process-destination
632	634	: Splits all motorway_link, trunk_link, and primary_link
633		ways tagged with destination into two or three parts where
	635	ways tagged with destination into two or three parts where
634	636	the second part is additionally tagged with mkgmap:dest_hint=true.
635		This allows using any routable Garmin type (except 0x08 and 0x09)
	637	This allows to use any routable Garmin type (except 0x08 and 0x09)
636	638	for that part so that the Garmin device tells the name of
637	639	this part as hint which destination to follow.
638	640	See also --process-exits.
639
	641	<p>
640	642	;--process-exits
641	643	: Usual Garmin devices do not tell the name of the exit on motorways
642	644	while routing with mkgmap created maps. This option splits each
643	645	motorway_link, trunk_link and primary_link way into three parts.
644	646	All parts are tagged with the original tags of the link.
645	647	Additionally the middle part is tagged with the following tags:
	648	<pre>
646	649	mkgmap:exit_hint=true
647	650	mkgmap:exit_hint_ref=<ref tag value of the exit>
648	651	mkgmap:exit_hint_name=<name tag value of the exit>
649	652	mkgmap:exit_hint_exit_to=<exit_to tag value of the exit>
650
651		: Adding a rule checking the mkgmap:exit_hint=true makes it possible
	653	</pre>
	654	Adding a rule checking the mkgmap:exit_hint=true makes it possible
652	655	to use any routable Garmin type (except 0x08 and 0x09) for the middle
653	656	part so that the Garmin device tells the name of this middle part as
654		hint where to leave the motorway/trunk. The first part must have type
655		0x08 or 0x09 so that Garmin uses the hint.
	657	hint where to leave the motorway/trunk.
	658	The first part must have type 0x08 or 0x09 so that Garmin uses the hint.
656	659
657	660	;--delete-tags-file=FILENAME
658	661	: Names a file that should contain one or more lines of the form
659	662	TAG=VALUE or TAG=*. Blank lines and lines that start with
660	663	a # or ; are ignored. All tag/value pairs in the OSM input are
661	664	compared with these patterns and those that match are deleted.
662
	665	<p>
663	666	;--tdbfile
664	667	: Write files that are essential to running with MapSource, a .tdb file and
665	668	an overview map.
666
	669	<p>
667	670	;--show-profiles=1
668	671	: Sets a flag in tdb file which marks set mapset as having contour
669	672	lines and allows showing profile in MapSource. Default is 0
670	673	which means disabled.
671
	674	<p>
672	675	;--draw-priority=25
673	676	: When two maps cover the same area, this option controls what
674	677	order they are drawn in and therefore which map is on top of
675	678	which. Higher priorities are drawn "on top" of lower
676	679	priorities.
677
	680	<p>
678	681	;--transparent
679	682	: Make the map transparent, so that if two maps are loaded that
680	683	cover the same area, you can see through this map and see the
681	684	lower map too. Useful for contour line maps among other
682	685	things.
683
	686	<p>
684	687	;--poi-address
685	688	: Enable address / phone information to POIs. Address info is
686	689	read according to the "Karlsruhe" tagging schema. Automatic
687	690	filling of missing information could be enabled using the
688	691	"location-autofill" option.
689
690		: Default is enabled, use --no-poi-address to disable.
691
	692	Default is enabled, use --no-poi-address to disable.
	693	<p>
692	694	;--verbose
693	695	: Makes some operations more verbose. Mostly used with --list-styles.

-5

resources/help/en/options less more

477	477	can be specified with this option. This is a workaround for not
478	478	being able to search for roads.
479	479	0x2f15: a blue dot in the middle of the road, and if you select,
480		or 'hover' over it, the street name appears.
	480	or 'hover' over it, the street name appears.
481	481
482	482	--add-pois-to-lines
483	483	Generate POIs for lines. For each line (must not be closed) POIs are

639	639	Usual Garmin devices do not tell the name of the exit on motorways
640	640	while routing with mkgmap created maps. This option splits each
641	641	motorway_link, trunk_link and primary_link way into three parts.
642		All parts are tagged with the original tags of the link.
643		Additionally the middle part is tagged with the following tags:
	642	All parts are tagged with the original tags of the link.
	643	Additionally the middle part is tagged with the following tags:
644	644	mkgmap:exit_hint=true
645	645	mkgmap:exit_hint_ref=<ref tag value of the exit>
646	646	mkgmap:exit_hint_name=<name tag value of the exit>

649	649	to use any routable Garmin type (except 0x08 and 0x09) for the middle
650	650	part so that the Garmin device tells the name of this middle part as
651	651	hint where to leave the motorway/trunk.
652		The first part must have type 0x08 or 0x09 so that Garmin uses the hint.
	652	The first part must have type 0x08 or 0x09 so that Garmin uses the hint.
653	653
654	654	--delete-tags-file=FILENAME
655	655	Names a file that should contain one or more lines of the form
656	656	TAG=VALUE or TAG=*. Blank lines and lines that start with
657		# or ; are ignored. All tag/value pairs in the OSM input are
	657	a # or ; are ignored. All tag/value pairs in the OSM input are
658	658	compared with these patterns and those that match are deleted.
659	659
660	660	--tdbfile

-2

resources/mkgmap-version.properties less more

0		svn.version: 3656
1		build.timestamp: 2015-12-19T07:08:56+0000
	0	svn.version: 3660
	1	build.timestamp: 2016-01-24T08:14:44+0000

-4

resources/styles/default/inc/name less more

1	1	# name, brand, operator, ref
2	2
3	3	# delete FIXME values (they should be better used in maintenance maps)
4		ref=FIXME \| ref=fixme { delete ref; }
5		operator=FIXME \| operator=fixme { delete operator; }
6		brand=FIXME \| brand=fixme { delete brand; }
7		name=FIXME \| name=fixme { delete name; }
	4	ref ~ '(?i)fix[ _]?+me' { delete ref; }
	5	operator ~ '(?i)fix[ _]?+me' { delete operator; }
	6	brand ~ '(?i)fix[ _]?+me' { delete brand; }
	7	name ~ '(?i)fix[ _]?+me' { delete name; }
8	8
9	9	# delete duplicate names
10	10	operator=${brand} { delete operator; }

-0

scripts/download/mkdoc less more

17	17	mwtext -t text $f > ../dist/doc/$f
18	18	done
19	19
	20	# Use the actual options help file.
	21	cp resources/help/en/options ../dist/doc/options.txt
	22
20	23	DOC=~/www/web/mkgmap/content/doc
21	24	WEB_DOC_PDF=~/www/mkgmap.org.uk/docroot/doc/pdf
22	25	cp *.txt $DOC

-0

src/uk/me/parabola/imgfmt/app/Coord.java less more

779	779	double ap = a.distance(this);
780	780	double ab = a.distance(b);
781	781	double bp = b.distance(this);
	782	if (ap == 0 \|\| bp == 0)
	783	return 0;
782	784	double abpa = (ab+ap+bp)/2;
783	785	double dx = abpa-ab;
784	786	double dist;

-0

src/uk/me/parabola/imgfmt/app/net/RouteNode.java less more

549	549	public void reportSimilarArcs() {
550	550	for(int i = 0; i < arcs.size(); ++i) {
551	551	RouteArc arci = arcs.get(i);
	552	if (arci.isDirect() == false)
	553	continue;
552	554	for(int j = i + 1; j < arcs.size(); ++j) {
553	555	RouteArc arcj = arcs.get(j);
	556	if (arcj.isDirect() == false)
	557	continue;
554	558	if(arci.getDest() == arcj.getDest() &&
555	559	arci.getLength() == arcj.getLength() &&
556	560	arci.getPointsHash() == arcj.getPointsHash()) {
	561	log.error(arci.isForward(),arcj.isForward());
557	562	log.warn("Similar arcs (" + arci.getRoadDef() + " and " + arcj.getRoadDef() + ") from " + coord.toOSMURL());
558	563	}
559	564	}

-3

src/uk/me/parabola/mkgmap/osmstyle/housenumber/ExtNumbers.java less more

347	347	return null;
348	348
349	349	List<Numbers> list = new ArrayList<>();
	350	boolean headerWasReported = false;
350	351	for (ExtNumbers curr = this; curr != null; curr = curr.next){
351	352	if (curr.hasNumbers() == false)
352	353	continue;
353	354	list.add(curr.getNumbers());
354	355	if (log.isInfoEnabled()) {
355		if (curr.prev == null){
	356	if (headerWasReported == false){
356	357	MapRoad road = curr.getRoad();
357	358	if (road.getStreet() == null && road.getName() == null)
358	359	log.info("final numbers for", road, curr.housenumberRoad.getName(), "in", road.getCity());
359	360	else
360	361	log.info("final numbers for", road, "in", road.getCity());
	362	headerWasReported = true;
361	363	}
362	364	Numbers cn = curr.getNumbers();
363	365	log.info("Left: ",cn.getLeftNumberStyle(),cn.getIndex(),"Start:",cn.getLeftStart(),"End:",cn.getLeftEnd(), "numbers "+curr.getHouses(Numbers.LEFT));

584	586
585	587	if (toAdd == null) {
586	588	Coord wanted = c1.makeBetweenPoint(c2, wantedFraction);
587
	589	log.debug("possible solution: split segment with length",formatLen(segmentLength),"near",formatLen(wantedFraction * segmentLength));
588	590	toAdd = rasterLineNearPoint(c1, c2, wanted, true);
589	591	if (toAdd != null){
590	592	if (toAdd.equals(c1)){

621	623	log.error("internal error, cannot split",this);
622	624	}
623	625	if (toAdd != null){
624		if (log.isDebugEnabled())
	626	if (log.isDebugEnabled()){
625	627	log.debug("solution: split segment with length",formatLen(segmentLength),"at",formatLen(usedFraction * segmentLength));
	628	double distToLine = toAdd.getDisplayedCoord().distToLineSegment(c1.getDisplayedCoord(), c2.getDisplayedCoord());
	629	log.info("adding number node at",toAdd.toDegreeString(),"to split, dist to line is",formatLen(distToLine));
	630	}
626	631	doSplit = true;
627	632	splitSegment = seg+1;
628	633	addAsNumberNode(splitSegment, toAdd);

-0

src/uk/me/parabola/mkgmap/osmstyle/housenumber/HousenumberGroup.java less more

154	154	pointToUse = (opt1Dist < opt2Dist) ? c1 : c2;
155	155	}
156	156	else {
	157	if (log.isInfoEnabled()){
	158	double distLine = pointToUse.distToLineSegment(c1.getDisplayedCoord(), c2.getDisplayedCoord());
	159	log.info("adding number nodes at",pointToUse.toDegreeString(),"to optimize address search", "dist to line is", HousenumberGenerator.formatLen(distLine));
	160	}
157	161	timesToAdd = 2;
158	162	}
159	163	}