

           The Minus4w Emulator V2.6!
        Copyright Mike Dailly 1996-2007

                  E-Mail me on
                mike@dailly.org


        The latest relase can be found at
            http://minus4.plus4.net




                  DISCLAIMER


  THE BORING BIT! THIS PRODUCT IS FREE. AND AS SUCH I
  ACCEPT NO RESPONSIBILITY FOR ANY DAMAGE DONE BY THIS
  PRODUCT. IF YOU USE IT, ITS YOUR FAULT. IF SOMETHING
  HAPPENS COZ YOU USED IT, ITS YOUR FAULT. IF THE EARTH
  EXPLODES WHILE YOU USE IT, IT'S YOUR FAULT. IF I HAVE
  A BAD DAY COZ YOU USED IT. YOU GUESSED IT - ITS YOUR
  FAULT! ALL IN ALL - YOU USE IT AT YOUR OWN RISK!




  Remember In windowed mode, the window is resizeable!!
        ( try double clicking on title bar!! )



Quick Keys
----------
F5              TRUBO mode
F8              Load PRG file
F9              Load from D64 file
F10             Debugger
F11             Reset
F11+Shift       Hard reset
F12             Quit


Command line options
--------------------
-s              Disable sound, Minus4 then syncs to timer
-t              Disable timer (has no effect when sound is on)
-p              -p "name\of\prog.prg"  will autorun from the command line. 
                The name must be in quotes
-d              -d "name\of\prog.d64"  autoload from D64 (minus4 then presents a list of files on disk)
                The name must be in quotes
-r              "run" will use this command to run. If not specified, RUN is used.
-R              This will record all sound output. This saves a file called "c:\test.raw" 
                You can then make MP3's or anything else from it. Delete this file before doing this again.
                NOTE: This requires and extra 40Mb of system memory. This shouldn't be an issue these days..
                sample is a signed 16bit RAW sample, 



                Whats NEW now!!
                ---------------  
V2.6
----
1)   Debugger Only: Added a menu switch for undocumented opcodes. They are now OFF by default.
2)   Debugger now loads symbols (-p "symbol.sym" on the command line). SNASM format.
3)   Source now builds under VS2005
4)   Updated Debugger to allow disassembly view movement. 
     Page up/down, line up/down now moves disassembly view
     SHIFT+Page up/down, line up/down now moves memory dump view
5)   Dump of most of the hardware registers
6)   Added a scrollable BAR to the disassembly view to allow the placement of breakpoints and nicer navigation
7)   New debugger keys:
            Cursor Up/Down              Move user bar
            Page   Up/Down              page disassembly up/down
    Shift + Cursor Up/Down              Move memory dump up/down a line
    Shift + Page   Up/Down              page memory dump up/down
            B                           Set Break point at current user bar address
    Shift + B                           Set Break point at address/symbol
            Enter                       Step a single instruction. If JSR/Branch then follow if need be.
            Space                       Place a breakpoint after current instruction and RUN.
            Cursor Right                If user bar is on a JSR/JMP, then read address and set window address to that.
            Cursor Left                 If CursorRight has been used, then pop last address off and reset window.
            M                           Set Memory window address
            G                           Set Disassembly window address
8)   Realtime code Profiling.
9)   Fixed TURBO MODE (F5) so it now works again.




V2.5
----
1)   Some Sound bugs have been fixed, also many clicks have been smoothed out. Some still remain however.
2)   Debugger now has breakpoints ("B" in the debugger, followed by address)
3)   Debugger now has a memory window ("M" in the debugger followed by address)
4)   Debugger now has execute instruction("SPACE" in debugger, places a breakpoint AFTER current instruction, loops etc.)
5)   Sound now uses true "SQUARE" wave, rather than sample... This can be switch back to samples in prefs.
6)   Ted Samples are now maximised for a fuller sound.
7)   Faster DDraw screen mode... *3 speed up - not that most folk will notice....


V2.4
----
1)   SID sound now works.
2)   -R now records SID sound as well....
3)   Remember the "play all samples" option... games like ACE need it to hear the speech!!


V2.3
----
1)   Full screen modes now work again.
2)   Save screen shot to .BMP is in (at long bloody last!)



