Released: CaSTaway/PSP - version Alpha 003

Tantissime novità e miglioramenti in questa nuova alpha version di CaSTaway, emulatore di Atari ST per PSP.
Trovate il changelog e l'intero readme di seguito, in allegato l'emulatore per entrambe le versioni di PSP (1.00 e 1.50):

Alpha 003
---------
NEW: While emulation is running, hit START to bring up runtime options
o Disk Management -- lets you eject and insert a different floppy(s)
o Reset menu works -- lets you exit the emulator entirely, or do a
warm reset on the ST (ie: Try inserting some disks, then hitting
reset, and voila.. no need to exit emulator to swap disks.)
CHG: Turned brightness up a notch (shifted colour palette decoding)
o Med res and low res both
CHG: On-screen keyboard
o The 'selection' is alpha blended to darken the key; nicer than blacking
it out
o The keyboard itself will fade in and out rather than just toggling on
and off when you hit the [select] button
NEW: In addition to .ST disks, .MSA format disks are all supported; further,
either kind of disk can be in a .zip file and work fine. (As long as thats
the only file in the .zip) -- some .ST's will compress from 800k to 200k
in a zip file, so it could be worth it.
NEW: Added simple intro-screen so you know what version is coming up
NEW: Disk picker changes
o When you hit () to pick a disk, it'll ask you if you'd like to insert
it into drive A, or B, look it up in the database, or delete it.
o Insert into A, B, and delete now work
o Disk picker now allows you to have many disks -- it'll scroll; no more
than about a thousand disks for now (It shows .ST, .MSA, .ZIP and
.SS files)
o If no disk is chosen (like you hit X to many times), it'll warn you so
you know why nothing really exciting is going on
FIX: The mouse should work nicely; in 001/002 it might sometimes just not
work at all, but I've tried it in no-disks, and Dungeon Master and others
FIX: The key release and press mechanism has been fixed up a bit; when you
use the on-screen keyboard to press a key, it should get held down for
1/6th second and then released. If this is not sufficient, let me know
and I can increase its duration.. but that should be plenty.
NEW: Savestates/loadstates - you can now save a snapshot to SD card and
load it up later; far more useful than in-game-saving, and faster.
o Build a crude keyboard based interface to typing in a filename for SD card
o Savestate
- you name a filen "aaaa" and the emu compresses the system RAM (etc)
into a zipped file "aaaa.ss" (.ss denotes savestate)
o Loadstate (from the normal disk picker menu)
- pick a .ss file in the disk picker (as if it was any other disk); a
"load now" or "delete" menu will appear, so you can fire up the state
or just delete it
o Seems to work; I saved out a xenon2 savestate and loaded her back up;
use this to circumvent multi-disk or long loadtimes (Civilization and
Dungeon Master, I'm looking at you!)
NEW: Check for existance of TOS.ROM; if missing, show warning.
NEW: Games database
o When you pick a .msa, .st or .zip, it'll offer to insert it into the
drives; another option is to "look it up in the database", which calculates
a CRC on the disk and looks it up in a special database the GP32 users
helped create. If the CRC is found, a listing of games on that known
disk is shown.. otherwise, an error shows that its not in the database.

CaSTaway/PSP - version 003
--------------------------
http://www.codejedi.com
skeezix (c) 2005

This is a serious update! Alpha 001 was a proof of concept; Alpha 002
was to get it more fun.. but Alpha 003 is to bring it right up to speed
as one of the best emulators around!

I expect the next release will just play with key options and add some
background artworks and other 'nice touches', as well as perhaps add some
new control schemes to make certain games more playable, integrate the
games database into the disk picker more and other bits of fine tuning.
Eventually some config file support with key-binding options will be
added so you can really go to town.. but Alpha 003 should pretty much
satisfy everyone

Oh yeah, real documentation soon

INSTALLATION
------------
1) Install the executable to your Memory Stick as you would any other
PSP homebrew. (ie: Look in the PSP-ROM-1.50 directory if you've got
a 1.50 PSP; if you've got a 1.0 PSP, go to the PSP-ROM-1.00 directory!)
Essentially, you need to copy the CASTAWAY, CASTAWAY% and ATARI_ST
directories into your PSP/GAME folder.

2) Get an Atari ST TOS.ROM file, unzipped, and drop it into your
ATARI_ST directory. It could have been a .rom or .img file, but you
rename it to TOS.ROM. (Example -- you might be using TOS 1.02 UK, so rename
it to TOS.ROM period.) Use the US 1.02 for best results, but many others
work fine as well.

3) Get yourself some Atari ST game disk images ("roms", but really disk
files) and drop them into your ATARI_ST directory. They usually come as
.ST or .MSA files, and can be zipped (just the one .ST or .MSA file inside
of the zip!)

You're good to go.. launch and enjoy!

CONTROLS
--------
While the emulation is running, hit:

SELECT - bring up or dismiss the on-screen ST keyboard for typing in
any keys you may wish to type in. (To get past loaders, or play text
adventures or the like.)

START - bring up the main options menu; lets you swap disks, reset the
ST, write out a savestate for later re-use, and all sorts of things.

Analog joystick - used for the Atari ST _mouse_ by default

D-Pad (on the left) - used for the Atari ST _joystick_, by default
SQUARE and CIRCLE - used as Atari ST left and right mouse click, by default
CROSS (X) - used as Atari ST joystick firebutton by default

** These will be configurable in a future update

------
Enjoy!
------

