================================================================================
================================================================================
              TEMPER 0.80 for Dingoo Native v1.0 20/07/2013

                            Port by Slaanesh
                        Original code by Exophase
================================================================================
================================================================================


--------------------------------------------------------------------------------
What is Temper?
--------------------------------------------------------------------------------
Temper is an emulator for the NEC PC Engine and SuperGrafx.

Temper can emulator HuCard, CD, SCD, Arcade CD and SuperGrafx games.
95% games will run at fullspeed without frame drop at 44100hz sound.


--------------------------------------------------------------------------------
History :
--------------------------------------------------------------------------------
v1.0 : 20/07/2013

Initial Release.
It's a closed source release.
Thanks to Exophase for trusting me with the source code.

Many hours of hard work went into this to get it polished and fullspeed.
I hope you enjoy as much as I did. PC Engine is my favourite retro console.


--------------------------------------------------------------------------------
Controls:
--------------------------------------------------------------------------------

PC Engine		Dingoo
---------		------
D-Pad			D-Pad
Select			Select
Run			Start
Button I		A
Button II		B
Button I rapidfire	X
Button II rapidfire	Y
Menu			L or R Shoulder


--------------------------------------------------------------------------------
Game Selection:
--------------------------------------------------------------------------------
Use the Dingoo's d-pad to select a game.
A to select a game or enter a directoy.
B to go back a directory level.
X to exit selector and back to menu.

--------------------------------------------------------------------------------
Menu:
--------------------------------------------------------------------------------
The menu has the following options:

    Change options
    Configure pad
    Netplay
    Load State
    Save State
    Save snapshot
    Load new game
    Restart game
    Swap CD
    Return to game
    Exit Temper


The 'Change options' has the following options:
----------------------------------------------
Clock Speed
    Set the Dingoo's clock speed from 336Mhz to 432Mhz.
    Default is 408Mhz.
    Most games will run fullspeed at a much lower setting.
Volume
    Set the volume. Maximum is 30.
    This is the only way to adjust volume at the moment.
    Default is 16.
Patch Idle loops
    Detect and patch CPU idle loops to help speed up emulation.
    Default is Yes.
Snapshot in saves
    Create a snapshot with the savestate.
    Default is Yes.
BZ2 compressed saves
    Compress saves. Big savings here.
    Default is Yes.
Use six button pad
    Six button pad for SFII only.
    Default is No.
CD-ROM system
    Select the appropriate system ROM.
    Default is V3.
    You must have the appropriate syscard ROM in the syscards directory!
    syscard[123].bin for version 1 through 3 (syscard3.bin works for Arcade Card too)
Per-game BRAM saves
    BRAM is the PC Engine's saves. It has only one but Temper can
    allocate one per games.
    Default is No.
Scale screen widrh
    Stretch the screen for 256 pixel width games. Hires games unaffected.
    Default is No.


Others:
------
'Configure pad' allows you to customize the controls.
This is really untested as the default controls is what I used all the time.

'Netplay' is unsupported.

'Save State' takes a few seconds. Please be patient. Loading one back is fast.



--------------------------------------------------------------------------------
Games:
--------------------------------------------------------------------------------
HuCard games should have the .pce (or .pce.bz2 suffix for compressed games).

For CD games, you will need .cue and .iso/.ogg files for data and sound tracks respectively.
You will also need a syscard[123].bin ROM in the syscards directory.
There isn't however a lot of error checking so the file format is picky.
The .cue file is simply a TXT file that tells Temper what each file is. Edit it with a text editor like vim.

For example, the first 3 file entries of Castlevania would look something like this.

    FILE "DraculaX_t1.ogg" OGG
      TRACK 01 AUDIO
        INDEX 01 00:00:00
    FILE "DraculaX_t2.iso" BINARY
      TRACK 02 MODE1/2048
        PREGAP 00:03:00
        INDEX 01 00:00:00
    FILE "DraculaX_t3.ogg" OGG
      TRACK 03 AUDIO
        PREGAP 00:02:00
        INDEX 01 00:00:00

Note that the FILE entries are just the filename with no paths.
You may need to edit existing .cue files as some converters include paths.
All files should be contained within the directory where the .cue is found.

--------------------------------------------------------------------------------
Troubleshooting:
--------------------------------------------------------------------------------
If you have an SD card inserted in the slot, a log file will automatically be created called temper.txt.
If you find any issues please have a look here first, especially for CD games.
Also if you want to report a problem, the relevant log file entries for the game you are running will
probably be useful, so include that with any problem reports.
