1. Joe Polak
  2. pongathon

Overview

HTTPS SSH
Pongathon is Copyright 2014 Josef J. Polak III.
Pongathon is distributed under the terms of the GNU General Public Licence.

You can find Pongathon on Bitbucket:
	
	http://bitbucket.org/JoePolak/pongathon

ABOUT PONGATHON:

Pongathon is yet another clone of Pong written using pygame. It requires Python
2.6 and Pygame 1.9

The current stable version of Pongathon is 1.4.1. At the time of this writing,
it is not known to have any bugs. Although the major version number is 1, that
does not mean Pongathon is "complete" or "thoroughly tested."

Features planned for future releases include, but are not limited to:

* Different resolutions
* An options screen
* Four player games, including doubles and four sided singles.
* Multiplayer over network
* New/Better graphics
* Mouse control
* Convienient packaging for users on all platforms who do not already have
Pygame and Python installed.

WHAT'S NEW IN 1.4.0?

* The playing area has changed shape. It is now horizontal, and has the same
proportions as a regulation table tennis table. Updates to both themes have
been made to reflect this, as well as the keyboard controls.
* New sound effects have been added to both themes. They play when different
players score.
* A fullscreen mode has been added. Press F to switch to fullscreen, and W
to switch back to windowed. Windowed is the default. You can only change
between windowed and fullscreen modes at the intro screen.


PLAYING:

Pongathon can be run by typing "python pongathon.py" in a terminal/CMD window
within Pongathon's directory.

Pongathon currently has two game types: Single Player and Hot Seat Multiplayer.
In Single Player, you face off against a computer opponent. In Hot Seat, you
play against another human being at the same keyboard. Regardless of what game
type you are playing the objective is the same: Be the first to score 10 points.
Points are scored when the ball hits an edge of the screen where a paddle is
present. You should use your paddle to hit the ball back towards your opponent.
Player 1 is the player on the bottom half of the screen, player 2 is on top.

Keyboard Controls:

Move Player 1's Paddle: Up or Down arrow
Move Player 2's Paddle: A or Z (Hot Seat Only)
Pause Game: P
Default Theme: T
Arcade Theme: Y
Full Screen: F
Windowed: W
Quit: Escape

INSTALLING:

Pongathon itself needs no installation, as it is a set of python modules. If 
you already have Python and Pygame, then you should already be able to play it.

Python is already installed on all Apple computers running Mac OS X. It is also
included with most Linux distributions. Most Windows systems do not have Python
unless some other application that is already installed uses it. If you need 
Python, or need to update it, you can find it here: 
	
	http://www.python.org/download/

Pygame can be found here: 

	http://www.pygame.org/download.shtml

Pongathon was originally developed on Linux using Python 2.6.2 and 
Pygame 1.9.0. I have tested it in this environment. It has also been tested 
on  Windows 7 using the 32-bit version of Python 2.6.5 and Pygame 1.9.1. 
In 2014, Pongathon was tested using Python 2.7.6 from MacPorts on Mac OS X
Mountain Lion and was found to be working also.

CREDITS:

Pongathon was created by Joe Polak
 
Generous amounts of code were borrowed from:
	jbrown's Writing Games Tutorial 
		(http://ezide.com/games/writing-games.html)
	Pygame tutorials from www.learningpython.com
	The Line By Line Chimp Tutorial by Pete Shinners (included in Pygame)
	Making games with Pygame tutorial (included in Pygame)

Pongathon uses samples from Freesound:
	By acclivity (http://www.freesound.org/usersViewSingle.php?id=37876):
		BeepFalling.wav (id=25884)
		BeepRising.wav (id=25885)
		Beep1000.wav (id=25882)
		BeepUp.wav (id=25886)
		BeepDown.wav (id=25883)
	By juskiddink (http://www.freesound.org/usersViewSingle.php?id=649468):
		Ping_Pong2.wav (id=64922)
 
Samples from Freesound are made available under the Creative Commons Sampling 
Plus 1.0 Licence.