Version: V1.89 Beta (23/01/99)

Welcome to Hu6280, The PC-Engine Emulator for Dos/Windows95.

Homepage: http://www.hu6280.com



Instructions for use:

run the hu6280.exe file, and it will bring up a list of .PCE files for you to
choose from (please make sure you have some .PCE files in the same dir as the
hu6280.exe file). Thats it... Enjoy.

or..

hu6280 jamanoid.pce -v2 -mouse	-<< runs jamanoid on a 320x240 screen, with mouse control!
hu6280 rtype.pce -v0		-<< runs rtype on a 640x400 screen
hu6280 rtype.pce -v1		-<< runs rtype on a mode13h 320x200 screen (only for lamers)
hu6280 rtype.pce -v2		-<< runs rtype on a modex 320x240 screen

use -mouse for pc-engine mouse emulation
use -sidewinder for sidewinder pad support
use -gpp for gamepadpro pad support
use -skip1 for frameskip1
use -skip2 for frameskip2
use -us to force usa rom decryption
use -sync to force framesync on

-s0 = no sound
-s1 = soundblaster
-s2 = awe32
-s3 = pro audio spectrum
-s4 = ultrasound max
-s5 = ultrasound
-s6 = windows sound system
-s7 = ensoniq soundscape
-freq22050 = 22050 sample rate
-freq11025 = 11025 sample rate
-bigbuf = increase sound buffer size (this tends to delay audio slightly)
-notiq = use this option to disable timer irqs if a game doesn`t seem to work or if game glitches (eg paranoia, superstarsoldier)



Donations:

If you have any of the following items to donate, please email jamsponge@hotmail.com
and we can trade addresses... :)

1) HU7 Devkit!
2) Official Pc-Engine documentation
3) Any Hucards (USA or JAP)
4) Any Pc-Engine CD-Roms
5) Any Pc-Engine related hardware
6) Any Pc-Engine related magazines etc.
7) Any Pc-Engine backup devices
8) $$$ ;)-~




Requirements:-

Pentium Processor (166mhz+ recommended), (233mhz+ recommended if using sound)
Some Ram (16mb+ recommended)
a decent video card
a decent sound card
if your card can`t handle 640x400x8 then use the -v1 command line option for a 320x200 screen instead.
DOS or Windows 95
A Keyboard
Some Hucards to play (Jamanoid,Galaga88,Tigerheli & Gunhed recommended)


Features:-

full hu6280 emulation
full palette emulation
full char+char mask emulation
full sprite+masking emulation (inc priorities)
full pad1 emulation
pc-engine mouse emulation
hires screen support !!
lores screen support !! (+modex!)
optional amazing gui for loading roms ;)
runs most Hucards
screenshot feature
US enrypted roms now supported...
Load and Save STATE feature...
Microsoft SideWinder(TM) JoyPad support.
AUDIO!
Avenue 6 button pad emulation for SF2 ! WOW! KEWL!
supports zipped .pce files :)


Keys are:

