Here are some instructions for installing and using the map editor. You can also read the README which is included in openmedit but this documentation could be newer than the included.
To compile openmedit on windows, you need:
openmedit 0.2 was successfully tested on several operating systems:
If you have another platform openmedit works on then write to me.
First you need to unpack the archive: To unpack a .tar.gz archive on Linux/Unix type: 'tar xzvf file.tar.gz'. To unpack a .tar.bz2 type 'tar xjvf file.tar.gz'. On Windows use a program like WinZip to unpack it. If you are using MacOS X then StuffIt Expander should expand the stuff for you ;-)
If you are using Windows then you should run the binary. If you really want to compile it then use the Microsoft Visual C++ compiler (if you can compile it on an other compiler then write to me). Simply click on the project file (.dsp) to open it it press CTRL+F5 to compile and run. There is currently no graphical installer. If you want to make one then write to me.
MacOS X users should run the binary, too. If you want to compile it, then double click on 'openmedit.xcode' and press Apple+B to compile it.
On Linux/Unix you can edit the Makefile if you want to change some pathes. Then type 'make' to compile, 'make install' as root to install it and 'make clean' to clean unnecessary binaries. To uninstall type 'make uninstall'.
If you run FreeBSD then use the Makefile.freebsd to compile openmedit: type 'make -f Makefile.freebsd' to compile.
If you have errors while compiling then check whether all required libraries are installed. If you still have errors then check the Makefile. If you still have errors then write to me ;-)
To start openmedit under Windows simply double click on 'openshooter.exe'.
On MacOS X double click on 'openmedit'.
On Linux/Unix type 'openmedit' in an xterm (or add it into your windowmanager menu)
Creating and editing objects
After starting openmedit press F1 to create a new map. Then type the name of the map (e.g. mymap). Note that the map will be saved in Windows on drive C: (in our example C:\mymap) and on Linux/Unix and MacOS X in you home directory (e.g. /home/tom/mymap or /Users/tom/mymap).
You will see a green grid and a white cursor in the middle of the screen. To move the cursor press 'w', 's', 'a', 'd', 'r', 'f'. To move the camera additionaly press alt. To move faster hold ctrl and to move slower hold alt or ctrl+alt. Now let's create an object: Press '4' to create a quad at the cursor position. Press space to go to the object mode. There will appear instructions on the screen so I don't want to explain here everything. On the bottom right you will always see the current mode. When you are in View mode you can type 'h' for a help screen.
If you have multiple objects, you can select them with 'x'/'c' or left/right.
If you want to leave the program temporary then click with the mouse and you can go to other programs. Click again in the map editor window and you can continue your work.
Loading and applying textures
First put some BMP textures in the map directory (C:\mymap or whatever). Note that the width and height of the texture must be power of 2 (e.g. 256x512). When in view mode, type 't' and select your texture with 'w'/'s'. Load it with 'l' or 'd'. If you want to apply the texture on a skybox then press 'c' so there are no lines on the borders. Then close the texture menu with space and select the object that you want to texturize. Press space and then 't' and select the texture with 'r'/'f'. If you want you can rotate the texture with 'x'/'c' and repeat it with 'w'/'s'/'a'/'d'.
Saving and loading maps
You can save maps in the View and Startup mode. Simply press F3 for quick saving the map. If you want to load a map then press F2 and enter the name of the map.
If you want to load a map in openshooter then copy the map directory in the maps directory of openshooter (on Linux/Unix /usr/local/lib/openshooter/maps)
MacOS X users have to right click 'openshooter' and click on 'Show Package Contents'. Then click on Contents, Resources, maps and copy the map into this directory.
FAQ (Frequently asked questions)
You can contact me via e-mail (tom at eggdrop.ch) or ICQ (166514901).
Don't forget to visit my site www.eggdrop.ch
Have a lot of fun!