Short:        Apple II emulator.
Author:       Steve Nickolas, Dapple Project
Uploader:     Ventzislav Tzvetkov
Type:         misc/emu
Version:      0.11
Architecture: ppc-amigaos >= 4.0.0
Requires: Apple II ROM file; Apple II software.

SDDapple - rewrite of Dapple for SDL
Copyright (C) 2002-2005 Steve Nickolas, Dapple Project
CPU Core (C) 1996, 1997, 2002 Marat Fayzullin and Alex Krasivsky
         additional contributions by Steve Nickolas and Holger Picker

The SDL libraries linked to this program are licensed under the LGPL
You can download them from http://www.libsdl.org/

This program is NOT open source. It is licensed to you under the
following terms:

 * You may use this source code or binary free of charge; you may
   redistribute them freely in their unmodified form; you may NOT
   charge for them, and you may not distribute modified versions.
 * Modifications to the source may be sent to the author as patch
   files (diff -wu FILENAME.EXT); current e-mail address is listed
   below.
 * You may not bundle ROM files with this program, without permission
   from their copyright holders.

The author may be contacted at <lyricalnanoha@dosius.net>

This program is in an early stage of development, being a complete rewrite
of Dapple/EMU][.  It is not open source as I have aimed for my past
emulators; I have my reasons for this (mainly related to being too lazy to
replace the cpu core with an open source one).

Current status:

  * Emulates Apple ][+ with 64K RAM.  I'm not planning to make this a //e
    emulator right now.
  * All ][+ graphics modes are emulated (minimal testing on Screen 2 though)
    but hi-res graphics emulation is imperfect.
  * Because of the ease of adding the capability with SDL there is already
    a scanline-based redraw mechanism.
  * END key exits.  Ctrl-F12 resets.  F1 and F2 change disks.
  * 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
  * The monitor and BASIC ROMs have been SPLIT.  You'll need to run bwrommak
    to generate monitor and BASIC ROMs.  You don't need the monitor ROM if
    you use Full BWOR mode, but you do lose a lot of compatibility.
  * 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
    You need to use uppercase 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.
  * 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.


.