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.

• Requirements
• Tested
• Installation
• Start
• Creating and editing objects
• Loading and applying textures
• Saving and loading maps
• FAQ (Frequently asked questions)
• Contact

To compile openmedit on windows, you need:

• Microsoft Visual C++ 6.0 or higher (if another compiler works then write to me)
• OpenGL and GLU library (should be included with the compiler)

To compile openmedit on Linux or Unix, you need:

• a C compiler (like gcc)
• GNU make (only Unix/Linux)
• GL library and header files
• GLU library and header files
• JPEG library and header files
• SDL library and header files

To compile openmedit on MacOS X, you need:

• Apple XCode
• OpenGL, Cocoa, Foundation and AppKit framework (should be included)
• SDL framework (download the development libraries at http://www.libsdl.org)

openmedit 0.2 was successfully tested on several operating systems:

• Windows 98 SE
• FreeBSD 5.1-RELEASE
• MacOS X 10.3.2

openmedit 0.1 was successfully tested on several operating systems:

• Windows 98 SE
• FreeBSD 5.1-RELEASE
• Linux 2.4.23 (Debian Sid)

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)

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.

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'.

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.

Question:

• When I try to start openshooter I get 'Xlib: extension "GLX" missing on display ":0.0".'
• After starting openshooter I see the menu screen but I must press enter very long to enter the game and I get only 1 Frame per second.
• After starting openshooter I see nothing (the screen is black)

Answer:

• You have no 3D acceleration drivers installed. Do other OpenGL programs work (try glxgears on a Unix system)? Install some 3D acceleration drivers and send me an e-mail if it still doesn't work.

---

Question:

• After typing 'make' I get: '/bin/sh: line 1: sdl-config: command not found'
• After typing 'make' I get: 'gl_headers.h:38: SDL.h: No such file or directory'

Answer:

• The SDL library is not (fully) installed. You can get the SDL library from http://www.libsdl.org/index.php (Debian users should try apt-get install libsdl1.2-dev). If you are using FreeBSD try 'make -f Makefile.freebsd'.

---

Question:

• I have my GL/JPEG headers in /path/to/include!

Answer:

• Append -I/path/to/include to CFLAGS in the Makefile.

---

Question:

• The SDL/X11 library is in /path/to/lib!

Answer:

• Append -L/path/to/lib to LIBS in the Makefile.

---

Question:

• When compiling openshooter on MacOS X I get 'table of contents for archive: lib/libjpeg.a is out of date; rerun ranlib(1) (can't load from it)'

Answer:

• Go into the Terminal and go into the project directory. Then type 'ranlib lib/libjpeg.a'

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!