'\" -*- 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 nik4 1 "01 August 2018" "" ""
.SH NAME
nik4 \- Tile-aware Mapnik image renderer
.SH SYNOPSIS
'nh
.fi
.ad l
\fBnik4\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB-h\fR] [\fB--version\fR] [\fB-z\fR \fIZOOM\fR] [\fB-p\fR \fIPPI\fR] [\fB--factor\fR \fIFACTOR\fR] [\fB-s\fR \fISCALE\fR] [\fB-b\fR \fIXmin Ymin Xmax Ymax\fR] [\fB-a\fR \fIPAPER\fR] [\fB-d\fR \fIW H\fR] [\fB-x\fR \fIW H\fR] [\fB--norotate\fR] [\fB-m\fR \fIMARGIN\fR] [\fB-c\fR \fIX Y\fR] [\fB--fit\fR \fIFIT\fR] [\fB--padding\fR \fIPADDING\fR] [\fB--layers\fR \fILAYERS\fR] [\fB--add-layers\fR \fIADD_LAYERS\fR] [\fB--hide-layers\fR \fIHIDE_LAYERS\fR] [\fB--url\fR \fIURL\fR] [\fB--ozi\fR \fIOZI\fR] [\fB--wld\fR \fIWLD\fR] [\fB-t\fR \fI{1,2,3,4,5,6,7,8,9,10,11,12}\fR] [\fB--just-tiles\fR] [\fB-v\fR] [\fB-f\fR \fIFMT\fR] [\fB--base\fR \fIBASE\fR] [\fB--vars\fR \fI[VARS [VARS ...]]\fR] [\fB--fonts\fR \fI[FONTS [FONTS ...]]\fR] \fIstyle\fR \fIoutput\fR 
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBnik4\fR is a Python script to generate images with Mapnik.
.SH OPTIONS
Positional arguments:
.TP 
\fIstyle\fR
Style file for Mapnik
.TP 
\fIoutput\fR
Resulting image file
.PP
Optional arguments:
.TP 
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
Show usage information and exit
.TP 
\*(T<\fB\-\-version\fR\*(T>
Show program's version number and exit
.TP 
\*(T<\fB\-z\fR\*(T> \fIZOOM\fR, \*(T<\fB\-\-zoom\fR\*(T> \fIZOOM\fR
Target zoom level
.TP 
\*(T<\fB\-p\fR\*(T> \fIPPI\fR, \*(T<\fB\-\-ppi\fR\*(T> \fIPPI\fR, \*(T<\fB\-\-dpi\fR\*(T> \fIPPI\fR
Pixels per inch (alternative to scale)
.TP 
\*(T<\fB\-\-factor\fR\*(T> \fIFACTOR\fR
Scale factor (affects ppi, default=1)
.TP 
\*(T<\fB\-s\fR\*(T> \fISCALE\fR, \*(T<\fB\-\-scale\fR\*(T> \fISCALE\fR
Scale as in 1:100000 (specifying ppi is recommended)
.TP 
\*(T<\fB\-b\fR\*(T> \fIXmin Ymin Xmax Ymax\fR, \*(T<\fB\-\-bbox\fR\*(T> \fIXmin Ymin Xmax Ymax\fR
Bounding box
.TP 
\*(T<\fB\-a\fR\*(T> \fIPAPER\fR, \*(T<\fB\-\-paper\fR\*(T> \fIPAPER\fR
Paper format:
\*(T<\fB\-a\fR\*(T> \*(T<+4\*(T> for landscape A4,
\*(T<\fB\-a\fR\*(T> \*(T<\-4\*(T> for portrait A4,
\*(T<\fB\-a\fR\*(T> \*(T<letter\*(T> for autorotated
US Letter
.TP 
\*(T<\fB\-d\fR\*(T> \fIW H\fR, \*(T<\fB\-\-size\fR\*(T> \fIW H\fR
Target dimensions in mm (one 0 allowed)
.TP 
\*(T<\fB\-x\fR\*(T> \fIW H\fR, \*(T<\fB\-\-size\-px\fR\*(T> \fIW H\fR
Target dimensions in pixels (one 0 allowed)
.TP 
\*(T<\fB\-\-norotate\fR\*(T>
Do not swap width and height for bbox
.TP 
\*(T<\fB\-m\fR\*(T> \fIMARGIN\fR, \*(T<\fB\-\-margin\fR\*(T> \fIMARGIN\fR
Amount in mm to reduce paper size
.TP 
\*(T<\fB\-c\fR\*(T> \fIX Y\fR, \*(T<\fB\-\-center\fR\*(T> \fIX Y\fR
Center of an image
.TP 
\*(T<\fB\-\-fit\fR\*(T> \fIFIT\fR
Fit layers in the map, comma-separated
.TP 
\*(T<\fB\-\-padding\fR\*(T> \fIPADDING\fR
Margin for layers in \*(T<\fB\-\-fit\fR\*(T> (default=5), mm
.TP 
\*(T<\fB\-\-layers\fR\*(T> \fILAYERS\fR
Map layers to render, comma-separated
.TP 
\*(T<\fB\-\-add\-layers\fR\*(T> \fIADD_LAYERS\fR
Map layers to include, comma-separated
.TP 
\*(T<\fB\-\-hide\-layers\fR\*(T> \fIHIDE_LAYERS\fR
Map layers to hide, comma-separated
.TP 
\*(T<\fB\-\-url\fR\*(T> \fIURL\fR
URL of a map to center on
.TP 
\*(T<\fB\-\-ozi\fR\*(T> \fIOZI\fR
Generate ozi map file
.TP 
\*(T<\fB\-\-wld\fR\*(T> \fIWLD\fR
Generate world file
.TP 
\*(T<\fB\-t\fR\*(T> \fI{1,2,3,4,5,6,7,8,9,10,11,12}\fR, \*(T<\fB\-\-tiles\fR\*(T> \fI{1,2,3,4,5,6,7,8,9,10,11,12}\fR
Write N\(muN tiles, then join using ImageMagick
.TP 
\*(T<\fB\-\-just\-tiles\fR\*(T>
Do not join tiles, instead write ozi/wld file for each
.TP 
\*(T<\fB\-v\fR\*(T>, \*(T<\fB\-\-debug\fR\*(T>
Display calculated values
.TP 
\*(T<\fB\-f\fR\*(T> \fIFMT\fR, \*(T<\fB\-\-format\fR\*(T> \fIFMT\fR
Target file format (by default looks at extension)
.TP 
\*(T<\fB\-\-base\fR\*(T> \fIBASE\fR
Base path for style file, in case it's piped to STDIN
.TP 
\*(T<\fB\-\-vars\fR\*(T> \fI[VARS [VARS ...]]\fR
List of variables (name=value) to substitute in style file
(use ${name:default})
.TP 
\*(T<\fB\-\-fonts\fR\*(T> \fI[FONTS [FONTS ...]]\fR
List of full path to directories containing fonts