SAE - Scripted Amiga Emulator

Requirements
- A very fast computer
- A browser capable of HTML5 with:
  - WegGL
  - WebAudio
  - Typed arrays
  - FileReader (GUI)
- A ROM:
  - Amiga Kickstart 1.x-2.04 (not included for copyright reasons)
  - AROS Kickstart (included)
- And a bunch of ADF-files to test (optional)

Supported browsers
Chrome	Fastest
Firefox	Medium speed
Opera	Slow speed, no audio
IE	No support
Other	Untested

Goals
- Make Amiga Classic Emulation available for browsers.
- Easy integration into websites.
- API for control from background, useful e.g. for a demo-player.
- Browsers-plugins should not be required, just HTML5 and javascript.

Possible usage
- Demo/Intro/Mod-player
- Playing games
- Browser benchmark

Usage/Hints
- Press F11 for fullscreen. Most browsers support that.
- If something does crash, try another memory setting or a different ROM. The original kickstart (1.3) work's best.

Known bugs/problems
- Fast blinking sprites are not displayed if 'Frameskip' is active.
- Copper initiated color-changes within a scanline are not recognized.
- Left/right shift/alt/ctrl are the same. That's a browser 'feature' and can't be fixed for now.

Missing features
- User-config
- Maybe ECS support

Written and ported by
- Rupert Hausberger <rupert_hausberger@gmx.net> (donate)

Source code
- github.com/naTmeg/ScriptedAmigaEmulator

Thanks
- Bernd Schmidt
- WinUAE and AROS team.

License
- This is a free project.
- You may use the emulator in your own website.
- If you use the emulator in your own website, you must provide a link to this homepage.
- If you use the emulator in your own website, you must not change the copyright header in the source-files.
- Commercial use in any form is prohibited. This includes donations.
- No warranty expressed or implied. Use at your own risk.

Fully working...
Games Alien Breed Alien Breed Special Edition 92 (0.7) Alien Breed Tower Assault (0.6) Alien Breed II - The horror continues (0.7) Boby Blows Galactic (0.7) Agony (0.6.1) Another World Barbarian (0.7) Battle Chess Blood Money Crystal Hammer Dynablaster (0.7) Firepower Lotus Turbo Challenge 1/2 (0.6) NorthPrince of Persia (0.7) Pinball Dreams Pinball Fantasies (the demo with 1 desk) Prince of Persia (0.7) Project-X (0.7) Project-X Special Edition '92 (0.6) P.O.W. Rubicon (0.6) R-Type 2 Shadow of the Beast 2 (0.6) Terminator 2 (0.7) Turrican 1/2 Turrican 3 (0.6) Wings (0.6) Wings of Death (0.6.1)	Demos Deja Vu How to skin a cat Project-X (demo-rolling) (0.6) State of the Art	Apps Devpak 2.14 DPaint 4.1 Protracker 3.61 SysInfo 3.24 Workbench 1.x Workbench 2.04 (0.6)
Note: The lists corresponds to Kickstart 1.3

History
- 0.7.0 (24.12.2012):
  - Common
    - Chaned the project-name from 'Janus' to 'SAE' (Scripted Amiga Emulator).
      This step is necessary because i did'nt enough research before the initial release.
      There is already a project with that name in it. (janus-uae) I'm sorry for that, that was kinda stupid :)
    - Separated the GUI form the core and rewrote most of it.
    - Simplified the whole code. This means, that functions are called faster.
    - Ported new Copper-, Blitter-, Audio-, Disk- and event-handling code from WinUAE 2.5.0
    - Moved all "beam-functions" to events.js, for faster access.
    - Added "CPU-usage" to the GUI.
    - Added "Hall of Fame".
  - CPU
    - Added support for exact cycling. The CPU have now 7.09 MHz on PAL and 7.16 MHz on NTSC resp.
    - Added option for "Original"- and "Maximum"-speed.
  - Audio
    - Added a ring-buffer before output. No more "bagpipe"-like audio.
    - Added a option to just emulate the hardware, but not to play any sound, e.g. "Agony" was not starting, if audio was disabled.
  - Display
    - Switched from the RGB to the 565 texture-format-encoding in WebGL, which gives a little more speed.
    - Added support and a option for 4x scaling.
    - Fixed screen-draging in lo-/hires-modes.
    - Added a option to disable the output. Can be used to better play music-demos.
  - Disk
    - Added support for different speed-modes.
    - Added support for extended ADF-files.
    - Enabled write support. (to memory)
  - Input
    - The F-keys does work normaly now, i.e F5 does'nt reload the emulator, backspace does'nt go to the last page, etc...
    - Fixed bug in the joystick-emulation.
