Commit 505cbabe authored by Christian Steigies's avatar Christian Steigies

Imported Upstream version 1.0.3

parents
AUTHORS.txt for Circus Linux!
by Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/circus-linux/
Version 1.0.3
April 28, 2001
CREDITS
-------
Game Software: Bill Kendrick, <bill@newbreedsoftware.com>
http://www.newbreedsoftware.com/bill/
Original Concept: "Circus Atari," (c) 1980 Atari, Inc.
Graphics: Bill Kendrick, using The GIMP
http://www.gimp.org/
Game background: Manu Parssinen <man@sci.fi>
http://www.sci.fi/~man
Title background: Circus Arts Home Page
Peter Bendall <bendall@altavista.net>
http://members.aol.com/CircusGrp/parlari.html
Sound Effects: Royalty free sound effects CDROMs and FTP sites.
Music: "Klovnin Arki," "Hi Score," "Best-In" and "Finally"
by Jarkko Rotsten <roz@sci.fi>
http://www.sci.fi/~roz/
Miscellaneous: See CHANGES.txt for bug fixers, etc.
CHANGES.txt for Circus Linux!
by Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/circus-linux/
1.0.3 - April 28, 2001
----------------------
* Added support for real Atari 2600 paddles (connected to the PC joystick
port). Atari paddles are calibrated slightly different, and are also
reversed. Thanks to Mark Kim for building the paddle adapter for me!
1.0.2 - August 5, 2000
----------------------
* You can now press the [G] key to toggle mouse-grabbing (that is,
whether the mouse pointer is trapped within the window or not).
Clement Bourdarias <cbour@cybercable.tm.fr>
* Audio is now opened at 44.1Khz (so it sounds better, and works better
under MacOS).
Darrell Walisser <dwaliss1@purdue.edu>
* MacOS version of 1.0.1 released (with above fix).
Darrell Walisser <dwaliss1@purdue.edu>
1.0.1 - June 4, 2000
--------------------
* Makefile.am tweaks: Documents now installed into "$(prefix)/share/doc/",
instead of "/usr/doc/"; Data file permissions set to 755. (Still no good!)
Martin Willemoes Hansen <mwh@stampede.org>
1.0.0 - May 29, 2000
--------------------
* Makefile.am and data/Makefile.am tweaks.
Vikram Subramanian <upender@vsnl.com>
* Game prefers 16-bit depth, but prefers native depth over
emulated 16-bit!
Mattias Engdegard <f91-men@nada.kth.se>
* Data file permissions set nicely for .tar.gz releases.
* Version number upgraded to '1.0.0' since everything seems pretty
much done!
* Added copying (GPL) information. Run "circuslinux --copying"
* Usage display reorganized. (Run "circuslinux --usage")
0.0.8 - May 25, 2000
--------------------
* Added keyboard control. (LEFT/RIGHT and RETURN/ALT/SHIFT)
* Made mouse pointer invisible.
* Divided FAQ into "General Problems," and "Linux Problems."
* Divided Mouse, Joystick and Keyboard control descriptions in README.txt.
* Now calls "SDL_SetColorKey()" before "SDL_DisplayFormat()," so sprites
shouldn't appear broken at 8-bit color depth.
* Tweaked analog joystick code
* Initial Windows 32-bit release. Makefile-win32 created with help from
Brian Hayward <hayward@slothmud.org>
0.0.7 - May 23, 2000
--------------------
* Title music has finally been made! (It's called "Finally" :) )
0.0.6 - May 22, 2000
--------------------
* Updated configure.in to contain correct version number.
* Updated INSTALL.txt.
0.0.5 - May 21, 2000
--------------------
* Now uses SDL's accellerated RLE blitting for colorkeyed images.
* Added more information to the game description in README.txt.
* Used "pngcrush" to get better compression in the graphics files.
* A little piece of "W" was visible next to "X"'s in the text font. Fixed.
* Music now gets paused, not stoped and restarted from the beginning, when
you pause the game.
* Added "./configure" script.
Vikram Subramanian <upender@vsnl.com>
0.0.4 - April 11, 2000
----------------------
Bugs Fixed
----------
* --fullscreen switch was broken (used "if" instead of "else if"). Fixed.
Torbjorn Andersson <torbjorn@dev.eurotime.se>
* Joystick support is now a compile-time option (since the stable version
of SDL doesn't have joystick code yet... oops!) Compile with "JOY=NO"
to disable joystick support.
Christian T. Steigies <cts@debian.org>
* Joystick setup code checked Axes a 2nd time instead of buttons. Fixed.
0.0.3 - April 9, 2000
----------------------
New Features Added
------------------
* Clowns now launch a little higher (more realistically) from the
teeter-totter.
* Added note to use "--usage" for command-line options in "--help" display.
* Added more variations of command line options:
"--nosound" and "-q" are the same as "--disable-sound",
"-l" is the same as "--low", and
"-f" is the same as "--fullscreen".
* Added game over screen music.
Jarkko Rotsten <roz@sci.fi>
* Changed "sdlconfig --libs" to "sdlconfig --static-libs" in Makefile,
so that it will build better under m68k Linux.
Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de>
* Tweaked arguments used in Mix_OpenAudio() call to make audio sound
better on slower machines.
* BMP files converted to PNG files to save space. SDL_Image library
now required.
* Joystick code added (analog and digital supported).
* Added an FAQ document.
0.0.2 - March 12, 2000
----------------------
Planned Features Implemented
----------------------------
* High scores screen now has music.
* Seal circus act completed.
* Bear circus act added.
New Features Added
------------------
* [TAB], [SPACE] or [P] now pauses/unpauses during the game.
* Added an 32x32 XPM icon file: "circuslinux-icon.xpm"
Christian T. Steigies <cts@debian.org>
* Balloons flash colors when high score is acheived.
* Command-line options described in usage display.
* "--low" option added. Less flashy display will be used so there's
a better chance it can run on low-end hardware.
* If you don't fill out your initials when you get a high score, it
will try to figure it out based on your real name or username (Linux).
* Text bitmap looks nicer.
Bugs Fixed
----------
* "nosound" target builds correctly now.
Chris Ellec <info@linuxforkids.com>
* Balloons now reappear at the right time (on the flying clown's way
down) in clear-all mode.
0.0.1 - February 9, 2000
------------------------
Planned Features Implemented
----------------------------
* "Clear all" mode.
* High scores.
* Options file.
New Features Added
------------------
* [ESCAPE] on title screen can be used to exit.
* Added percentage bar while loading.
Bugs Fixed
----------
* Flying-clown / balloon collision detection.
* Teeter-totter bounciness made even.
* Crashes when volumes set when audio not available fixed.
Gabriel Rosa <mr_gab@hotmail.com>
INITIAL RELEASE 0.0.0 - February 5, 2000
----------------------------------------
* Initial alpha release.
This diff is collapsed.
FAQ.txt for Circus Linux!
by Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/circus-linux/
Version 1.0.3
April 28, 2001
GENERAL PROBLEMS:
-----------------------------------------------------------------------------
PROBLEM:
I want the mouse pointer to stay within the window.
SOLUTION:
During the game, press the [G] key to turn mouse-grabbing on.
(You can press it again to turn it off.)
----------------------------------------------------------------------------
PROBLEM:
My mouse is gone!
CAUSE:
"Mouse-grabbing" is on. The mouse pointer (which, by the way, is
invisible) cannot be removed from the window.
SOLUTION:
Press the [G] key to turn mouse-grabbing back off.
(You can press it again to turn it back on, if you like).
----------------------------------------------------------------------------
PROBLEM:
When using a joystick, the teeter-totter jumps between the left, middle and
right positions, instead of moving smoothly.
CAUSE:
This is because your joystick is digital. It only has a left, right and
middle position.
SOLUTION:
Use the "--digital" option when you start the program.
-----------------------------------------------------------------------------
PROBLEM:
When using real Atari paddles, the teeter-totter moves the opposite direction
and doesn't go all the way to the edges.
CAUSE:
Atari 2600 paddles are calibrated differently.
SOLUTION:
Use the "--paddle" option when you start th eprogram.
-----------------------------------------------------------------------------
PROBLEM:
The game is very slow on my computer.
CAUSE:
Your computer is probably not very fast, or you have a slow video card.
SOLUTION:
Use the "--low" option when you start the program.
SOLUTION:
Try using a different color depth. 16bpp is better (faster) than 24bpp,
for example.
-----------------------------------------------------------------------------
PROBLEM:
There's no sound or music.
CAUSE:
Your computer doesn't have a sound card, or it's misconfigured.
SOLUTION:
Get a sound card and make sure it's configured.
CAUSE:
Another program is using your sound device.
SOLUTION:
Quit that program.
CAUSE:
You ran the program with the "--disable-sound" or "--nosound" or "-q" option.
SOLUTION:
Quit Circus Linux! and start it again without any sound-disabling option.
CAUSE:
The volume settings are set to "off".
SOLUTION:
Click the "SFX" and "MUSIC" options on Circus Linux!'s title screen until
the volume of the sound effects and music are at suitable volumes.
CAUSE:
The game is paused.
SOLUTION:
Press the [SPACE] key.
-----------------------------------------------------------------------------
PROBLEM:
The clowns bounce back down when they hit balloons.
CAUSE:
The "Bouncy Balloons" game option is set.
SOLUTION:
Click the "Bouncy Balloons" option on the title screen so that the
option is no longer set.
-----------------------------------------------------------------------------
WINDOWS PROBLEMS:
-----------------------------------------------------------------------------
PROBLEM:
My joystick doesn't work!
CAUSE:
The current version of Circus Linux! uses a stable version of the
Simple DirectMedia Layer library. That version does not include
joystick support.
SOLUTION:
Wait for a newer release of Circus Linux!, after SDL jumps to 1.2.x.
(See: http://www.devolution.com/~slouken/SDL/ )
-----------------------------------------------------------------------------
LINUX PROBLEMS:
-----------------------------------------------------------------------------
PROBLEM:
My joystick doesn't work!
CAUSE:
Is your joystick plugged-in and configured to work right?
SOLUTION:
Make sure your joystick is plugged in and configured (see your Linux
distribution's manual).
CAUSE:
Circus Linux! wasn't compiled to play with a joystick.
SOLUTION:
Run "make distclean" and then make sure you use the
"--enable-joystick" option when you run "./configure" (see INSTALL.txt)
-----------------------------------------------------------------------------
PROBLEM:
When compiling, there's an error about SDL_JOYAXISMOTION not being defined.
CAUSE:
The version of SDL you have does not support joysticks.
SOLUTION:
Run "make distclean" and then make sure you _don't_ use the
"--enable-joystick" option when you run "./configure" (see INSTALL.txt)
SOLUTION:
Get SDL version 1.1.2 or higher, which supports joystick.
-----------------------------------------------------------------------------
If you have a question you think would be suitable for this FAQ, please
e-mail me:
bill@newbreedsoftware.com
Thank you!
INSTALL.txt for Circus Linux!
by Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/circus-linux/
Version 1.0.3
April 28, 2001
GENERAL REQUIREMENTS
--------------------
CONTROLS
--------
The game is controlled using a mouse. It can be played with either
a mouse, a joystick, a real Atari paddle, or the keyboard.
(Note: Joystick code requires version 1.1.x of Simple DirectMedia Layer
or higher. The Windows release uses 1.0.8, which does not include
joystick support. See FAQ.txt.)
REQUIREMENTS TO COMPILE
-----------------------
SDL
---
"Circus Linux!" was programed using the "Simple Direct Media" layer
libraries by Sam Lantinga. This means that the game can
theoretically run under any environment that the SDL libraries support.
(As of this program's release, this includes: Linux X11/DGA,
Win32 WinDIB/DirectX, BeOS BWindow, and Solaris X11, as well
as unofficually supported: Linux SVGAlib, IRIX 6.x X11,
FreeBSD 3.x X11, and MacOS.)
The Simple DirectMedia Layer is required to compile this game.
You can download the SDL libraries from:
http://www.devolution.com/~slouken/SDL/
SDL_image
---------
SDL_image is also required. (It is used to load the PNG format images
that come with Circus Linux!)
You can download SDL_image from:
http://www.devolution.com/~slouken/SDL/projects/SDL_image/
SDL_mixer
---------
Sound and music are available, but are not required (see below).
You will need the "SDL_mixer" library compiled and installed if
you want sound.
You can download SDL_mixer from:
http://www.devolution.com/~slouken/SDL/projects/SDL_mixer/
INSTALLING UNDER LINUX/UNIX
---------------------------
First, run the configuration script, "./configure":
./configure
To compile circuslinux with joystick support (required for playing the game
with either a PC joystick, or an Atari paddle connected to the PC's
joystick port), make sure you have a version of SDL that supports joystick
(1.1.2 and above). When you run "./configure," do it like this:
./configure --enable-joystick
Then compile the game:
make
Then (as super-user, if you're installing the game in the default
location of "/usr/") install the game:
make install
This should put circuslinux and the data files in the right place.
The README.txt and friends go into /usr/doc/circuslinux-<version>/
In case you want to remove(!) circuslinux do a
make uninstall
from the source directory.
This should remove all circuslinux files safely.
CROSS-COMPILING FOR WINDOWS UNDER LINUX
---------------------------------------
Get an EGCS-based compiler for Win32, like the one available here:
http://www.devolution.com/~slouken/SDL/Xmingw32/
Follow the instructions in SDL's "README.Win32" file regarding compiling
and installing the Windows32 cross-compiled version of SDL.
Also, cross-compile SDL_mixer, SDL_image and the png libraries,
following similar instructions to above. (Note: Set the "--prefix"
value when running "./configure" for these two libraries.)
Finally, in the circuslinux directory, run:
make -f Makefile-win32
This will build the ".exe" and copy the SDL ".dll" files into the
directory.
URL
---
The "png" and "z" libraries are available at:
http://www.libpng.org/pub/png/pngcode.html
ICON FILE
---------
A 32x32, XPM-format icon file (using the standard 23-color "cmap.xpm"
color palette) is available if you wish to use an icon for this game.
The file is "circuslinux-icon.xpm", and installed in Circus Linux!'s
"data/images/" directory.
The End!
# Makefile-win32 for circuslinux
# by Bill Kendrick
# bill@newbreedsoftware.com
# http://www.newbreedsoftware.com/
# Version 1.0.0
# May 25, 2000 - May 29, 2000
VERSION=1.0.0
CFLAGS=-Wall -O2 $(SDL_CFLAGS) -DDATA_PREFIX=\"data/\" \
-DWIN32 -DJOY_NO $(SDL_CFLAGS) $(XTRA_CFLAGS) -DVERSION=\"$(VERSION)\"
# Other definitions:
SDL_LIBS=-L/usr/local/cross-tools/i386-mingw32/lib -lmingw32 \
-lSDLmain -lSDL -lSDLmain -luser32 -lgdi32 -lwinmm -ldxguid \
-mwindows
XTRA_LIBS=-L/usr/local/cross-tools/i386-mingw32/lib/ \
-lSDL_image -lpng -lz -lSDL_mixer
SDL_CFLAGS=-I/usr/local/cross-tools/i386-mingw32/include \
-I/usr/local/cross-tools/i386-mingw32/include/SDL
# Make commands:
all: circuslinux.exe
cp /usr/local/cross-tools/i386-mingw32/lib/SDL*.dll .
chmod 644 SDL*.dll
clean:
-rm circuslinux.exe
-rm *.o
-rm SDL*.dll
# Main executable:
circuslinux.exe: circuslinux.o
$(CC) $(CFLAGS) circuslinux.o -o circuslinux.exe \
$(XTRA_LIBS) $(SDL_LIBS)
# Main object:
circuslinux.o: circuslinux.c
# Makefile.am for circuslinux
# by S.Vikram
# upender@vsnl.com
# May 28, 2000
# Original Makefile
# by Bill Kendrick
# bill@newbreedsoftware.com
# http://www.newbreedsoftware.com/
# December 11, 1999 - April 11, 2000
PACKAGE = @PACKAGE@
VERSION = @VERSION@
# User-definable stuff:
CC=@CC@
DATA_PREFIX=$(pkgdatadir)/data/
JOY=@JOY@
TARGET_DEF=@TARGET_DEF@
CFLAGS = @CFLAGS@ -Wall -O2 -DDATA_PREFIX=\"$(DATA_PREFIX)\" \
-D$(TARGET_DEF) -DJOY_$(JOY)
LIBS = @LIBS@
bin_PROGRAMS = circuslinux
circuslinux_SOURCES = circuslinux.c
circuslinux_CFLAGS = CFLAGS
circuslinux_LIBS = LIBS
docdir = $(prefix)/share/doc/$(PACKAGE)-$(VERSION)
doc_DATA = AUTHORS.txt \
COPYING.txt \
INSTALL.txt \
CHANGES.txt \
FAQ.txt \
README.txt \
README-SDL.txt \
TODO.txt
# Other files to be in source build
EXTRA_DIST = autogen.sh \
AUTHORS.txt \
COPYING.txt \
INSTALL.txt \
CHANGES.txt \
FAQ.txt \
README.txt \
Makefile-win32 \
README-SDL.txt \
TODO.txt
SUBDIRS = data
uninstall-local:
rm -rf $(prefix)/share/doc/$(PACKAGE)-$(VERSION)
# Main executable:
#circuslinux: circuslinux.o
# $(CC) circuslinux.o $(LIBS) -o circuslinux
#circuslinux.o: circuslinux.c
# $(CC) -c circuslinux.c $(CFLAGS)
clean:
-rm -f circuslinux
-rm -f *.o *~
This diff is collapsed.
Please distribute this file with the SDL runtime environment:
The Simple DirectMedia Layer (SDL for short) is a cross-platfrom library
designed to make it easy to write multi-media software, such as games and
emulators.
The Simple DirectMedia Layer library source code is available from:
http://www.devolution.com/~slouken/SDL/
This library is distributed under the terms of the GNU LGPL license:
http://www.gnu.org/copyleft/lesser.html
This diff is collapsed.
TODO.txt for Circus Linux!
by Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/circus-linux/
Version 1.0.3
April 28, 2001
TODO
----
When using paddles, let player two use the 2nd paddle controller.