leaftest/README.md

36 lines
1.7 KiB
Markdown
Raw Normal View History

2015-02-19 16:02:56 +01:00
#Leaftest
Leaftest consists of a bash script that uses [minetestmapper](https://github.com/Rogier-5/minetest-mapper-cpp) to display the map on a leaflet based zoomable sloppy map.
The map is generated in chunks through many invocations of `minetestmapper` instead of one invocation and large file thats cropped later, so that memory requirements for all tools are unrelated to the map size.
##Dependencies
You will need:
2015-02-19 16:12:09 +01:00
-bash
2015-02-19 19:21:03 +01:00
-imagemagick
2015-02-19 16:12:09 +01:00
-a web server of some sort
-minetestmapper
2015-02-19 16:02:56 +01:00
Get a clone:
```
git clone --recursive https://github.com/est31/leaftest.git
```
To start the mapping, do:
```
MAPPERDIR=dir/containing/minetestmapper ./mapper.sh path/to/world spawnx,spawny dimension
```
If you have additional parameters for `minetestmapper`, like a `colors.txt` path of your choice, you can add them to the `MAPPERPARAMS` variable.
The `dimension` number specifies the width and height of the map that should be rendered, centering with your spawn position. `dimension` should be a multiple of 8*256 = 2048, 6144 is a good starting value.
After mapping has finished, you can open the `www/map.html` file. If you want to publish your results, you can either symlink the `www` directory into your `/var/www` directory, or copy it. Due to usage of relative symlinks, you should use `rsync -L`, so that the copied directory doesn't contain symlinks.
2016-01-17 19:34:33 +01:00
You can use the `JOBNUM` environment variable to control the number of parallel jobs used for creating the tiles.
2015-02-19 16:02:56 +01:00
##License
2015-02-19 19:21:03 +01:00
Copyright (c) 2015 est31, License: MIT.
2016-01-17 19:34:33 +01:00
Parts base on unilicensed script from [LibertyLand](http://www.ayntest.net/pages/liberty-land-map.html) minetest server, [github here](https://github.com/ayntest/ayntest.github.io).