Alpha 003
---------
NEW: While emulation is running, hit [START] to bring up runtime options
o Disk Management -- lets you eject and insert a different floppy(s)
o Reset menu works -- lets you exit the emulator entirely, or do a
warm reset on the ST (ie: Try inserting some disks, then hitting
reset, and voila.. no need to exit emulator to swap disks.)
CHG: Turned brightness up a notch (shifted colour palette decoding)
o Med res and low res both
CHG: On-screen keyboard
o The 'selection' is alpha blended to darken the key; nicer than blacking
it out
o The keyboard itself will fade in and out rather than just toggling on
and off when you hit the select button
NEW: In addition to .ST disks, .MSA format disks are all supported; further,
either kind of disk can be in a .zip file and work fine. (As long as thats
the only file in the .zip) -- some .ST's will compress from 800k to 200k
in a zip file, so it could be worth it.
NEW: Added simple intro-screen so you know what version is coming up
NEW: Disk picker changes
o When you hit () to pick a disk, it'll ask you if you'd like to insert
it into drive A, or B, look it up in the database, or delete it.
o Insert into A, B, and delete now work
o Disk picker now allows you to have many disks -- it'll scroll; no more
than about a thousand disks for now (It shows .ST, .MSA, .ZIP and
.SS files)
o If no disk is chosen (like you hit X to many times), it'll warn you so
you know why nothing really exciting is going on
FIX: The mouse should work nicely; in 001/002 it might sometimes just not
work at all, but I've tried it in no-disks, and Dungeon Master and others
FIX: The key release and press mechanism has been fixed up a bit; when you
use the on-screen keyboard to press a key, it should get held down for
1/6th second and then released. If this is not sufficient, let me know
and I can increase its duration.. but that should be plenty.
NEW: Savestates/loadstates - you can now save a snapshot to SD card and
load it up later; far more useful than in-game-saving, and faster.
o Build a crude keyboard based interface to typing in a filename for SD card
o Savestate
- you name a filen "aaaa" and the emu compresses the system RAM (etc)
into a zipped file "aaaa.ss" (.ss denotes savestate)
o Loadstate (from the normal disk picker menu)
- pick a .ss file in the disk picker (as if it was any other disk); a
"load now" or "delete" menu will appear, so you can fire up the state
or just delete it
o Seems to work; I saved out a xenon2 savestate and loaded her back up;
use this to circumvent multi-disk or long loadtimes (Civilization and
Dungeon Master, I'm looking at you!)
NEW: Check for existance of TOS.ROM; if missing, show warning.
NEW: Games database
o When you pick a .msa, .st or .zip, it'll offer to insert it into the
drives; another option is to "look it up in the database", which calculates
a CRC on the disk and looks it up in a special database the GP32 users
helped create. If the CRC is found, a listing of games on that known
disk is shown.. otherwise, an error shows that its not in the database.

Alpha 002
---------
NEW: Basic disk picker (it works, but not fancy yet)
o Lists .ST and .MSA files in the /PSP/GAME/ATARI_ST directory
o Don't use MSA's yet.. they're screwy
o Press 'X' to run the emulation
o Press '()' (circle) to select a disk; you should always select a
disk at this point, since if it runs without any disks it gets confused
for now
o Only put in 5 or less disks for now; lame, but I ran out of time and
wanted you to have something to play with for the weekend (Spent days
tracking down an obscure bug :/)
CHG: Mouse speed increased a bit; double-click and such should work
REM: TOS has to be called TOS.ROM (TOS.IMG seems not to work.. not sure why :/)
o You need a TOS.ROM file; don't ask me where to get it.. ask Google or
suck it from your Atari ST machine.
NEW: Full screen scaling with smoothing by default
NEW: Onscreen virtual ST keyboard
o Use SELECT to toggle keyboard on or off
o While present, left d-pad controls keyboard selection point and
right d-pad X will push the selected key
o Adjusted key hold duration and repeat duration to avoid million-presses

Alpha 001
---------

Although the emu is missing any form of finesse, it does run pretty well --
for many or most games, it'll run full speed with no frameskip (which is good
since I didn't implement frameskip yet During 'heavy math' operations it'll
run slower, so unpacking Dungeon Master takes a good minute or two probably..
but running Xenon 2: Megablast and it'll run a little too fast until I add
speed throttling.

REM: .ST disk images only (.MSA or zipped images not yet supported.)
REM: Default disks looked for: DISK_A.ST and DISK_B.ST -- you don't need
them if you just want to see TOS. If you want to boot a game without
picking in the (not yet existing disk picker, name it DISK_A.ST!
ex: /PSP/GAME/ATARI_ST/DISK_A.ST that is a copy of A_133.ST (Automation 133)
will fire up Xenon 2.
REM: You need an operating system; the file can be called either
TOS.ROM or TOS.IMG (doesn't matter, its just a filename); use TOS 1.02 US
for best results, but many others work (and many do not.)
REM: Stick files in /PSP/GAME/ATARI_ST
REM: ST-Low res works well; ST-Medium res works, but is fugly for now.
ST-High res not yet supported.
REM: Analog is for controlling the mouse motion
REM: Left D-pad for controlling joystick motion
REM: Square is left-mouse-button, circle is right-mouse-button,
cross/X is joystick fire

For now, Triangle hits '1' on the ST keyboard.. maybe can get into some
games (such as Xenon 2: Megablast). Right-trigger is 'Space', so should
get a few games going.

Needs: Throttling -- a little too fast sometimes; during high math its
likely slow (like loading Dungeon Master, though runtime should be fine.)
Needs: Fullscreen scaling
Needs: Disk selection menu
Needs: Frameskip selection (and other 'options' menu)
Needs: Etc etc.

Enjoy!

Jeff
Codejedi Inc.
http://www.codejedi.com