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

	PituKa v0.8
	Dingoo (Pre)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 it's 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 Dingoo (linux) system based on my last work Pituka for GamePark32.

My hope is that you enjoy this emulator and people who don't 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.


Dingoo Features:
- Full Amstrad CPC Emulation, no FRAMESKIP need it! :D
- Support ZIP files.
- Keyboard on Screen.


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

Pituka can be installed in any directory under the "local" directory of your SD card.

A typical installation may go in /local/pituka or /local/games/pituka of your SD card.

		SD-CARD
		|
                |-----> LOCAL ---> PITUKA (EMULATOR BINARY)
                                  |
		                  --------> DISKS (ROM FILES HERE)
                                  |
                                  --------> SAVES (SAVESTATES HERE)

 DINGUX SELECTOR EXAMPLE:
--------------------------

    MenuItem PITUKA
    {
    	Icon = "res/game1.png"
    	Name = "Pituka"
    	Executable = "../pituka.dge"
    	WorkDir = "/usr/local/games/pituka/DISKS"
    	Selector = yes
    }
    

 - Happy emulation ;D
 

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

 There are 2 modes besides the KEYBOARD that is detected at the beginning:

	MODE 1 JOYSTICK: 
		
		MOTE		:	AMSTRAD
		-------------------------------------
		<>^v (PAD)	:	JOY DIRECTIONS 
		(A)		:	[FIRE]
		(B)		:	[FIRE2]
		(X)		:	[SPACE]
		(Y)		:	[A]
		(RL)		:	[1]
		(RR)		:	[2]
		(START)		:	[RETURN]
		(SELECT)	:	KEYBOARD ON SCREEN

		(SELECT)+(START):	EXIT EMULATION

	MODE KEYBOARD:
		
		MOTE		:	AMSTRAD
		-------------------------------------
		<>^v (PAD)	:	MOVE CURSOR
		(2)		:	PRESS KEY
		(RL)		:	[SHIFT]
		(RR)		:	[BKSPC]
		(START)		:	---
		(SELECT)	:	RETURN TO JOY MODE

		(SELECT)+(START):	EXIT EMULATION


 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.

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

		- Select a DSK/ZIP and the emulation starts.

		- Now you have to know what files the disc image has. It's easy, go to the virtual 
			keyboard with (SELECT) and type [C][A][T] , then press (START) 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 
			[RETURN].

		- 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 [INTRO].
                        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 [RETURN].
			You can get the [|] symbol pressing the buttons (RL) and then vkey to the RIGHT of [P].



 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://www.cantrell.org.uk/mirrors/ftp.nvg.ntnu.no/pub/cpc/games/ (European CPC Server)
http://cpcgamereviews.com/a/index.html (CPC Reviews, Coments, Screens...)


 TODO:
=======
1.      Bind Keys.
2.      Snapshot support.
3. 	DSK Save.
4. 	CDT Support.


See you
	D_Skywalk

http://david.dantoine.org

Wiituka and Pituka are based on Caprice 4.1.0

Menu-Artwork by D_Skywalk.

Thanks to:  	Booboo & barosl
                Paco Menendez
		to my mumm, girlfried and her poof bear: PituKa
		& the pp of #dingoo-a320 on freenode.net :D

Email: dantoine@gmail.com