'ESC' - Quit! (not that you`ll want to...)

'F1' - toggle frame sync on/off (Default = OFF)
'F2' - frame rate display on/off (Default = OFF)
'F10' - Save screenshot (.lbm file)

'CURSORS' = up,down,left,right
'LSHIFT'  = pc-e joypad button 1
'LCTRL'   = pc-e joypad button 2
'RSHIFT'  = SELECT
'RETURN'  = RUN


in six button pad mode (use -sixbut or just run sf2!) the following keys are mapped:

'1' = pc-e joypad button 1
'2' = pc-e joypad button 2
'3' = pc-e joypad button 3
'Q' = pc-e joypad button 4
'W' = pc-e joypad button 5
'E' = pc-e joypad button 6

Using a sidewinder on SF2 is soooooo coooll!!!


'L' = Load game state (if rom is rtype.pce, we load rtype.sav)
'S' = Save game state (if rom is rtype.pce, we save rtype.sav)

if in lores mode try 'PGUP' and 'PGDN' to centre screen vertically.













please send bug reports (or cool tech infos) to:

jamsponge@hotmail.com



Thanks going out to :

jens C H - yeah, vpce is nice... - THANKS FOR THE HELP DUDE!
BT Garner - thanx dude
JL_Picard - nicey nice mr nice! ;)
david shadoff - heh, TGSIM! kewl!!!!
kad77 - cheers mate
videoman - cheers mate
Zophar - (thanx for the spreading!)
Lance-MC - (thanx for the spreading!)
Emanuel Schleussinger (never spoken to you, but you helped in docs I read)
David Michiel - ok, I admit it, magic engine rocks the world!
Paul Clifford (never spoken to you, but you helped in docs I read)
Bero
- K - cheers for the donation man :)
Marius Fodor  - thanx for the sidewinder/gpp reading code ;)
the guy who coded 'SEAL' audio library!!! :)

and all the other pc-engine hackers out there...



--------------------- HISTORY ---------------------

Changes from V0.0002c to V0.0002d:

removed sprite to sprite masking code, now draw them in reverse order for speed...
fixed sprite bug that caused rtype to crash
fixed sprite masking bugs (gradius,jj&jeff etc.)

---------------------------------------------------

Changes from V0.0002d to V0.0002e:

fixed some cycle timings in cpucore
optimized character draw engine / masking code
added a 5 minute GUI... hahaha

---------------------------------------------------

Changes from V0.0002e to V0.0002f: 19/5/98

fixed yet another masking bug (must have cropped in when i tided up the code ;)
modded internal emulation screen resulting in a speed hit
tied up sprite clipping to new internal emulation screen size :)
added something nice to gui ;) see if you can spot it ... :)

---------------------------------------------------

Changes from V0.0002f to V0.00031: 20/5/98

modded memory fetches to use mmu_ptrs instead of indexing via mmu_regs
put in a framesync on/off toggle (Use F1) - default , ON
changed screen dump for speed
seperated irq code from line update :)
tided up sprite masking code again (neat again)

---------------------------------------------------

Changes from V0.00031 to V0.00032: 21/5/98

Changed compiler options on cpu core C file ... :)
Added FPS debug stats stuff in release version for Zophar :)
updated GUI, *PHEW* no more white!

---------------------------------------------------

Changes from V0.00032 to V0.0003f: 21/5/98

Messed with palette emulation (nothing to do with sprite bug)
Fixed HUGE bug in sprite emulation (see chan+chan, xevious etc.)
Fixed Fps counter removal (when switching it off)

---------------------------------------------------

Changes from V0.0003f to V0.00044: 23/5/98

fixed bug that stopped galaga working.
went back to old gui (users prefered it).
now updating sprite sat-b table on line 220! this fixed sprite lagging on 99% of games!!
coded 2 versions of gfx emulation routines, 1 for masking, 1 for nonmasking, now I
cleverly work out which lines of the screen require a mask, much faster gfx emulation).
now detect if no pce files are present and exit.

---------------------------------------------------

Changes from V0.00044 to V0.00047: 23/5/98

minor changes to source
Added screenshot feature (F10 key), saves shot0000.lbm,shot0001.lbm etc.

---------------------------------------------------

Changes from V0.00047 to V0.0004f: 23/5/98

optimized gfx char-redraw loops (nice speed hit on some games)
took advantage of xscroll==0 :) faster on some games
changed VSync to OFF as default... (not enuf people reading the docs)
removed some more debugging code

---------------------------------------------------

Changes from V0.0004f to V0.00053 23/5/98

fixed sprite masking on dwduck (check out the magnifying glass section)!
moved sat-b sprite transfer to line 239, seems nicer

---------------------------------------------------

Changes from V0.00053 to V0.00060 25/5/98

Fixed games fading out problems (lots of games)
added command line ROM option (e.g. try hu6280 galaga.pce, to avoid the gui)

---------------------------------------------------

Changes from V0.00060 to V0.00061 26/5/98

now alpha sorting filenames in gui :)
sped up gfx emulation
removed some debugging shit that was slowing this sucker down

---------------------------------------------------

Changes from V0.00061 to V0.00070 27/5/98

removed some bollox from the source...
Mr Kipling joins the project! - codes up x86 version of drawscanline! lovely
speed hit for you!! :) Mr Kipling does make exceedingly nice ASM!

---------------------------------------------------

Changes from V0.00070 to V0.00081 28/5/98

temporarily removed fps counter for techy reasons, beyond most of u
changed internal screen emulation/dump! emualtion is 50% faster!! (dump is now
inline SVGA hits!!), a JamSponge and Mr Kipling special :)

----------------------------------------------------

Changes from V0.00081 to V0.00081 TESTER 29/5/98

twatted some internal emulation shit bigstyle!!
PLEASE REPORT DIFFERENCES BETWEEN THIS VERSION AND NORMAL V0.00081 :) PLEASE!!
2 differences I've noticed are: cybercore works, king of casino works... :)

----------------------------------------------------

Changes from V0.00081 to V0.00090 30/5/98

JamSponge gets busy with some serious debugging!
Improved irq emulation (cybercore now works)
now detecting shady start addresses and doing a bit swizzle for US roms...
(RTYPE US now works)...
modded some techy internal emulation stuff that most of u would probably not
have a clue about ;)

----------------------------------------------------

Changes from V0.00090 to V0.00091 30/5/98

JamSponge gets busy with some serious debugging!
Fixed sprites bug on marchen-maze
Buryem now works

----------------------------------------------------

Changes from V0.00091 to V0.00092 30/5/98

Added Load and Save STATE feature... :)

----------------------------------------------------

Changes from V0.00092 to V0.00093 2/6/98

After a mamoth debugging session, fixed bug in DMA length :) (volfield now works)
re-instated fps on F2
modded plenty of crap in the source.

----------------------------------------------------

Changes from V0.00093 to V0.00094 2/6/98

Fixed sprite masking bug on third level of RTYPE (bastards! they are turning
the screen off AND setting char over sprites priority!!) - this also sped
emulation up a little bit.

saved 128k, now freeing up gui buffers... :)

Fixed screenshot feature (now outputs correct size bitmap image)

removed the remainder of debugging rubbish still left in my code.

----------------------------------------------------

Changes from V0.00094 to V0.00095 6/6/98

Fixed bug in VRAM emulation, now seems to run P47 and YOBRO ok.
save game format has changed (NOT backwards compatible)

----------------------------------------------------

Changes from V0.00095 to V0.00097 7/6/98

tweaked vram emulation (now correct i think)
save games are 64k smaller... :)
turrican titlepage now works
no gfx corruption on impossamole
ninja gaiden seems to work

----------------------------------------------------

Changes from V0.00097 to V0.00099 8/6/98

added lo-res mode! (just for those people who keep on asking for it!)

(example) just type:

hu6280 jj&jeff.pce -v1

ok, it uses a 320x200 screen mode so not all of the screen is visible! you can
however use the PageUp and PageDown keys to centre the screen to your taste
though. If anyone wants to supply me with some info (or even some example
code) on setting up a 320x240 screen, i`d appreciate it. But until then you`ll
just have to live with the fact that the lores mode is crap.

** NOTE **

if you had trouble running this emualtor before V0.00099, it was probably
because your graphics card was too lame to display a 640x400x8 screen. now
however, you can use the lo-res mode... as far as i`m aware no graphics card
will refuse to run in 320x200x8 mode... :)


