'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH map2gcm 1 "05 May 2015" "" ""
.SH NAME
map2gcm \- convert map to KMZ
.SH SYNOPSIS
'nh
.fi
.ad l
\fBmap2gcm\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
\fB-q\fR \fI1..100\fR \fB-s\fR \fI411|422|444\fR \fB-t\fR \fIfile\fR \fIfile1\fR \fIfile2\fR ... \fIfileN\fR \fIoutputfile\fR 
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBmap2gcm\fR is a helper utility for
\fBqlandkartegt\fR(1)
to convert a map to KMZ format.
.PP
The list of selected tiles is a string in a file.
The index count startswith 0 at the top left corner and is incremented
for each element in a row.
A 2x2 tile selection will have the index string '0 1 2 3'.
.PP
The projection of the input files must have the same latitude along a
pixel row.
Mecator and Longitude/Latitude projections match this property.
Transversal Merkator or Lambert projections do not.
.PP
To rectify a geotiff map, you can use the
\fBgdalwarp\fR(1)
command, e.g.

.nf
\*(T<
\fBgdalwarp\fR \fB\-t_srs\fR \fI"EPSG:4326"\fR \fIinputfile\fR \fIoutputfile\fR
      \*(T>
.fi
.SH OPTIONS
.TP 
\*(T<\fB\-q\fR\*(T> \fI1..100\fR
The JPEG quality from 1 to 100. Default is 75
.TP 
\*(T<\fB\-s\fR\*(T> \fI411|422|444\fR
The chroma subsampling. Default is 411
.TP 
\*(T<\fB\-t\fR\*(T> \fIfile\fR \fIfile1\fR \fIfile2\fR ... \fIlonN\fR
File with list of selected tile index
.TP 
\fIoutputfile\fR
Path to KMZ output file
.SH "SEE ALSO"
\fBqlandkartegt\fR(1)