- 0.6.1 (05.11.2012):
  - CPU
    - Added missing TAS command. ('Wings of Death' game does use it)
  - ROM
    - Added a crc32-checksum test after download. (AROS)
    - Changed transfer-mode from syncronous to asyncronous. (AROS)
  - Display
    - Optimized the line-drawing code of the blitter.
    - Fixed decision whether the resulting image is scaled or not. ('Agony' game)
    - Disabled 'Framedrop' in interlace-mode.
  - Misc
    - Fixed HTML5 doctype.
    - Added ver/rev to the title.
    - Changed revision to 3 digits.
- 0.6 (25.10.2012):
  - ROM
    - Added support for extended-roms.
    - AROS kickstart replacement is now the default-rom, and will be downloaded and used on the fly.
  - RAM
    - Changed internal memory alignment from 8 to 16 bit.
    - Added fast-ram support, through a emulated Commodore A2058 in Zorro2-mode.
    - Removed the D8DC-memory-option from the GUI. This memory space is now always allocated.
    - Sorted access of the memory-routines by priority.
  - CPU
    - Fixed sign-extension for memory to address-register transfers in MOVEM.
    - Fixed sign-extension for absolute-word addresses in exEA.
    - Fixed wrong address when writing a byte to the stack in ldEA.
    - Fixed 32bit calculations for address-regsiters in ADDQ/SUBQ.
    - Fixed remainder calculation in DIVU.
    - Optimized integer-arithmetic functions. Size depending calcalations are now used.
    - Improved exception 2/3 handling.
    - More small cleanups not listed here.
  - Disk
    - Ported latest disk-code from WinUAE. Disk-based problems should be gone now, e.g. floopy shown as BAD or read errors.
    - Diskchange does now work.
    - Drives can be disabled now.
    - DD/HD types are now supported.
  - Display
    - Added missing support for HAM6.
    - Fixed horizontal and vertical screen-centering.
    - Fixed screen-draging, almost, read the "Known bugs" section.
    - Added better screen-scrolling.
  - Input
    - Fixed key-mapping to the amiga key-layout, at least in Chrome. Firefox does not like "öäü", it seems.
    - Added support for individual configurations of joystick-movement and fire-buttons.
    - Fixed bug, that made the fire 1 button on joystick 0 not working.
    - Fixed bug in the mouse-movement function, that calculates the wrong coordinates in some cases.
  - GUI
    - Added eject-button in the disk-change requester.
    - Removed the CPU and OCS/ECS options. They are useless so far.
    - The "Pause" and "Resume" buttons are once now.
    - Made some options to only apear when selected.
    - Did some cosmetics.
  - Misc
    - Added support for Zorro2-expansion cards.
    - Added a more precise event-handling. This makes the audio-output a little smoother.
    - Changed the ratio of CPU-/Chipset-time from 1:8 to 1:4
    - Fixed a bug in the RTC. "Year" is now calculated correctly.
    - Fixed incorrect response of serial.device. Now crashed programms does reset (and show the guru), instead of idle.
    - Any output on the serial.device is now redirected to the debug-log. (dev only)
    - Kickstart/Workbench 2.04 and AROS does now work.
    - Overall about 10-30% more speed, as long as the blitter is not used too much.
- 0.5 (01.09.2012):
  - Initial.