oh yeah, another thing while I`m here... I`m serious about adding CD-Rom,
Super Graphix and sound support, so HURRY UP AND SEND ME SOME ORIGINAL
PC-ENGINE CDROMS ETC. I have a grand total of ZERO CD-ROMS so far!! (although
one or two have been kindly offered...thankyou guys, i`ll email my
snail mail address to you). It would be kind of handy to have a super graphix
with a couple of super graphix games too, so I can start the SG support, so
anyone who wants to donate one just get in touch.


Also, why not send me some feedback for a change? I`m willing to get this
emulator perfect, but I can`t do it on my own! I need bug reports! I need more
tech info (if you have some) - I need more hucards! and more than anything I'd
really love to have a pc-engine development kit, then I could really get this
emulator perfect.

----------------------------------------------------

Changes from V0.00099 to V1.0 Beta 10/6/98

added -v2 command line option (320x240 modex screen!)

Mr Kipling has promised to port the hu6280 emulation to asm , so , lookout for
a major speedup coming soon... ;)

----------------------------------------------------

Changes from V1.0 Beta to V1.01a Beta 13/6/98

Fixed bug in cpu/irq emulation... now casino,toiletkids,darius and ordyne work!
Please report any other games that have started to work!!!

----------------------------------------------------

Changes from V1.01a Beta to V1.02 Beta 13/6/98

Added sidewinder joypad support

----------------------------------------------------

Changes from V1.02 Beta to V1.04 Beta 14/6/98

Added frameskip for shit pc's
Added gamepadpro support (please tell me if it works, i don`t have a gamepadpro)
Added some proper options to the command line:

