5
by Andrew Apted. 13th September 2005.
8
glBSP comes in three flavours: a text/command-line utility "glbsp",
9
a graphical/GUI version "glBSPX", and it can be compiled as a
10
library for other programs to use: "libglbsp".
12
Currently the following operating systems are supported: Unix (Linux),
13
Windows (95/98/etc), MacOS X, and DOS. All flavours are supported in
14
all systems except for glBSPX and the plugin under DOS.
16
There are two compiling methods: using a makefile, and using an IDE.
17
Currently the Unix, MacOS X and DOS versions all use makefiles, and
18
under Windows there are project files for Dev-C++ (see the "Links"
19
below) and for Microsoft MSVC.NET 2002, as well as makefiles for
22
The GUI version (glBSPX) requires a graphical toolkit called FLTK
23
(Fast Light Tool Kit) version 1.1.6. Other versions may work, but
5
by Andrew Apted. JULY 2007
8
glBSP comes in three flavors: a command-line utility "glbsp", a
9
graphical/GUI version "glBSPX", and a library for programs to use
10
called: "libglbsp". The source code is structured so that both
11
programs link against the library, hence libglbsp is always built.
13
The GUI version, glBSPX, requires a graphical toolkit called FLTK
14
(Fast Light Tool Kit) version 1.1.7. Other versions may work, but
24
15
you're on your own there. See the "Links" section below if you
25
16
need to download it.
27
The Unix makefiles support a "make install", which has to be done
28
as root. None of the other methods have an automatic installation:
29
just copy the glbsp (or glBSPX) executable where you want it.
36
MacOS X: make -f Makefile.osx
38
MSDOS with DJGPP: make -f Makefile.dj
40
Windows with MinGW: mingw32-make -f Makefile.w32
42
Windows with Dev-C++: open the Cmdline.dev project file.
43
Windows with MSVC.NET: open the Cmdline.vcproj project file.
18
Sorry to say, but there is no support for compiling with an IDE
19
(like Dev-C++ or Visual Studio) in this release. The directory
20
layout was improved when the code moved to the SVN repository,
21
but unfortunately this broke all the existing project files.
24
NOTE WELL: glBSP is under the GNU General Public License (GPL),
25
hence you cannot use the library (libglbsp) in your
26
own program unless it is also under the GPL.
28
The file COPYING.txt contains a copy of the GPL
29
license, and there is a lot of useful information
30
at this web page: http://www.gnu.org/licenses/
36
The makefile is called "Makefile.unx". You may need to open it
37
in an editor and edit some stuff near the top, especially if you
38
want to use another compiler (only GNU GCC has been well tested)
39
or to change the directory where FLTK can be found.
41
To build the library and command-line program:
43
> make -f Makefile.unx
45
To build the GUI version:
47
> make -f Makefile.unx glBSPX
49
To install the command-line program and manual page:
51
> sudo make -f Makefile.unx install
49
The plugin version of glBSP is a special version that can be used
50
within other programs, e.g. a DOOM engine. The result of the build
51
is a library file: libglbsp.a (libglbsp.lib for VC++ under Win32).
53
Unix/Linux: make -f Plugin_unx.mak
54
MacOS X: make -f Plugin_osx.mak
56
Windows with MinGW: mingw32-make -f Plugin_w32.mak
58
Windows with Dev-C++: open the Plugin.dev project file.
59
Windows with MSVC.NET: open the Plugin.vcproj project file.
62
Since glBSP is under the GNU General Public License (GPL), it
63
can only be incorporated into other programs that are also
64
under the GPL. See the file COPYING.txt for all the details.
67
Graphical version: glBSPX
68
-------------------------
70
glBSPX is the GUI version of glBSP, written in C++ and requires the
71
FLTK toolkit, version 1.1.6. FLTK needs to be built before trying
72
to build glBSPX: see the next section for some guidelines.
74
Unix/Linux: make -f GUI_unx.mak
75
MacOS X: make -f GUI_osx.mak
77
Windows with MinGW: mingw32-make -f GUI_w32.mak
79
Windows with Dev-C++: open the GUI.dev project file.
87
Use the normal method (configure, make, make install). Make sure the
88
static library is built (although dynamic should work). Since OpenGL
89
isn't needed, I usually configure with "--disable-gl".
93
Similar, but should use "./configure --prefix=$HOME" (that's where the
94
glBSPX makefile expects to find it). Edit fltk/makefile.osx if it has
95
been installed somewhere else. Also I've only tested the static
100
Using MinGW: copy the makefiles/makeinclude.mingw31 file to be
101
./makeinclude, and copy makefiles/config.h to top level. I then
102
edit config.h to remove OpenGL, PNG and JPEG support. You may
103
need to changes some / characters to \ in makeinclude and in
104
src/Makefile. Ignore the top level Makefile, cd into src and
107
Note that the glBSPX project/make files assume that fltk-1.1.6
108
and glbsp-2.20 are in the same directory.
114
The command line version has run successfully on these platforms:
116
+ Linux 2.1.126, libc5, GCC 2.7.2.1.
117
+ Linux 2.2.18, glibc 2.2, GCC 2.95.2.
118
+ Linux 2.4.22-PPC, glibc 2.3.1, GCC 3.2.2.
120
+ MacOS X (10.2.4) with GCC 3.1.
122
+ Win32, with Dev-C++ and MinGW.
123
+ Win32, with MSVC.NET 2002.
125
+ MSDOS 6.22, with DJGPP 2.02.
57
The makefile is called "Makefile.w32" and uses the MinGW tools
58
(see the link below) for compiling, and you may need MSYS too.
59
You will also need the ZLIB library (version 1.2.3) and should
62
To build the library and command-line program:
64
> mingw32-make -f Makefile.w32
66
There is no support yet for building the GUI binary natively
67
under Windows (sorry).
70
Cross-Compiling Win32 Binaries
71
------------------------------
73
The "Makefile.xming" makefile lets you compile Win32 binaries
74
without leaving the comfort of Linux. You will need to compile
75
FLTK and ZLIB libraries first (maybe edit the makefile to set
78
To build the library and command-line program:
80
> make -f Makefile.xming
82
To build the GUI version:
84
> make -f Makefile.xming glBSPX.exe
134
Dev-C++ (an open source IDE for Windows) home page:
135
http://dev-cpp.sourceforge.net
137
90
Minimum GNU Windows compiler:
138
91
http://www.mingw.org
140
93
Fast Light Toolkit home page:
141
94
http://www.fltk.org
96
ZLib Compression library: