mirror of
https://github.com/minetest/minetestmapper.git
synced 2024-11-16 07:30:28 +01:00
fe5ba54fc9
The produces tiled output way faster than repeatedly using --geometry because it only reads the databse once.
106 lines
2.8 KiB
Groff
106 lines
2.8 KiB
Groff
.TH MINETESTMAPPER 6
|
|
.SH NAME
|
|
minetestmapper \- generate an overview image of a Minetest map
|
|
.SH SYNOPSIS
|
|
.B minetestmapper
|
|
\fB\-i\fR \fIworld_path\fR
|
|
\fB\-o\fR \fIoutput_image\fR
|
|
.PP
|
|
See additional optional parameters below.
|
|
.SH DESCRIPTION
|
|
.B minetestmapper
|
|
generates an overview image of a minetest map. This is a port of
|
|
the original minetestmapper.py to C++, that is both faster and
|
|
provides more functionality than the deprecated Python script.
|
|
.SH MANDATORY PARAMETERS
|
|
.TP
|
|
.BR \-i " " \fIworld_path\fR
|
|
Input world path.
|
|
.TP
|
|
.BR \-o " " \fIoutput_image\fR
|
|
Path to output image. (only PNG supported currently)
|
|
.SH OPTIONAL PARAMETERS
|
|
.TP
|
|
.BR \-\-bgcolor " " \fIcolor\fR
|
|
Background color of image, e.g. "--bgcolor #ffffff"
|
|
|
|
.TP
|
|
.BR \-\-scalecolor " " \fIcolor\fR
|
|
Color of scale, e.g. "--scalecolor #000000"
|
|
|
|
.TP
|
|
.BR \-\-playercolor " " \fIcolor\fR
|
|
Color of player indicators, e.g. "--playercolor #ff0000"
|
|
|
|
.TP
|
|
.BR \-\-origincolor " " \fIcolor\fR
|
|
Color of origin indicator, e.g. "--origincolor #ff0000"
|
|
|
|
.TP
|
|
.BR \-\-drawscale
|
|
Draw tick marks
|
|
|
|
.TP
|
|
.BR \-\-drawplayers
|
|
Draw player indicators
|
|
|
|
.TP
|
|
.BR \-\-draworigin
|
|
Draw origin indicator
|
|
|
|
.TP
|
|
.BR \-\-drawalpha
|
|
Allow nodes to be drawn with transparency
|
|
|
|
.TP
|
|
.BR \-\-noshading
|
|
Don't draw shading on nodes
|
|
|
|
.TP
|
|
.BR \-\-noemptyimage
|
|
Don't output anything when the image would be empty.
|
|
|
|
.TP
|
|
.BR \-\-min-y " " \fInumber\fR
|
|
Don't draw nodes below this y value, e.g. "--min-y -25"
|
|
|
|
.TP
|
|
.BR \-\-max-y " " \fInumber\fR
|
|
Don't draw nodes above this y value, e.g. "--max-y 75"
|
|
|
|
.TP
|
|
.BR \-\-backend " " \fIbackend\fR
|
|
Use specific map backend; supported: *sqlite3*, *leveldb*, *redis*, *postgresql*, e.g. "--backend leveldb"
|
|
|
|
.TP
|
|
.BR \-\-geometry " " \fIgeometry\fR
|
|
Limit area to specific geometry (*x:y+w+h* where x and y specify the lower left corner), e.g. "--geometry -800:-800+1600+1600"
|
|
|
|
.TP
|
|
.BR \-\-tilesize " " \fItilesize\fR
|
|
Don't output one big image, but output tiles of the specified size, e.g. "--tilesize 128x128". The sizes will be rounded to
|
|
a multiple of 16. The filenames will be created in the form <x>_<y>_<filename>, where <x> and <y>
|
|
are the tile numbers and <filename> is the name specified with -o. Skip empty tiles by also specifying --noemptyimage.
|
|
|
|
.TP
|
|
.BR \-\-extent " " \fIextent\fR
|
|
Dont render the image, just print the extent of the map that would be generated, in the same format as the geometry above.
|
|
|
|
.TP
|
|
.BR \-\-zoom " " \fIfactor\fR
|
|
Zoom the image by using more than one pixel per node, e.g. "--zoom 4"
|
|
|
|
.TP
|
|
.BR \-\-colors " " \fIpath\fR
|
|
Forcefully set path to colors.txt file (it's autodetected otherwise), e.g. "--colors ../minetest/mycolors.txt"
|
|
|
|
.TP
|
|
.BR \-\-scales " " \fIedges\fR
|
|
Draw scales on specified image edges (letters *t b l r* meaning top, bottom, left and right), e.g. "--scales tbr"
|
|
|
|
.SH MORE INFORMATION
|
|
Website: https://github.com/minetest/minetestmapper
|
|
|
|
.SH MAN PAGE AUTHOR
|
|
Daniel Moerner
|