"-v1"			- use 320x200x8 mode13h mode
"-v2"			- use 320x240x8 modex mode
"-sidewinder"		- use sidewinder
"-gpp"			- use gamepad pro
"-skip1"		- frameskip=1
"-skip2"		- frameskip=2
"-sync"			- vsync on
"us"			- force usa decryption

Time for a Visual Basic frontend eh?

----------------------------------------------------

Changes from V1.04 Beta to V1.05 Beta 20/6/98

fixed burning angels gfx corruption bug (this game doesn`t seem to even run in magic engine)

----------------------------------------------------

Changes from V1.05 Beta to V1.07 Beta 21/6/98

Fixed a bug in irq emulation!
Fixed AIRZONK locking up problem
dinosaur egg now works
alot of games glitch less now :)

----------------------------------------------------

Changes from V1.07 Beta to V1.50 Beta 27/6/98

added sound support!!!!!
updated savegame stuff to support sound

added the following command line options:
-s0 = no sound
-s1 = soundblaster
-s2 = awe32
-s3 = pro audio spectrum
-s4 = ultrasound max
-s5 = ultrasound
-s6 = windows sound system
-s7 = ensoniq soundscape
-freq44100 = 44100 sample rate
-freq22050 = 22050 sample rate
-freq11025 = 11025 sample rate

if no -s option is supplied you will be asked...
if no -freq option is supplied, emu will use best sample rate possible on your card
added shitty scan of pc-engine to front... :) nice one Frink!

----------------------------------------------------

Changes from V1.50 Beta to V1.60 Beta 30/6/98

Added rom banking code, and as a result Street Fighter II Championship Edition
now runs ok!

Sped up sound emulation ALOT (well, on my machine anyways!)

----------------------------------------------------

Changes from V1.60 Beta to V1.61 Beta 30/6/98

Fixed foolish bug that stopped 90% of games working... :)
thanks to all the people who mailed me about it !!

----------------------------------------------------

Changes from V1.61 Beta to V1.63 Beta 3/7/98

Added Stereo sound if your soundcard supports it
Added -bigbuf for bigger audio buffer, beware tho, it tends to delay the audio
Fixed bug in sound shit, sound should now sound ALOT better...

** Tip from Jamsponge **

If the audio sounds shit on your machine, chances are its because your machine
can`t keep the pace!! The best way to fix this is to use the -skip1 or -skip2
option and see if that helps!!! If this doesn`t help, try using the -bigbuf
option!!!!!!

When we finally convert this emulator to ASM, the audio will run properly
without the need for the -skip option, until then, you`ll just have to wear
it.

On my machine (p200 with a sb16), i have to use -skip2 to get perfect audio,
please let me know how the sound performs on your machine... :)

----------------------------------------------------

Changes from V1.63 Beta to V1.65 Beta 11/7/98

tweaked internal emulation core
removed -freq44100 option (its default)
added assembler ram access routines
tweaked audio code, should be more stable now

----------------------------------------------------

Changes from V1.65 Beta to V1.69 Beta 13/7/98

Fixed sidewinder joypad + audio problem (marius, mail me)
Jammie Dodger joins the hu6280 team and codes up a cool spr.asm routine! (nice speed increase)

----------------------------------------------------

Changes from V1.69 Beta to V1.72 Beta 18/7/98

Fixed TigerShark (sprites are now visible)
Fixed a general sprite bug (see ALICES DREAM etc.)

----------------------------------------------------

Changes from V1.72 Beta to V1.73 Beta 24/7/98

