Generate block images from textures

README.md

@@ -1,8 +1,8 @@
 Minetest MTS Editor
 ===================
 
-This is a simple editor for [Minetest](https://www.minetest.net) Schematic files
-([MTS](https://gitlab.com/bztsrc/mtsedit/blob/master/docs/mts_format.md))
+<img src="https://gitlab.com/bztsrc/mtsedit/blob/master/etc/mtsedit.png"> This is a simple editor for
+[Minetest](https://www.minetest.net) Schematic files ([MTS](https://gitlab.com/bztsrc/mtsedit/blob/master/docs/mts_format.md))
 
 ```
 MineTest Schematics Editor by bzt Copyright (C) 2019 MIT license
@@ -26,8 +26,8 @@ MineTest Schematics Editor by bzt Copyright (C) 2019 MIT license
 Batch Mode
 ----------
 
-You can convert MTS files and generate preview images for them from a script with this tool.
-[Read more](https://gitlab.com/bztsrc/mtsedit/blob/master/docs/batch.md).
+You can convert MTS files and generate preview images for them from a script with this tool. You can also generate the block
+images for the editor. [Read more](https://gitlab.com/bztsrc/mtsedit/blob/master/docs/batch.md).
 
 Interactive Mode
 ----------------
@@ -46,10 +46,54 @@ and capable of generating the blocks.csv for you.
 
 <img src="https://gitlab.com/bztsrc/mtsedit/raw/master/docs/mtseditmod.png">
 
-You can install this Minetest mod by running
+Installation
+------------
+
+### Under Linux
+
+1. download [mtsedit-x86_64-linux.tgz](https://gitlab.com/bztsrc/mtsedit/raw/master/mtsedit-x86_64-linux.tgz)
+2. as root, extract it to "/" (if you don't trust it, check the tarball first): "sudo tar -C / -xzvf mtsedit-x86_64-linux.tgz"
+3. I guess you know your distro enough to assign a program to an extension. There are many ways, but if your desktop environment
+recognizes the MTSEdit application from the installed .desktop file, then file assosiation has already taken care for you.
+4. if the MTSEdit application appears in the application menu, but .mts files are not recognized, then as root add the
+```
+model/vnd.mts                mts schematic
+```
+line to "/etc/mime.types".
+
+### Under Windows
+
+1. download [mtsedit-i686-win.zip](https://gitlab.com/bztsrc/mtsedit/raw/master/mtsedit-i686-win.zip)
+2. unpack it into "C:\\Program Files (x86)"
+3. open My Computer, from the "Tools" menu, select "Folder Options"
+4. click on "File Types" tab
+5. scroll down to "MTS" (if you can't find it, click on "New" button and add it)
+6. click on "Change" button
+7. click on "Browse..." button
+8. choose "C:\\Program Files (x86)\\MTSEdit\\mtsedit.exe"
+9. check "Always use the selected program to open this kind of file"
+10. click on "Ok" button
+
+### Under MacOSX
+
+1. download [mtsedit-intel-macosx.zip](https://gitlab.com/bztsrc/mtsedit/raw/master/mtsedit-intel-macosx.zip)
+2. unpack it into "/Applications"
+3. in the Finder, find an .mts file
+4. pull down the "File" menu and select "Get info" or press <kbd>Command</kbd>+<kbd>I</kbd>
+5. expand the "Open With" submenu
+6. choose "MTSEdit.app"
+7. click on "Change All..." button
+
+### Installing the Minetest mod (common to all OS)
+
+To install the Minetest mod, you can run the following command using your Minetest mods directory as parameter, for example:
 ```
 ./mtsedit -i ~/.minetest/mods
 ```
+or
+```
+mtsedit.exe -i C:\\Program Files (x86)\Minetest\mods
+```
 
 Compilation
 -----------
@@ -90,6 +134,8 @@ Known Bugs
 Zooming can be slow, because it scales blocks in run-time. Using a cache would require double the memory footprint. I suggest
 to edit on 100% zoom, as that's using a different, fast blitting function.
 
-Rotations are not handled properly, only the first four, 0 - 3 meaning North, West, South, East.
+Rotations are not handled properly, only the first four, 0 - 3 meaning North, West, South, East. Others are only used if there's
+a block image for that rotaion, and then they are picked numerically, not necessarily in rotation order (but you can set all
+rotations, and they will be saved correctly, it's just you might have to click more to get the one you want).
 
 bzt