*** LINAPPLE ***

[INTRO]
What is linapple?
It is an emulator of Apple][ computer series for Linux or other POSIX compliant OS with SDL support.
(SDL means Simple DirectMedia Layer written by Sam Lantinga and others).

linapple works out of the box, just make it once and run whenever you wish.

Why not AppleLin? Yes, at first I think to call it such, but later linapple seemed better to me. And one point!

This is my work for making it possible to have comprehensive emulator of Apple][ computer series in Linux.

The original source is from AppleWin (http://applewin.berlios.de) by Tom Charlesworth.
I just adapted it for: video+audio for SDL, other functions for POSIX compliant OS, which Linux is in particularly.

Let me repeat once more: the whole job under emulator has been done of AppleWin creators and supporters, I just did a small part of work porting it to SDL and POSIX.



[INSTALL]
To build it you need SDL. Get it from http://www.libsdl.org, if you still do not have one, or use your distro' package management tool for installing SDL into your system.
After SDL is installed, you can build sources.

Go to src directory, run:

$ make

If there were no errors, go to the upper directory and run:

$ cd ..
$ ./linapple

If all files are on their places, you should see an X-Window with splash screen. Press F2 (or F3 before to choose some disk image in drive 1), and go to work.

It works as well as AppleWin, although it needs testing and supporting.
Where to install? Anywhere you feel fit,  just let linapple be with some files it needs for comprehenceive working.

The files are:

applelin.bmp 		- splash screen
charset40.bmp		- charset for Apple][ text modes.
font.bmp		- font for Help screen and Disk Select screen.
icon.bmp		- nice icon, logo of Apple][ computer.
linapple.conf		- configuration file.
Master.dsk		- disk image with DOS3.3 inside. See Apple license for details.

Essential are font.bmp and charset40.bmp, others can be omitted peacefully.




[USING LINAPPLE]

At first start you should see some nice splashscreen. Press F2 to start emualtion. Master.dsk should load, and you will see an DOS3.3(tm) prompt. By pressing F3 you may select an image file name (usually having extensions .dsk, .do, .po) into Slot 6 Drive 1. After selecting it, you either may reboot anew (by pressing F2 key) and try to boot from the inserted disk, or type any DOS3.3(tm) commands to view disk contents and to run any program located in it. Common DOS commands are `CATALOG' (like `ls' in Linux), `BRUN FILENAME' - running any binary (B) program, or `RUN FILENAME' - running any Basic program (A or I). Usually, most game images have alternative way to run programs in them. You may find a lot of disk images on largest and oldest ftp for Apple][ stuff ftp.apple.asimov.net.

To quit emualtor peacefully, press F10. F6 toggles fullscreen mode, Scroll Lock toggles fullspeed mode.

Other possible key commands of linapple are the following:

     F1 - Show help screen
     F2 - Cold reset
     Shift+F2 - Reload conf file and restart
     F3, F4 - Choose an image file name for floppy disk in Slot 6 drive 1 or 2 respectively
     Shift+F3, Shift+F4 - The same thing for Apple hard disks (in Slot 7)
     F5 - Swap drives for Slot 6
     F6 - Toggle fullscreen mode
     F7 - Reserved for Debugger!
     F8 - Save current screen as a .bmp file
     Shift+F8 - Save settings changable in runtime in conf file
     F9 - Cycle throgh various video modes
     F10 - Quit emulator
     F11 - Save current state to file, Alt+F11 - quick save
     F12 - Reload it from file, Alt+F12 - quick load
     Ctrl+F12 - Hot reset
      Pause - Pause emulator
      Scroll Lock - Toggle full speed
    Num pad keys:
     Grey + - Speed up emulator
     Grey - - Speed it down
     Grey * - Normal speed

Other powerful way to control behaviour of linapple is to change different settings in linapple.conf file, which should be located in the same directory where linapple is. Please, see linapple.conf contents to know what each setting means.

Please, note one point, too. When mouse works as a joystick, or Mouse Interface is on, when you first left-click on the window of emulator, mouse cursor is grabbed for using inside it. To release cursor, you should click left-mouse button again with SHIFT or CTRL key pressed. In fullscreen mode mouse cursor is always grabbed, to release it you may want to switch to windowed mode by pressing F6 key.



[SUPPORT]
Wanted:

--DEBUGGER
		I just owe at 9300 lines of code of AppleWin debugger. Michael Pohoreski, you are he-man, I tell you.
		Besides Debugger.cpp alone, there are some helper files such as Debugger_Assembler.cpp, Debugger_Console.cpp, Debugger_Display.cpp and so on. Who is able to port it to linapple?

--MOCKING BOARD  	Who knows how does that great thing work? Please, help adopting it to lianpple.
   (and PHASOR)		All sources for	sound support are in Mockingboard.cpp and SoundCore.cpp.
			SDL Audio used. Speakers are working out in Speaker.cpp. Who may think, heh?

More testing and debugging needed, of course. I would be grateful for any comment or suggestion regarding linapple.


[CONTACTS]
I am beom beotiger (bb), you may contact me at your will by my email beotiger@mail.ru

Thank you very much.
Long Live Linux!
And Apple][!