Fixed bug in joypad emulation
Fixed Alices Dream, doesn`t seem to crash anymore
improved audio mixing routines...

----------------------------------------------------

Changes from V1.73 Beta to V1.74 Beta 25/7/98

improved cpu emulation, now faster
improved irq emulation, now faster
fixed bug in screenshots filename shit

----------------------------------------------------

Changes from V1.75 Beta to V1.75 Beta 27/7/98

Found a big in timer irqs, added temporary -notiq command line option
to get toyshop boyz to work... :)

Please report if other games work better with this option...

mail addr: jamsponge@hotmail.com

** SEE NOTE AT TOP OF THIS DOC FOR SOMETHING NICE **
** also, Greetz to NIL_ , nice one buddy !

----------------------------------------------------

Changes from V1.75 Beta to V1.75GT Beta 1/8/98

Added -v3 option to emulate handheld pc-engine !

----------------------------------------------------

Changes from V1.76 Beta to V1.76 Beta 20/8/98


Added -sixbut command line option to emulate Avenue 6 button joypad.

Added auto 6 button pad emulation on Street Fighter II, and updated keyboard
controls to use 1,2,3,Q,W,E for the six buttons, also sorted sidewinder to
handle the six buttons! Playing Street Fighter II with a sidewinder is now
really rather sexy.


Investigated joypad stuff bigtime! I have now worked out how to emulate the
multitap, so expect full multitap (IE, multiplayer) emulation in the next
verion. Modded internal joypad hardware registers emulation, in preperation
for multi player support in V1.77!

Oh, and BTW , I`ve now got a supergrafx, and I`ve worked out quite alot of the
hardware already (I`m coding a supergrafx DEMO!!!), I currently own the
following supergrafx hucards: GRANDZORT,BATTLEACE & ALDYNES, If anyone has
1941 or Ghouls and Ghosts or anything else for supergrafx , PLEASE donate it
to me! I plan to emulate supergrafx fully!

Oh! and BTW, I`ve also added my little test proggy in replace of the old
cart.pce , Mucho nicer ;)

----------------------------------------------------

Changes from V1.76 Beta to V1.77 Beta 21/8/98

2 players now supported (only if you have a sidewinder!)

I`ll explain how it currently works:

if you type 'hu6280 sf2.pce -sidewinder' then player one uses the sidewinder
joypad, and player two uses the keys... This works on several 2 player games
i've tried... EG, MotoRoader, StreetFighter2, Bomberman etc.

It`s really cool having a two player battle on streetfighter! especially with
six button pads supported! Try it! It`s really a whole lot of fun!


joypad emulation is now done properly, so now multi player games work properly
in one and two player mode (in previous versions of hu6280, motoroader was
completely unplayable because the player controlled both player 1 and player 2
at the same time, this is now fixed.)

Soon It`ll be time to add a nice gui so players can define keys / joypads etc.

Also, I updated save/load game stuff to reflect new joypad emulation.

----------------------------------------------------

Changes from V1.77 Beta to V1.78 Beta 6/9/98

Modded some hardware register emulation code, clears up some graphic glitches.
HU6280 now supports zipped .pce files...

eg: hu6280 galaga90.zip

basically, hu6280 uses the first .pce file in the .zip you supply.
also, the gui now displays .pce and .zip files for your pleasure.

----------------------------------------------------

Changes from V1.78 Beta to V1.79 Beta 13/9/98

Recoded cpu timing, now much more accurate! Now emualtor runs ALOT faster!
modded some internal sound emulation stuff, should sound better now too.

oh, please report any changes you notice between this version and the previous
versions... thanks.


----------------------------------------------------

Changes from V1.79 Beta to V1.80 Beta 20/9/98


Removed gtmode because it was shit, and it was slowing shit down.
Fixed Sprite bugs in 'wondermomo'
Fixed Sprite bugs in 'keith courage'
Fixed Sprite bugs in 'tiger road'
Fixed Sprite bugs in 'soldier blade'

----------------------------------------------------

Changes from V1.80 Beta to V1.81 Beta 27/9/98

added crc rom detection to hu6280. (now the emu knows which rom u r running ;)
fixed the following games to actually run:

Fixed 'Sonic Spike Volleyball (usa/jap)'
Fixed 'Final Match Tennis (usa/jap)'
Fixed 'GAIA (jap)'
Fixed 'City Hunter (usa/jap)'
Fixed 'Toyshop Boys (jap)'
Fixed 'Homedata Chess Game (jap)'
Fixed 'FinalSoldier (jap)'

added hu6280 logo to front of emu ;)
removed logging stuff ('shit.log') that somehow made it into the last version...  :)

----------------------------------------------------

Changes from V1.81 Beta to V1.82 Beta 19/10/98

imporoved crc detection
added .BAK files when using save option (very handy), use 'K' to reload.BAK file
fixed some graphic glitches on various games (this sped emulation up)
improved cycle timing accuracy - (this sped emulation up)
optimized cpu emulation core, now runs better on pentium machines.
Fixed some minor bugs, and optimized memory useage

so, all in all just a speed boost, slightly more accurate timing, and .BAK file support ;)

----------------------------------------------------

Changes from V1.82 Beta to V1.83 Beta 04/11/98

Now using seal library 1.05 instead of 1.03, this should cure problems people
where having with their PCI soundcards.

Improved cpu timing again, also, tweaked dma emulation.

----------------------------------------------------

Changes from V1.83 Beta to V1.84 Beta 12/12/98

Investigated CDROM emulation further, now we have some games working (.ISO files only)
Fixed a major bug in CPU emulation
Tweaked GFX emulation (now faster and more accurate)
Populous now works! (96% of all hucards games work !!)
Added 'L' key to skip hu6280 screen :)-~

----------------------------------------------------

Changes from V1.84 Beta to V1.85 Beta 02/01/99

added -mouse commandline option for emulating pc-engine mouse! (try jamanoid!)
updated cpu emulation, now handles SET opcode correctly !

----------------------------------------------------

Changes from V1.85 Beta to V1.86 Beta 14/01/99

Fixed a major bug in irq emulation, it seems i was causing too many VBL Irq's :)
Anyway, alot of games seem to run faster now :)
Fixed a minor cpu bug, TST #xx,$ssss wasn`t setting the Z flag :)
Updated code to handle SET opcode 100% correctly :)

