
2xZdoom v2.2.0 GP2X Port by Adventus

Overview:

	This is a port of Zdoom for GP2X, it allows you to play a plethora of games
	based on the doom engine. These include: Doom 1, Doom 2, Hexen, Heretic, Strife...
	and many more. Please refer to the "zdoom.txt" for any non GP2X specific 
	stuff (ie Commandline arguments).
			
Installation:

	1. Copy contents of .zip file to somewhere on your SD card. This should
	   result in the following structure:
		
			./save/					(FOLDER)
			./wad/					(FOLDER)
			./wad/zdoom.pk3
			./zdoom.ini
			./2xZdoom220
			./2xZdoom220.gpe
			./2xZdoom220.txt
			
	2. Put desired IWAD into the wad folder. You can find demo IWADs here:
	
	DOOM1:		http://www.gamers.org/pub/idgames/idstuff/doom/doom19s.zip
	HEXEN:		http://www.gamers.org/pub/idgames/idstuff/hexen/hexndemo.zip
	HERETIC:	http://www.gamers.org/pub/idgames/idstuff/heretic/htic_v12.zip
	
	3. Run 2xZdoom.gpe. By default it will search the wad directory in this 
	   order:
	
			./doom2f.wad			(Doom French/FreeDoom)
			./doom2.wad				(Doom 2)
			./plutonia.wad			(Final Doom: Plutonia Experiment)
			./tnt.wad				(Final Doom: TNT - Evilution)
			./doomu.wad				(Doom 1 linux hacked)
			./doom.wad				(Doom 1)
			./doom1.wad				(Doom 1 Demo)
			./heretic.wad			(Heretic)
			./heretic1.wad			(Heretic Demo)
			./hexen.wad				(Hexen)
			./hexdd.wad				(Hexen Demo)
			./strife1.wad			(Strife)
			./strife0.wad			(Strife Demo)
	
	   It will launch the first one it encounters as the IWAD (the game data).
	   To include a PWAD (a mod) you must specify it using the "-wad <file>" cmd 
	   argument. Please refer to Zdoom.txt for more information.
	
Additional Command Line Arguments:

-timidity <folder>	<folder> specifies the folder in which timidity is installed 
					Default: 'mnt/sd/timidity'

-stdlog 			Enables stdout and stderr logging.
					Default: No logging	

-frontend <file> 	At 2xZdoom exit <file> will be executed. Useful for frontends.
					Default: executes gp2xmenu
	
Controls:

- I choose to directly map each GP2X Button to a single Keyboard key. This allows
you to use the zdoom.ini file to assign what ever you want to each button. 

+===============+===========================+===========================+
|Button			|Direct Keyboard map 		|Default zdoom.ini mapping	|
+===============+===========================+===========================+
|Joystick Up	|ArrowUp					|Move Forward				|
|Joystick Down	|ArrowDown					|Move Backward				|
|Joystick Left	|ArrowLeft					|Rotate Left				|
|Joystick Right	|ArrowRight					|Rotate Right				|
|Button Y		|'y'						|Jump						|
|Button B		|'b'						|Attack						|
|Button X		|'x'						|Crouch						|
|Button A		|'a'						|Use (Open Doors, etc)		|
|Button L		|'l'						|Strafe Left				|
|Button R		|'r'						|Strafe Right				|
|Volume +		|'='						|Next Inventory Item		|
|Volume - 		|'-'						|Prev Inventory Item		|
|Start			|Escape						|Open Menu					|
|Select			|Return						|Next Weapon/Use Menu		|
|Stick Click	|'p'						|							|
+===============+===========================+===========================+

Changelog Beta 1.2
- Fixed the flickering walls bugs.
- Music now loops fine.
- Handles 'cant find timidity' gracefully. Just outputs no audio instead of 
  crashing.
- Added cmd argument "-timidity <folder>" so you can specify the location
  of timidity if it differs from 'mnt/sd/timidity'
- Added cmd argument "-frontend <file>". After 2xZdoom exits, <file> will 
  be executed.
- Added cmd argument "-stdlog", to enable stdout and stderr logging.
- Added Stick click as mappable button.

Changelog Beta 1.1
- Rewrote midi mixer to use libTimidity.
- Wrote SDL Audio renderer.
- Fixed menu input. Dont need to use Select & Start.

Changelog Beta 1.
- Fixed many memory alignment issues.
- Fixed game Saves.
- Removed Fmod and GTK dependency.
- Initial Input system.

Credits:

Adventus, 		Ported Zdoom to the GP2X. Made above changes.
				contact: lachlan_ts@hotmail.com

id Software /  	These are the people who developed Doom and later released
John           	the source code for the Linux port. Without them, there
Carmack        	would be no ZDoom. I have also used some of the functions
				from their Quake2 game DLL source.

Bernd          	Packaged up id's Linux code for the initial source release.
Kreimeier

Raven          	Portions of Heretic and Hexen were used in ZDoom.
Software

Chi Hoang      	Responsible in one way or another for BOOM. It provided a
Team TNT       	significant codebase for ZDoom. Information about BOOM can
				be found at the Team TNT website:
				http://www.teamtnt.com/boompubl/ixboom.htm

Lee Killough   	For all his brilliant work on both BOOM and later MBF.
				Portions of MBF were used in ZDoom, primarily to fix BOOM
				bugs.

Yoghurt        	Creator of the Cajun Bot. http://www.doomworld.com/doombot/

Sebastien      	Created qmus2mid which I used to determine the structure of
Bacquet        	DOOM's MUS lumps so that the game would have music.

Andy Bay       	Original input code is from his (discontinued) ATB Doom port.

Peterri        	Original sound code and some assembly is from his
Kangaslampi    	(discontineud) NTDOOM port. He was also the person primarily
				responsible for writing the MIDAS Digital Audio System
				1.1.2, which is used for all sound effects and MOD music.
				It is copyright 1996,1997 Housemarque Inc. It can be found
				at http://www.s2.org/midas/.

Glenn "Gaffer" 	Developed the Prometheus Truecolor library. OpenPTC was used
Fiedler        	for the latest version of ZDoom, and older versions of PTC
				were used for older versions of ZDoom. Its homepage is at
				http://www.gaffer.org/ptc/.

Markus         	Wrote the miniLZO library, which ZDoom uses for data
F.X.J.         	compression. Its webpage is at
Oberhummer     	http://wildsau.idv.uni-linz.ac.at/mfx/lzo.html

Greg Lewis     	Released his DeHackEd source, without which adding
				DeHackEd support would have been much harder.