README.SDL

This is the README for the SDL port of Yape (Yet Another Plus/4 Emulator)

Current SDL version is 0.32.5

LEGAL
=====

  Yape for SDL is 
  (C) 2000-2001,2004,2007,2008 Attila Grósz (gyros@freemail.hu)
  http://yape.plus4.net

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License as
  published by the Free Software Foundation; either version 2 of the
  License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  02111-1307  USA

  The ROM file headers in the package are 
  Copyright (C) by Commodore Business Machines.

COMPILE
=======
  
  To be able to compile on Linux, you must have the latest SDL
  package from http://libsdl.org. The recent stable release as of time of
  this writing is 1.2.7. You will need the development libraries for Linux.
  
  The provided makefile is written for the GNU C++ compiler but can also
  be easily adjusted for other compilers.
  
  It is very likely that if SDL is supported on your system, than Yape can
  be compiled and run. Hence, a BeOS port is also possible, and Yape has
  been succesfully compiled on Windows, and 64 bit Solaris systems as well.
  
  Once the libraries and header files are installed, you should
  extract the source tarball to a directory, and simply type:
  
  make
  
  If the compilation finished with no error, you can type:
  
  ./yape [PRG/TAP filename]
  
  to start the emulator, where filename is optional.
  
USAGE
=====

  The user interface isn't yet ready, so you MUST memorise a couple
  of keyboard shortcuts:
  
  F12 or ESCAPE : exits the emulator
  F11		: soft reset
  LCTRL + F11	: forced reset (memory remains intact)
  SHIFT + F11	: hard reset (clear memory, reloads ROMs, rewinds tape)
  
  F5		: press PLAY on tape
  F6		: press STOP on tape
  F7		: save screenshot to BMP file
  F8		: enter the user interface, press F8 again or ESC to quit.
		  You can move around in the menus with the arrow keys, press ENTER for selection.
  
  F9		: quick debugger
  F10		: save current settings to user's home directory

  LALT + S	: display frame rate on/off  
  LALT + J	: toggle joystick emulation (via crsr keys)
  LALT + I	: switch emulated jostick port
  LALT + W	: toggle between unlimited speed and 50 Hz frame rate (original speed)
  
  Internal disk LOAD/SAVE operations are supported to the current
  file system directory, which is usually '/home/<username>/.yape'.
  Any PRG files you may wish to load, should go there, although you can browse the directory tree
  from the user interface, too.
   
  This means that an exact filename match will load
  the requested program, similarly can you save a file.
  
  Full ROM banking is supported, currently only via the yape.ini configuration
  file. You must fill in the path for the relevant ROM image you intend to use.
  However, Yape supports some internal ROMs already. These are:
  
  - 'BASIC' 	 - the ROM image containing the BASIC interpreter
  - 'KERNAL' 	 - the system kernal ROM image
  - '3PLUS1LOW'  - the low bank ROM image of the built-in plus/4 software
  - '3PLUS1HIGH' - the high bank ROM image of the built-in plus/4 software
  
KEYBOARD MAPPINGS
=================

  Unfortunately all X11 servers map the keys at different positions, so your
  mileage may vary. I have yet no info on how to solve this issue.
  
  There are several keys that need to be mapped to the emulator keyboard
  differently. These are:
  
  Commodore       emulator
  ------------------------
  Pound 	= END
  Clr/Home	= HOME

FEATURES
========

  Yape features:
  
  - full, cycle exact MOS 7501 CPU emulation
  - almost full TED 7360 chip emulation
  - full ROM banking
  - almost full tape emulation
  - joystick emulation via cursor keys
  - color palette based on original Commodore specs
  - PRG and TAP file format support
  - fake disk LOAD/SAVE to the file system

LINKS
=====

  http://yape.plus4.net 		: Yape homepage
  http://plus4world.powweb.com  	: Commodore +4 World (games, tape images, scans etc.)
  http://c64.rulez.org	    		: Commodore plus/4 mail list and FTP archive