V2.2
----
1)   -p "name\of\prog.prg"  will autorun from the command line. The name must be in quotes
2)   -d "name\of\prog.d64"  autoload from D64 (minus4 then presents a list of files on disk) The name must be in quotes
3)   -r "run" will use this command to run. If not specified, RUN is used.
4)   -R  This will record all sound output. This saves a file called "c:\test.raw" 
         You can then make MP3's or anything else from it. Delete this file before doing this again.
         NOTE: This requires and extra 40Mb of system memory. This shouldn't be an issue these days..
         Only TED+SAMPLES are currently written to disk. sample is a signed 16bit RAW sample, 
5)   F8  is now a shortcut to loading PRG files
6)   F9  is now a shortcut to loading D64 files.
7)   New Sound system. Sound latancy is right down... should now be as expected...
     If this fails to work on anyones machine, or if the sound crackles like mad, please let me know!!!
8)   F5 is sort of a "fast forward" toggle... may be a bit "so-so"  :)

Remember, you can assosiate with .PRG and .D64 files so you can double click on them!



V2.1
----
1)   Fixed keyboard, should now be 100% (Explosive Net" now gets past intro - Thanks Zsolt)
2)   Hardware Cursor now emulated correctly.
3)   Colour registers now return top bit as set (Rockman - thanks ATI)
4)   New ICON added - based on Lando's mini plus/4
5)   Added option to associate .PRG and .D64 files with minus/4 for auto-running ( in prefs )
6)   ALT-ENTER now kicks in and out of fullscreen mode (320x240)


V2.0
----
0)   This document added to archive
1)   Basic emulation will now work under NT4.0 service pack 3 ( no sound or joysticks )
2)   TED+Sample Sound added Via DirectSound ( Not NT )
3)   ECM colour mode added ( Manic Minor )
4)   Screen Blanking fixed to whole screen or none ( Manic Minor )
5)   Scanline drawing fixed a little.
6)   Raster IRQ delay of 8 cycles changed to 2 instructions, works a little better (Icicle works)
7)   True ROM paging now in.
8)   Inverse character mode fixed
9)   Joysticks now available under DirectInput ( not NT - at least I don't think so! )
10)  Keyboard input fixed ( Elite now works )
11)  All 8 roms can now be replaced via prefrences dialog - This isn't to say they will all work!!!
     Entering "none" will remove the rom - even the default ones. ( OS96, Jackattack etc )
12)  Disk emulation added. Both from a D64 file, and FAKE from the current directory.
13)  Saving to PC directory enabled. 
14)  Displaying of  ".PRG" files only in directory now has an on/off switch in prefrences.
15)  BCD mode fixed. Mercenary, and Exorcist now work okay.
16)  HardSID support!!!  Great PC SID card, find out more at http://www.hardsid.com
17)  Vertical Scrolling added.
18)  Top and bottom borders added. ( allows for TEXT in lower border )
19)  Simulated T.V. added, ( allows text in the top border )
20)  Command line added -p "filename.prg" -r "commandline" (i.e. minus4w -p "finder.prg" -r "run")
     -s to disable sound.  
     -t to disable timer
21)  Joystick emulation on Cursor keys added. UP,DOWN,LEFT,RIGHT and CTRL for fire. 
     This can be switched on/off from prefs


Notes
-----
     Play ALL samples in prefs will enable samples that DON'T set the D/A bit correctly. (ACE, TerraNova etc.)
     Y scroll fudge in prefs will help with "some" games that seem to be a rasterline out...
     ESCAPE mapped to escape correctly, F11 resets and F12 exits.


Known Bugs
----------
1)   Vertical Scrolling. 
     This has broken several demos/intros, but many games now work...
     This will be addressed in future release(s) :-)
2)   Emulated SID sound is wrong. somewhere....
3)   A couple of games seem to black out....? who knows.. 
4)   Minus4 runs slower under Windows 2000...
5)   NT users may have to disable sound and timer for now 
     or it could be my machine is just too slow :-)  
     (make a shortcut and set -s -t command line)
6)   TAPE's don't work yet...



V1.2
-----

Basic emulation, requires DirectX 5 and up
X scrolling, Hires+MCM characters and Bitmap mode
All CPU instructions emulated
D64 .PRG loading


V1.0
----
Ported from the much cleaner JAVA version(!)










