LBreakout2
a breakout-style arcade game for Linux
by Michael Speck
********************
I. Requirements
II. Installation
III. Documentation
IV. Troubleshooting
V. Resources
VI. Feedback
********************
********************
I. Requirements
********************
LBreakout runs in X and uses SDL (any version though >= 1.1.4
is recommended) and SDL_mixer (optional for sound). Both libraries
can be found at http://libsdl.org. The graphical stuff requires PNG
which is usually included to a distro. If not check out
http://www.libpng.org/pub/png/libpng.html.
********************
II. Installation
********************
Enter your favorite shell and type in the following stuff (in the
directory you extracted the LBreakout source)
> ./configure [--disable-sound] [--disable-install] [--enable-warp]
[--with-highscore-path=HPATH] [--with-doc-path=DPATH]
--disable-sound: no sound
--disable-install: no installation; play from source directory
--enable-warp: nescessary for non-Unices to use relative
mouse motion for inverting or modify mouse
speed
--with-highscore-path: write global highscore chart lbreakout.hscr
to the specified directory
DEFAULT: /var/lib/games
--with-doc-path: install documentation to $DPATH/lbreakout2
DEFAULT: /usr/doc
> make
> su (become root)
> make install (if install wasn't disabled)
> exit (become user again)
> lbreakout2 (run game)
!!! NOTE: Since 2.1.2 the config directory is ~/.lgames instead
of ~/.lbreakout2. If you created levelsets with a previous version
you'll have to copy these sets from ~/.lbreakout2/levels to
~/.lgames/lbreakout2-levels !!!
The directory ~/.lbreakout2 is obsolete and may be deleted.
********************
III. Documentation
********************
If you have any questions about options, game play or editor
please check the documentation and see if you
can find an answer there. I will not respond to any eMails concerning
questions easily answered by the manual (/usr/doc/lbreakout2).
However, if you have any other problems or suggestions or you found a
bug please contact me: kulkanie@gmx.net
********************
IV. Troubleshooting
********************
The solution for relative mouse motion (nescessary when inverting or
slowing down mouse by motion modifier) works fine for Linux and
Win32 but fails for other non-Unices. Current solution is to warp the
mouse (by using configure option --enable-warp). Unfortunately, this
will handicap events when trying to fire weapon or release balls AND
move the paddle at the same time. This means it may happen that a weapon
is not fired or doesn't stop fire, balls keep being attached and so
on...
---
Disabling sound while playing seems to result in loosing various
sound channels when some sounds were actually mixed.
---
For my system 1.4 is 1.399978 instad of 1.4 so wrong score
is added in the end. Sorry, not my fault. If anyone got a cool idea
to tell gcc this obvious point let me know.
---
Someone reported that he had problems with PNG (configure script
didn't find it) if it was installed to /usr/local/lib.
Setting a link in /usr/lib fixes this.
---
If you have SDL_mixer installed but configure tells you that it can't
find it, remember that you have to install the development package
for compiling!
---
If you can't compile because LBreakout2' timestamps are slightly in
the future run 'touchall' (found in the configure directory).
---
If 'fullscreen' just adds a black frame around the game but does
not change the solution make sure that you have 640x480 available
as resolution in your Xconfig.
---
If the SDL sound seems to be out of sync set
SDL_AUDIODRIVER to dma (export SDL_AUDIODRIVER=dma).
********************
V. Resources
********************
Some graphics and sounds has been taken and modified from other
non-copyrighted resources:
Backgrounds: http://www.grsites.com/textures
Sounds: "Web Clip Empire 50.000", NovaMedia Verlag, Germany
Thanks to all of these guys for there free stuff!
********************
VI. Feedback
********************
LGames URL: http://www.lgames.org
e-Mail: kulkanie@gmx.net