Android port of KEGS Apple IIgs Emulator
Go to file
James Sanford 77af605387 Merge branch 'activegs_tests'
Conflicts:
	jni/sound.c
2012-08-12 16:26:54 -07:00
jni Debug notes. 2012-08-12 16:24:09 -07:00
res Slightly better layout. 2012-08-12 16:23:49 -07:00
src/com/froop/app/kegs Add icon. Use string resources instead of raw strings. 2012-08-12 16:23:18 -07:00
AndroidManifest.xml Add icon. Use string resources instead of raw strings. 2012-08-12 16:23:18 -07:00
project.properties Add project.properties so 'android update project' works. 2012-08-06 17:10:11 -07:00
README.md Add high level description of how JNI is used 2012-08-10 00:20:02 -07:00

Port of Kent Dickey's KEGS Apple IIgs Emulator to Android.

Work in progress! Currently optimized for tablet. Screen may be cropped on phones.

Config file and disk images in /mnt/sdcard/KEGS/ To attach disk images, use the F4 button to enter KEGS configuration.

The touch screen acts as a big trackpad for the mouse. To click and drag, for example to pull down GS/OS menus, you need to Long Press first.

What's not ready yet:

  • No joystick.
  • Screen scaling to fit your device.
  • Native UI configuration options.

Source code: https://github.com/jamessanford/kegs/

To build from source:

  android update project -p . -s
  (cd jni && ndk-build)
  ant debug install

Changes made to KEGS:

  • Various ifdefs for ANDROID in the kegs 'core'
  • Addition of android_driver.c and android_sound_driver.c

Application structure:

  • The UI is coordinated via KegsMain
  • There is a KegsView$KegsThread class that gets its own thread. This thread ends up calling mainLoop() in jni/android_driver.c and running KEGS in that thread.
  • The native thread gets two things from Java: -- a Bitmap -- a ConcurrentLinkedQueue

All UI events are sent to the native thread by pushing events into the ConcurrentLinkedQueue (KegsEvent, MouseKegsEvent, KeyKegsEvent).

The native thread pulls events off the queue, writes updates into the bitmap object, then calls the Java "updateScreen" in the KegsView$KegsThread object.

The native thread also calls support functions in Java, such as checkForPause(), which deadlocks the thread while it should be paused.

Android NDK samples were used as a base for this:

  • bitmap-plasma
  • JetBoy
  • native-audio