Damian Brasher - dbrasher@interlinux.co.uk
Home Page http://interlinux.co.uk/wordpress/?p=371
Interlinux Ltd
http://www.interlinux.co.uk
http://www.diaser.org.uk
The game of over 2K lines of C is in part based on Sam Latinga’s Aliens 1.0.2, part of the SDL library projects released under GPLv2. http://www.libsdl.org/projects/aliens/
DSI – invading aliens game
==========================
April 2010
Introduction
============
Simple invading aliens game originally hand coded in in C using a text editor in 2001 with SDL, SDL image and mixer.
You must stop those aliens from landing on you! <space> Fire (unlimited shots available) <right arrow> Move right
<left arrow> Move left <escape> Quit the game.
Features
========
Smooth scrolling
High scores
5 Levels
Simple controls
Sound effects
Strategic game play
Windows, Linux and Mac OSX
Customisable graphics out of the box, no re-compile required
Customisable simple definition file for coders
Tiny foot print
Linux Desktop Integration
Music selection
Configuration file
Usage
=====
Usage:
DSI [Option...]
-? show this message
-v print version number
-f fullscreen
-m m builtin MOD music
w builtin WAV music
n no music
-t <file> play music file
.config/DSI/dsirc
=================
[dsi-prefs]
#fullscreen: 0=windowed, 1=fullscreen, default[windowed]
fullscreen=0
#track-mode: m=builtin MOD, w=builtin WAV, n=no soundtrack, default[WAV]
track-mode=w
#track-file: soundtrack to play, over-rides track-mode. Playback of
#flac, midi, mp3, ogg and wave depend on your SDL_mixer capabilities.
#Filename can be in the current dir, relative to the current dir,
#or fully qualified. '~' is Not expanded!, default is none.
#examples:
# - track-file=/home/dave/Steel_Monkey.ogg
# - track-file=../Steel_Monkey.ogg
track-file=
Obtaining
=========
Download the Linux rpm / deb, windows bin or source tarball of DSI from SourceForge
(Source also available from SF SVN)
Linux rpm and deb
=================
32 bit
------
rpm - as root use ]#rpm -ivh dsi-1.0.3.1-1.i386.rpm
deb - use $sudo dpkg -i dsi_1.0.3.1-2_i386.deb
64 bit
------
dependencies if not automatic
-----------------------------
for rpm ]#yum install SDL SDL_mixer SDL_image
for Ubuntu UNR I used $sudo apt-get install libsdl-image1.2 libsdl-mixer1.2 libmikmod2 libsmpeg0
Linux Source
============
To build from source you will need at least:
SDL, SDL mixer, SDL image, SDL devel, SDL mixer devel, SDL image devel as well
gcc, make and C libraries.
*If you are using the downloaded source tarball dsi-0.9.$.tar.gz as root run
tar -xzvf dsi-0.9.3.tar.gz
cd dsi-0.9.3
./configure
make install
to remove run
make uninstall
From your Games start menu click the blue space ship icon or as a user run
DSI from the command line.
*If you are using the source from SVN to compile:
svn co https://dspaceinvadors.svn.sourceforge.net/svnroot/dspaceinvadors
dspaceinvadors
run ./autogen.sh first
Windows binary
==============
Simply download and install DSIwinSetup.msi
Linux binary
============
You will also need to have the SDL, SDL mixer and SDL image runtime libraries
installed on on you system.
cd to the directory that you saved the download to, possibly your home
directory. Use the commands: tar -xzvf dsi-lin-bin.tar.gz
cd dsi-lin
./DSI or DSI_64 (64bit Binary tested on Ubuntu)
Mac OSX
=======
This is the initial debug build; you may need to copy the contents of Frameworks to Library/Frameworks/… I don't have a new enough Mac to go any further at the moment.
Create your own graphics
========================
If you do want to create new gifs, perhaps of "that bloke from the pub last
night" or a surreal advertising world full of feathered wurbles, then this is
how - tested with the Gimp.
All graphics (.gif) are stored in ../data directory. The size of the gif does
not matter apart from the background. But keep it sensible otherwise the game
play will break.
The gif needs to be created like this:
1) Create an empty indexed gif with 0 layers of any size, but to make the
game play work a similar size to the original.
2) Create a new layer from visible, an alpha transparency layer.
3) Draw into this new layer and replace with the existing gif name.
4) Repeat for all graphics.
5) Optional: Send a zipped or tarred data folder to me and I'll make it
available on-line.
Please note the site www.diaser.org.uk somewhere to help support the game.
Sound
=====
The two files are called music.it and music.wav.
defs.h
======
For coders a fast way to customise some of the the game play parameters without looking at the main code base.
Aside from fun the game is released to support the geo-data redundancy archive
system DIASER.
The game, over 2K lines of C is based on Sam Latinga’s Aliens 1.0.2, about 600
lines of C, part of the SDL library projects released under GPLv2.
http://www.libsdl.org/projects/aliens/
Dedicated to Granny Maria Jacob who passed away in 2001.
/*************************************************************************\
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
\*************************************************************************/
licence in this directory COPYING
Source is available from
http://dspaceinvadors.svn.sourceforge.net/viewvc/dspaceinvadors/
Thanks also, for bug fixes and patches, to a number of volunteers.
Thanks to David Jensen.
Thanks to Martin Gieseking, Osnabrück University - for assistance refining
dsi.spec and guidance whilst learning how to become a Fedora maintainer.
