************************************

	PituKa V0.8
	Special Public Release

************************************


 Introduction:
===============

 The Amstrad CPC range was an 8bit microcomputer family released on June 21st, 1984. These computers 
were sold as a complete bundle including a colour or green screen monitor and a main storage system. 
CPC was an acronym of Colour Personal Computer. The first digit was a code for the main storage system; 
'4' denoted a tape deck and '6' a 3-inch floppy disk drive. The Amstrad CPC range included the following 
models:

-	Amstrad CPC 464, 64Kb RAM
-	Amstrad CPC 472, 64Kb RAM (only sold in Spain)
-	Amstrad CPC 664, 64Kb RAM
-	Amstrad CPC 6128, 128Kb RAM

 The CPC series was very popular in Europe, mainly in the United Kingdom, France, Spain and Germany (where 
the CPC was sold under the Schneider brand). Amstrad plc. entered the computing market with the CPC series. 
They even dominated the European market with their PC clones the PC1512 and 1640. Sales of CPC units are 
estimated at about 2 million.

You are looking at a machine thats hardware was packed with its Z80A 4MHz processor, 4 channels of sound that 
made for perfect atmospheres in games, and a very advanced graphical chip for its time: different graphical 
modes and graphical resolutions changes whilst running. Very few machines have been as big as the CPC was, 
it survived for more than 10 years and its a beloved and well known machine by two generations of computing 
fans that remember it.


 About Pituka:
===============

PituKa is an Amstrad CPC6128 emulator for the Gamepark GP32 handheld system.

The aim of this project was to obtain the most perfect emulation that the GP32 handheld could handle and 
this was my obsession during the whole of last month of which I spent coding PituKa. A lot of time was spent 
on it, because the objective was to obtain full compatibility for 95% (*) of the games and to reduce the specs 
required to run the emulator from a 500MHz desktop PC system to a handheld system running at 156MHz. The only 
flaw now is that the digital sound is not emulated completely. Everything else is emulated, raster, effects, 
4 musical channels and so much fun ;)

My hope is that you enjoy this emulator and people who dont know this marvellous machine can enjoy it, even 
today there are new remake releases, you only have to look at the NES remakes released for the GBA.

(*) Tested with a REAL CPC next to a GP32, I dont use a emulator to compare them...

Features in Version 1.0 (y probably my final version):
- ChatBoard Support. (Driver: 21 Aug 2004 - Mirko Roller)
- Autorun Code from Explorer.
- Code now Public.
- Individual configuration keys by program (ROM/DSK/SNA).
- SNA Support from Explorer.
- Many fixes that dont improvement the emulation in fact but make more stable.

PituKa Special Release Features (0.8E):
- Better Explorer DSK (USE LEFT< >RIGHT DIRECTIONS).
- SNA Support.
- SaveState Support.
- Better Joy Emulations (Bug fixes).
- Better load CFG file (Bug fixes).
- Directory creation automaticaly.
- Some emulation improvements.

PituKa Features:
- CPC disk Image Support (DSK).
- Color/Green Monitor.
- Multichannel Sound and real time channel mix.
- Real CRTC Emulation, raster efects, vsync, hsync...
- Keyboard / Joy Emulation
- Three Pad modes configuration.
- Save configurations of Vkeyboard and general options.
- Led Loading Disk.



 INSTALATION:
==============

 - COPY PituKa_XX.fxe to GP:\GPMM.

 - Create new directory for your ROMS, GP:\GPMM\AMSTRAD\DISKS and copy your DSK files to the new directory.
	Anyway, PituKa creates his need it directory automaticaly:

		GPMM
		|
		------> AMSTRAD <------	(CFG FILE IS SAVED HERE)
			|
			--------> DISKS (ROM FILES HERE)
			|
			--------> SNAPS (SAVESTATES HERE)
			|	    |
			|	    ------> CFG (GAMES KEYS CONFIGURATIONS)
			|
			--------> SCREENS (YOUR SCREENSHOTS)

 - Happy emulation ;D
 

 CONTROLS:
