1  ________    __                        __        __    __________
2 /   ___  \  /\ \                      /  \      /  \  /\________ \
3/\  /___/\_\ \ \ \                    /    \    /    \ \/_______/\ \
4\ \ \   \/_/_ \ \ \         _______  /\__/\ \  /\__/\ \         \/ /
5 \ \ \  /\__ \ \ \ \       /\______\ \/_/\ \ \ \/_/\ \ \        / /
6  \ \ \ \/_/\ \ \ \ \      \/______/      \ \ \     \ \ \      / /
7   \ \ \___\/  \ \ \ \_______              \ \ \     \ \ \    /\ \
8    \ \________/  \ \________\              \ \_\     \ \ \   \ \_\
9     \/_______/    \/________/               \/_/      \/_/    \/_/
10
11
12+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
13  GL-117 FREQUENTLY ASKED QUESTIONS
14+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
15
16Section 1: Installing on Linux and Mac
17- ./configure does not find the libraries?
18- ./configure simply does not work?
19- How to compile on MacOSX?
20- Libraries are installed, but gcc (linker) does not find them?
21- internal error, core dump, submit gcc bug report?
22
23Section 2: Configuring the game
24- How to alter resolution, color depth?
25- How to configure the input devices?
26- The joystick rudder and throttle are swapped?
27- Cannot open GLX?
28- Graphics do not initialize?
29- Graphics too lame?
30
31
32+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
33  S E C T I O N   1
34+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
35
36Q: ./configure does not find the libraries?
37
38Make sure to have installed at least OpenGL, GLU, GLUT, OpenGL-devel,
39GLU-devel, and GLUT-devel.
40The exact package names may vary between Linux distributions.
41A good choice for SuSE Linux 8.1 may be Mesa, MesaGLU, MesaGLUT, and
42the -devel equivalents.
43On RedHat 9 you will have to install GLUT-devel!
44
45Make also sure that the library files are located in /lib or /usr/lib.
46For SuSE8.1 the /usr/lib directory must contain libGL.so, libGLU.so,
47and libglut.so.
48
49+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
50
51Q: ./configure simply does not work?
52
53You may have the wrong versions of automake and autoconf.
54Create your own configure script calling
55 ./rebuild
56and execute the newly created script
57 ./configure
58
59+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
60
61Q: Why is there no sound?
62
63If the game starts up prompting "Using GLUT only", the game has been
64compiled without sound. Make sure to have SDL, SDL-devel, SDL_mixer
65installed and compile the sources again:
66 ./configure
67 make
68 make install
69
70+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
71
72Q: How to compile on MacOSX?
73
74In the Makefile, set LIBS to
75-framework OpenGL -framework SDL -framework GLUT -framework Foundation
76-lSDL_mixer -lSDLmain -framework QuickTime -framework CoreServices
77-framework AppKit
78
79Make sure that the library and header files can be found by configure.
80
81+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
82
83Q: Libraries are installed, but gcc (linker) does not find them?
84
85Try the command
86 g++ -g -O2 -lm -o gl-117 main.o gl.o model.o 3ds.o audio.o land.o \
87  glland.o aiobject.o effects.o roam.o net.o mathtab.o dirs.o \
88  objload.o pilots.o common.o object.o cockpit.o \
89  -lGL -lGLU -lglut -lSDL -lSDLmain -lSDL_mixer \
90  -lXmu -lXext -lXi -lXxf86vm
91
92+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
93
94Q: internal error, core dump, submit gcc bug report?
95
96Sorry, the cause is unknown. Just execute make again until everything is
97compiled and linked properly.
98
99
100+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
101S E C T I O N   2
102+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
103
104Q: How to alter resolution, color depth?
105
106As the resolution and color depth can not be changed in-game, please edit
107the (text) file
108 $HOME/.gl-117/conf (Unix)
109 GL-117_DIR\saves\conf (Windows)
110and set the corresponding values manually.
111
112+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
113
114Q: How to configure the input devices?
115
116Just edit the file
117 $HOME/.gl-117/conf.interface (Unix)
118 GL-117_DIR\saves\conf.interface (Windows)
119and adjust the settings.
120
121+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
122
123Q: The joystick rudder and throttle are swapped?
124
125The joystick axes identification depends on the driver (OS).
126Just edit the file conf.interface as described above.
127
128+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
129
130Q: Cannot open GLX?
131
132Try another bpp setting in the file conf (described above). (32, 16, 8)
133
134+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
135
136Q: Graphics do not initialize?
137
138This game needs properly installed versions of OpenGL, GLU, and GLUT!
139
140+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
141
142Q: Graphics too lame?
143
144Sorry, OpenGL is not supported by every graphics card.
145You will need at least an Nvidia TNT2 chipset to seriously play the game,
146as well as the appropriate drivers.
147The game has been tested in 800x600 mode on
148 AMD K2 500 AGP1x TNT, quality=0, view=50: FPS>30
149 Athlon 1400 GeForce2, quality=3, view=70: FPS>30
150 P4 2.4GHz GeForce4, quality=5, view=100: FPS>30
151