b300e60e2a
- 'was_gzipped' state is persisted in .apple2.json preferences - This removes all file-renaming codepaths at the cost of temporarily nonconformance to naming convesion (e.g., disk images inserted read/write are still called 'foo.dsk.gz' although they are not compressed) - Unclean shutdown of emulator leaves any disk images that were inserted read/write in their non-gzipped state (regardless of file name extension) on disk until emulator restarted and disk images explictly ejected or clean shudown. App removal after unclean shutdown will potentially leave mis-named disk images lingering. - Emulator will handle edge cases of non-gzipped disk images with '.gz' extension and gzipped disk images without '.gz' extension |
||
---|---|---|
Android | ||
Apple2Mac | ||
disks | ||
docs | ||
external | ||
src | ||
.gitignore | ||
ASM | ||
AUTHORS | ||
ChangeLog | ||
configure.ac | ||
COPYING | ||
external-disks | ||
externals | ||
Makefile.am | ||
NEWS | ||
PROBLEMS | ||
README | ||
README.debugger | ||
README.md | ||
reconf.sh | ||
TODO | ||
valgrind.suppress |
Apple //ix
Apple2ix is an Apple //e (8bit 65c02 CPU) emulator designed to work on various POSIX platforms.
Lineage
Apple2ix derives from the apple2-emul-linux project originally coded by various developers in the mid 1990's and FTP-uploaded as source tarballs to the original tsx-11.mit.edu
Linux archive.
The original software was designed to work from the Linux console rendering via SVGAlib. It ran on par to the 1MHz Apple //e on an i386 (Pentium 100 class) or better machine. Later ports added X11 graphics support based on the original X11 DOOM source code drop, ty JC!
As of October 2016, the resurrected Apple2ix runs on x86 and ARM Android devices, x64 MacOSX 10.9+, and x64 GNU/Linux
Project Goals
- Portability and code resilience across a wide range of modern POSIXy systems including MacOSX, desktop Linux/BSD, iOS, Android. If you are on Windows, just use the excellent AppleWin emulator!
- Language/platform/API minimalism for core emulation modules (prefer coding to POSIX APIs and using C99 over all other choices)
- Reasonable emulation fidelity to the original Apple //e machine (timing, video, audio, etc...)
- Good platform citizenship for each port (prefer coding in language-of-choice promoted by platform--e.g.: Objective-C/Swift on Darwin, Java on Android, ...)
Project Tech
- C99 dialect of the C programming language for the majority of the project
- x86 and ARM assembly language for 65c02 CPU emulation loop
- Extensive tests for 65c02 CPU, Apple //e VM, disks, and display (expected framebuffer output)
- OpenGLES 2.x graphics with simple portable GLSL shaders
- OpenAL and OpenSLES audio (emulated speaker and emulated Mockingboard/Phasor soundcards)
- Objective-C and Cocoa APIs (Mac/iOS variant)
- Java and Android APIs (Android app)
Android
Running at 30FPS on ancient Gingerbread (Android 2.3.3) devices:
Running at 60FPS on modern Android devices:
Other Maintained Ports
- Desktop GNU/Linux (GNU build)
- macOS/iOS (Xcode build)
Semi-Ordered TODO
- Double-LORES graphics (used in Dagen Brock's Flappy Bird clone) are ugly/incorrect ... fix 'em
- Double-HIRES graphics are also ugly/icorrect ... fix 'em
- Improve VBL timing and vSync matching to the device/system refresh rate
- CPU module ports: aarch64, Clang IR (bitcode)
- iOS/iDevice ports. (in progress)
- Net/Open/Free-BSD port
- OpenGL shaders/tricks for style (emulating of various NTSC screen artifacts)
- Emulation features ... (3.5" disk, AppleHD, Phasor, printer, ethernet, ...)
- Debugger rewrite with tests ... improved debugger routines (CLI/curses debugger? GDB/LLDB module?)
- Port to web ... emscripten/asmjs/web assembly