Minimaps creation alternative / Map diff tool
Posted: 22 Sep 2012, 20:51
As an alternative to have a command-line tool to generate minimaps and also better management of our maps, I created the following tools:
Examples usage
As an example of how they could be used, let's say someone just pushed changes on a map, say 007-1. Someone else reviewes the changes and wants to check if the minimap has to be updated due to "major" visual changes in the map.
This will compare the rendering of the 007-1 map between the 2 most recent commits that modified it.
Such image could be displayed:
which obviously shows the minimap should be regenerated. Using this command:
Another possible usage is that you may want to visualize changes in maps that arent committed yet.
E.g:
which will again generate an image showing visual differences.
In case you would want to compare other changes than the 2 most recent ones, there's always the possibility to do something like:
To see the changes between the last version (83d8751) and the first version (9af1f6d) of the map:
which would show there werent any visual changes since its first creation.
Finally, the minimap creation tool accepts more than one map argument. For example, to update all the existing minimaps:
Minimaps look
A rendered minimap typically looks like this:
You will notice the small outlines to give a cell-shaded effect, that improves readability overs a simple scaled-down version of the map.
Limitations
The raster tool requires a large amount of RAM when the processed map is very large, which may end up to have the tool failing to render the map.
So far, 024-4 is the only map causing a problem with its 500x500 size.... Anyway, it's good practice to not make maps larger than 150x150.
Installation
Want to test ?
There are 2 steps.
If yes, any ways to improve ?
Thanks for your comments
- a command-line tool to create minimaps
- a command-line tool to view differences between revisions of maps
Examples usage
As an example of how they could be used, let's say someone just pushed changes on a map, say 007-1. Someone else reviewes the changes and wants to check if the minimap has to be updated due to "major" visual changes in the map.
Code: Select all
$ cd eathena-data/client-data/tools
$ ./map-diff.py 007-1Such image could be displayed:
- Map Diff (Scaled)
- 007-1_2fbb092-83d8751.png (168.04 KiB) Viewed 6669 times
Code: Select all
$ ./minimap-render.py 007-1E.g:
Code: Select all
$ ./map-diff.py changes-made-by-someone-007-1.tmx ../maps/007-1.tmxIn case you would want to compare other changes than the 2 most recent ones, there's always the possibility to do something like:
Code: Select all
$ git log --oneline ../maps/009-6.tmx
83d8751 Convert map compression format back to gzip. It turned out that the 0.5.0 client, which i
678b7c0 unified collision tiles for beds, moved top part of woodland indoor beds to over layer
2fcd26e Fix improper use of an effectively x2 tileset.
648d875 Fix tux9th's map changes for the new standards.
9af1f6d Maps for PvP-last man standing EventCode: Select all
$ git show 83d8751:../maps/009-6.tmx > 83d8751_009-6.tmx
$ git show 9af1f6d:../maps/009-6.tmx > 9af1f6d_009-6.tmx
$ ./map-diff.py 83d8751_009-6.tmx 9af1f6d_009-6.tmx- 009-6 changes (cropped, scaled)
- 83d8751_009-6__9af1f6d_009-6.png (94.8 KiB) Viewed 6669 times
Code: Select all
$ ./minimap-render.py $(sed s/.png// <<< $(ls ../graphics/minimaps/))A rendered minimap typically looks like this:
- 009-1 minimap
- 009-1.png (13.97 KiB) Viewed 6669 times
Limitations
The raster tool requires a large amount of RAM when the processed map is very large, which may end up to have the tool failing to render the map.
So far, 024-4 is the only map causing a problem with its 500x500 size.... Anyway, it's good practice to not make maps larger than 150x150.
Installation
Want to test ?
There are 2 steps.
- Grab the minimap and diff tools on my map-tools branch of my tmwa-client-data fork. See the 2 related commits here
- Grab the tmxrasterizer tool from the tmxrasterizer branch of my Tiled fork. Follow the compile instructions of Tiled. If you have an existing installation of Tiled, you can safely upgrade and install: there's only the new tmxrasterizer program that will be installed in your path.
- Install the Image Magick tools on your system.
- Git and Python.
If yes, any ways to improve ?
Thanks for your comments