===========

 There are 3 Pad modes besides the CHATBOARD that is detected at the beginning:

	MODE 1 JOYSTICK: 
		
		GP32		:	AMSTRAD
		-------------------------------------
		<>^v (PAD)	:	DIRECTIONS 
		(A)		:	[FIRE]
		(B)		:	SPACE
		(SELECT)	:	-NONE- 
		(START)		:	PAUSE EMULATION / MENU 	
		(L)		: 	MAKE A SCREENSHOT (1 to 255)
		(R)		:	GO TO NEXT PAD-MODE



	MODO 2 Virtual-KEYBOARD:
		
		GP32		:	AMSTRAD
		-------------------------------------
		<>^v (PAD)	:	CHANGE KEY
		(A)		:	ENTER CHARACTER
		(B)		:	REMAP CURRENT KEY
		(SELECT)	:	KeyP-ENTER (A special Enter Key, see more info below)
		(START)		:	CHANGE PAD BUTTON TO REMAP
		(L)		: 	SHIFT
		(R)		:	GO TO NEXT PAD-MODE



	MODO 3 USER: (DEFAULT CFG)
		
		GP32		:	AMSTRAD
		-------------------------------------
		<>^v (PAD)	:	CURSOR KEYS
		(A)		:	[A]
		(B)		:	SPACE
		(SELECT)	:	H
		(START)		:	PAUSE EMULATION / MENU 	
		(L)		: 	-NONE-
		(R)		:	GO TO FIRST PAD-MODE


	CHATBOARD:
		GP32		:	AMSTRAD
		-------------------------------------
		[A-Z] 		:	[A-Z]
		[<- ]		: 	[DEL]
		[1-0]		:	[1-0] 
		[SPACE]		:	[SPACE]

		TECLAS ESPECIALES:
		[<]		: 	[BLOCK. UPCASE]
		[>]		:	[RETURN]
		[SMS]		:	[RE-DETECT CHATBOARD]

          Problems using CHATBOARD:
          -------------------------
	   These problems arent fault of the emulator but also the support that we have
	   of the CHATBOARD is simple at the moment (although perfectly stable),
	   the problems detected are:

            PROBLEM : The emulator detects my CHATBOARD that is perfectly connected
		      but into the emulation dont have a response.
	    SOLUTION: Press SMS to detect it.

	    PROBLEM : When I am a while without using my CHATBOARD the keys dont respond!
	    SOLUTION: Press again SMS to re-detect it.


	    PROBLEM : I push a key but dont repeating why?
	    SOLUTION: Because it is a problem of the driver that dont have support for 
		      Key-Repeating, sorry :(




	MENU:
		A 	- OK

		START	- RETURN TO EMULATION (IN MAIN MENU)

		B	- BACK
			- SELECT A ROM WITHOUT ACTIVATE AUTORUN CODE.


 Play a Game using Autorun:
============================
	Pituka emulates a real CPC even in code of the autorun i wat to be accurate, to
	load a disk and activate the AUTORUN from start menu, follow this steps:
	- INSERT DISK -> [A]
	- Select a Rom that you want load with [A] (with DSK extension of course).
	- Now appear the file list that you can load, normally you may follow this preference order:
	  BAS -> BIN -> . (WITHOUT EXTENSION) -> |CPM
	- If you dont see any BAS file, you may search a BIN file and continues... if you dont see any type of file
	  when you may selecct |CPM to load the game.
	- When you have selected the file to load your game, you returned to start menu and just left reset CPC
	  if you have got any game later. Press [START] to return to emulation.

	- Some times when you load a game and selects the autorun file, when you return to emulation
	  the autorun string dont appear, to appear change your PAD-MODE using [R], i cant fix this error
	  because I dont have much time... sorry :(

		
	
 Play a Game without Autorun:
==============================
	
	Pituka emulates a real CPC, which means you have to do the same as you would with a real CPC to run 
	a game. Con la suerte que en esta nueva version los poseedores de un CHATBOARD lo tienen mas comodo ;)

	To play a game, you must insert a disk image and type two basic commands, let see what they are:

		- To insert a disc image. press [START] and choose INSERT DISK in the main menu.

		- Select a DSK and you'll be back in the main menu. Press [START] to return to the
		 	emulation.

		- Now you have to know what files the disc image has. It's easy, go to the virtual 
			keyboard with [R] and type [C][A][T] , then press SELECT to execute that
			command.

		- Now, you'll see a files list. The important filetypes are BIN, BAS or without 
			extension, Ex: ABADIA.BAS, GRYZOR.BIN, TETRIS.

		- Now type [R][U][N]["] to execute a file. There is a tip to do this faster, look at 				                        the bottom.You can get the ["] symbol pressing the buttons [L] and the [2] vkey.

		- Now type the name(you can include the extension if you want yo be sure what file are 
			you running), for example: [G][R][Y][Z][O][R][.][B][I][N], and then press 
			[SELECT].

		- Tips time: type the name of the file and then place the cursor at the beginning of the 
                        name. then press CTRL with the A button and without depress it, press SELECT.
                        This will then put [R][U][N]["] in front of the file name and launch the game.

		- For some games you don't need to type the  RUN" command, they load with the |CPM command 
                        They are easily detectable. If when you execute the CAT command, you get an error 
                        (ignore, Cancel) then these games are protected, but don't worry about it, they 
                        are even easier to execute, you only must type:
			[|][C][P][M] and the Press [SELECT].
			You can get the [|] symbol pressing the buttons [L] and then vkey to the RIGHT of [P].



 How is save the configuration keys.
================================================
 The philosophy that follow the code of "Unique Game Save Keys" is:
	- Once diffent config for DSK/SNA file.
	- The config is save and is load every time when you change your ROM.
	- If the ROM dont have any config file this is create a new file with the actual
	  config and it is load again.
	

 I would like to have in this 1.0
==================================
 I spend some months trying change the sound code to have better support but I cant find
 the correct mode, or the sound gliches or directly the emulation turns slooow... anyway
 i want public the code for the scene adds his optimizations ;)

 I dont think that we have better sound (and more quickly) even you dont change the Z80 core,
 if you want avance the PituKa proyect you can start with this... in the forums of GP32spain.com
 the people is coment that we can answer to Reesy that if he want apply his core to Pituka (he
 send me his code but i dont know to apply them any is encourage to coment him?
 
 Some easy Tasks to implement:
	- In explorer: order ROMS by name.
	- In explorer: directory support.
	- Key repeating in vkeyboard.


 Some Recomendated Games:
==========================


SPORTS
-----------
Fernando Martin Basket Master
Match Day 2
Tenis 3D
Colossus Chess
Cyrus II Chess
Summer Games
Winter Games
Emlyn Hughes
Tie Break
Perico Delgado



ADVENTURES
---------------
La Abadia del Crimen (Best ever 8bits game Based on "Name of the Rose" - ONLY SPANISH)
Head Over Heels
Batman 3D (John Ritman)
Rambo 3
Dustin
The Great Escape
Knight Lore
Pijamarama
Myth: History Making
3 weeks in paradise
Last Ninja 2
Livingstone Supongo
Sir Fred
Inside Outing 
Fairlight
Navy moves
Shadow of the Beast


ARCADE
---------
Gryzor (Aka Contra)
Turrican II
Renegade I y II
Super Sprint
Zona 0
Year Die Kung Fu
Kungfu Master
Ikari Warrirors
The Way of the Exploding Fist
Commando
Shinobi
Strider 1 y 2
Psycho Pig Uxb
Oh! Mummy
Gunfright
Tempest
Barbarian I
Prohibition


STRATEGY - PUZZLES
-------------------
Lords of Midnight
North and South
Elite
Sentinel
Archon 2
Deflektor
Puzznic
Night Shift
High Steel
Spindizzy
Boulder Dash
Spherical
Solomons Key


PLATFORMS
------------------
Rick Dangerous
Manic Miner
Abu Simbel
Vampire: Phantomas 2
Prince of Persia
Prehistorik II
Antiriad
Jet Set Willy 
Rodland Series
Bomb jack
Bubble Bobble
Rainbow Islands


SHOOTERS
--------------
Defend or Die (Aka defender)
Nemesis
R-type
Zynaps
Psyborg
1942
Afterburner
Thanatos
Empire Strikes Back
Army Moves
virus
Space Harrier 2
Silk Worm
Monty Phyton's Fliying Circus


RPGs
--------
Bloodwych
Bard's Tale
Heroes of the Lance
Hero Quest
Space Crusader
Rogue


MISC.
-------
Teenage queen
Sherman M4
Fighter Bomber
Total Eclipse
Castle Master
Dark Side



 Where get downloads CPC games and more info:
==============================================

http://andercheran.aiind.upv.es/ftp/pub/cpc/ftp.nvg.unit.no/games/ (European CPC Server)
http://www.livepublishing.co.uk/retro/amstradtopten.shtml (Amstrad CPC TOP TEN)
http://cpcgamereviews.com/a/index.html (CPC Reviews, Coments, Screens...)


 TODO:
=======
0.	Apply ASM/ARM9 Reesy z80 Core
1. 	Better PSG CPC emulation (digital effects)
2. 	Dsk Save.
3. 	ZIP Support
4. 	CDT Support

See you
	D_Skywalk

http://gp32.dantoine.org

PituKa its based on Caprice 4.1.0

Introduction By: Vnomis & D_Skywalk.

English Translation: D_Skywalk (sorry shakespeare LOL).

Beta-Testers: WonderBoy & Antiriad.

Menu-Artwork by Antiriad & D_Skywalk.

Thanks to:  	Rlyeh, kotah, Franxis, Una-i
		Damizean, Pelayo, vnomis, Wonder_Boy
		K-teto, Fagotero, Hexdump, A600
		Azareus (friend), finty 
		to all the people that have send his donation to the proyect
		to my mumm, girlfried and her poof bear: PituKa
		& the pp of #gp32dev on efnet & Irc-Hispano :D

Email: dantoine@gmail.com