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

	PituKa V0.8
	First Public Release

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


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

 The Amstrad CPC range was an 8bit microcomputer family released from June 21st, 1984. Those 
computers were sold as a complete bundle including a colour or green 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 United Kingdom, France, Spain and Germany 
(where the CPC was sold under Schneider brand). Amstrad plc. entered in the computing market with 
the CPC series. They even dominated the European market with their PC clones PC1512 and 1640. The 
CPC sales units are estimated in about 2 millions.


We are in front of a machine that was exploded till the limit with its Z80A 4MHz processor and its
4 channels sound that made a perfect atmosphere in the games, a very advanced graphical chip for 
its time: different graphical modes, graphical resolutions changes while running. Very few machines
had been as exploded as CPC was, it survived for more than 10 years and its a beloved and 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 the GP32 handheld could run and 
this was my obsession during the last full time month I spent coding PituKa. There is a lot of time
spent in it, because the objective was to obtain a compatibility of the 100% 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 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 remakes releases, you only have to llok at the NES remakes released 
for the GBA.

PituKa Features:

- Image CPC disk 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\ and copy your DSK files to the new directory.
 - Happy emulation ;D
 

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

 There are 3 Pad modes:

	MODE 1 JOYSTICK: 
		
		GP32		:	AMSTRAD
		-------------------------------------
		<>^v (PAD)	:	DIRECTIONS 		(POR AHORA SON CURSORES)
		(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 CARACTER
		(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)	:	CURSORS
		(A)		:	[A]
		(B)		:	SPACE
		(SELECT)	:	H
		(START)		:	PAUSE EMULATION / MENU 	
		(L)		: 	-NONE-
		(R)		:	GO TO FIRST PAD-MODE



	MENU:
		A 	- OK
		START/B	- RETURN TO EMULATION (IN MAIN MENU)
		B	- BACK
		
		
	
 Play a Game:
==============
	
	Pituka emulates a real CPC, what means you have to do the same as in the real CPC to run 
	a game.

	To play a game, you must insert a disk image and type two basic commands, let's see it:

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

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

		- Now you have to know what 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. 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].

		- It's tips time. if you only tyte the name and then you place the cursor at the 
			beginnign of the name. then press CTRL with the A button and without 
			depress it, press SELECT.

		- For some games you don't need to type the  RUN" command, they are loading with 
			the |CPM command They are easily detectable. If when you execute the CAT 
			command, you get an error (ignore, Cancel) then theese games are protected,
			but don't care 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].



 TODO:
=======
0.	Apply ASM/ARM9 Reesy z80 Core
1. 	Better PSG CPC emulation (digital effects)
2. 	Snapshots Support
3. 	Dsk Save.
4. 	Easy Load DSK
5. 	CDT Support
6. 	ZIP Support
7. 	Better Vkeyboard
8. 	Quick Commands?
9.	English or Spanish Vkeyboard


See you
	D_Skywalk

http://gp32.dantoine.com

PituKa its based on Caprice 4.1.0

Introduction By: Vnomis & D_Skywalk

English Translation: Vnomis.

Beta-Testers: Vnomis & Pelayo.

Thanks to:  	Rlyeh, kotah
		Damizean, Pelayo, vnomis, 
		K-teto, Fagotero, Hexdump,
		to my mumm, girlfried and his poof bear: PituKa
		& the pp of #gp32dev :D

Email: dantoine@gmail.com