Welcome to the Apple II Simulator
=================================


This simulation of the Apple II+ is fairly complete. But i feel,
that some explanations are necessary at this point.

Processor: There are two 6502 simulators in the src-directory.
	You can use either one with the apple-simulator.

	cpu1.c is somewhat faster but cryptic and not expandable.
	It was my first approatch.
	cpu2.c provides a correct cpu clock time base. The 65C02
	instructions can be added easily.
	
	If you have Ben Koning's Emulator, you can use his
	6502 too. Write an appropriate 'apple.h'. Only some
	#defines are necessary. It has two bugs: It doesn't
	set the overflow flag correctly when doing ADC or SBC.
	The unused bit in the processor status is always
	set to zero, confusing DOS 3.3.

Screen:	For each display mode (text, lores and hires) and each 
	page (page1 and page2), a separate pixmap is created. 
	But if a pixmap is not visible, it is destroyed.
	The only exeption is, when switching between page1
	and page2 (of any type) occurs. You can override this
	with the -keep option.

Paddles: The paddles 0 and 1 follow the mouse cursor in the
	simulation window. Therefore the window has a size of
	280x256 (instead of 280x192).

Buttons: Mouse button 1 and 2 are used for button0 and button1.

Expose:	Expose events are handled, when $C0XX or screen locations
	are used. The applesoft interpreter does this frequently,
	so all expose events are resolved immediately. If a machine
	language program runs, no redraw is done for quite a while.

Language Card: The language card will NOT change state upon reset.
	An original apple will switch off the LC.

Controller: It works with the usual 16-sector disk scheme. Any
	disk copyable with COPYA should work perfectly.
	Formatting will not work under ProDos or Apple-Pascal because
	ProDos filer and Apple-Pascal formatter think, the disk is
	spinning too slow. Under Apple-Pascal, simply use the 
	filer's z(ero command. For ProDos, get the image of a fresh
	formatted ProDos disk and copy it with the ProDos filer.
	
Sound:	A X-Display can only beep :-( Therfore, i haven't spent much
	work on sound. With the commmand option -beep, the X-Display
	beeps, if the speaker is toggled 100 times. With most games,
	this sounds pretty ugly ;-)

Peter Koch (e-mail: koch@informatik.uni-kl.de)