'Die Hard' seems to be behaving now... :)
'Kickball' now works
'Greatest 18 holes of major championship golf' now works
'Rabio Lepius' (Namco Shooter) now works
'Jack Nicklaus Turbo Golf' now works

+ many other games don`t glitch anymore !! :) Cool!

----------------------------------------------------

Changes from V1.86 Beta to V1.87 Beta 18/01/99

Fixed major bug in SATB DMA transfer emulation, this fixes the following games:

'Valkyrie'		- this game now runs
'Dragons Curse'		- sprites are fixed

Fixed bug in VBL emulation, this fixed 'Champions forever boxing' to actually run

Fixed bug in VScroll emulation, this fixes glitches in many games, I`ll name a few i noticed:

'Final Match Tennis'	- sprites aren`t fucked anymore
'Jamanoid'		- topline is visible :)
'burning angels'	- top line is fixed
'ballistyx'		- top line is fixed
'cadash'		- RCR splits are fixed
'King of Casino'	- sprites are on correct line
'darius'		- top line fixed
'Columns'		- sprites are on correct line
'World Court Tennis'	- sprites are on correct line

Basically, this fix has fixed ALOT of the minor graphic glitches, its a KEWL fix.

Spedup filename 'alpha sort' routine, now doesn`t take ages :)

oh yeah, if any games ARE glitching, try using the -notiq option, it`ll fix them (eg paranoia).

Oh, BTW, incase you are interested, the only pc-e game that doesn`t seem to
run on hu6280 now is 'Davis Cup Tennis', if you discover any others, drop me
some email at jamsponge@hotmail.com , Finally, the emulator is nearing
completion... I can feel it in my water ;)

----------------------------------------------------

Changes from V1.87 Beta to V1.89 Beta 23/01/99

Fixed a bug in video_status emulation, 'Davis Cup Tennis' now runs perfectly
Fixed a bug in dma emulation, this fixes explosion sprites on 'alices dream'
added code to detect if screen resolution was changed, fixes dirty left behind graphics on 'final blaster' , 'outrun' etc.

Next release of HU6280 will include the following kewl things...

16 bit screen option (for the full pc-engine 512 colour effect)
'hu6280.cnf' file that will contain your options, keys etc.
fixed timer interrupts (I`m working on it dudes...)
improved audio (I`ve discovered a bug in the audio shit, i`m working on it)

Please email me if you find any games that don`t work with this emulator, or, if a game is glitching really bad etc.

----------------------------------------------------









