SDDapple - rewrite of Dapple for SDL
Copyright (C) 2002-2006 Steve Nickolas, Dapple Project
The SDL libraries linked to this program are licensed under the LGPL
You can download them from http://www.libsdl.org/
PLEASE NOTE THE FOLLOWING CHANGE OF LICENSE FOR SDDAPPLE 0.16(G) AND LATER:
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
The author may be contacted at <lyricalnanoha()dosius.net>
Current status:
* Emulates Apple ][+ with 64K RAM, or //e with 128K RAM.
* It was I who implemented RAM Works in Dapple 2 and I may do it again.
* All ][+ graphics modes are emulated (minimal testing on Screen 2 though)
but hi-res graphics emulation is imperfect.
* END key exits. Ctrl-F12 resets. F1 and F2 change disks. F11 switch
between windowed and full screen modes.
* Disks are expected to be disk6a.dsk and disk6b.dsk at startup.
* Larger PO-type disk images can be provided in Slot 5 as hdv1.hdv and
hdv2.hdv; these are the same format as in ApplePC and most other
emulators. The source code defaults these images to 800K when formatted
under ProDOS.
* A single PG2 file can be named quikload.pg2, and loaded by pressing
Alt-F11. The A value is what to CALL. (if it says A02045, you need to
type CALL 2045) Also, you can load PG2 files with Alt-F6 (as in very
old versions of Dapple).
* The header information can be displayed (in hex only) by typing the
command: sddapple -h
* Full BWOR mode has been added to SDDapple 0.1; hybrid BWOR mode is
available and you still get regular mode as default.
* To use hybrid BWOR mode (REE on top of existing monitor): sddapple -H
* To use full BWOR mode (don't load monitor.rom at all): sddapple -F
* To use Apple //e mode (see below for caveats): sddapple -E
You need to use uppercase E, F and H.
* No disks work correctly in full BWOR mode. You'll need to use a
compatibility mode or PG2 loader to load programs.
* The cursor doesn't show up in hybrid mode.
* Be prepared for unusual behavior when using BWOR REE modes. BWOR's
emulation of the ROM code is incomplete but runs at the native speed
of the host computer.
* The BWOR REE replaces the 6502 disassembler from the native ROM with
a 65C02 disassembler. You will notice a difference in the format of
disassemblies.
* The monitor and BASIC ROMs have been split. A regular 12K (FPBASIC from
the August 1980 System Master will do just fine) Apple ][+ is usable in
normal mode, but in Hybrid mode, you need to run BWROMMAK to separate
the BASIC and the monitor into two separate files. In full REE mode you
only need the BASIC ROM; if you don't have a 10K BASIC you will need to
run BWROMMAK.
* Preliminary Apple //e support is available; you need a 16128-byte ROM
from a //e. This corresponds to bytes $C100 and up. Slot 3 isn't
implemented, nor any of the new video modes, and the MMU and IOU are
incompletely emulated.
* F3 and F4 alter the CPU multiplier, which affects the CPU speed. A
multiplier of 1 should run at about 1 MHz. This works by changing how
many cycles, in increments of 65, are let rest between the redraw of
two scanlines.
* Alt keys ONLY function in //e mode. In that mode they do the expected.
* The original //e ROM is detected by checksum (16-bit adder, same used to
detect BASIC versions when the REE is enabled). If found, MouseText is
disabled. If not found, MouseText will be available.
* CPU multiplier is set for a Frameskip of 5 by default
This is inaccurate, but for some reason runs closer to the original
speed (note the slowdown caused by the new video code), and the sound is
fairly accurate. The code is taken from KEGS via an Alpha version of
EMU][. KEGS is copyright 2002 Kent Dickey and licensed under the GNU
General Public License (as SDDapple is also).
|