************************************
*  KOLEKO - COLECOVISION Emulator  *
*           Version 1.33           *
************************************
*            by SiRioKD            *
************************************



--------
Contact:
--------

E-Mail: siriokds@libero.it

Main URL: http://www.siriokds.emuita.it/


-----------
Disclaimer:
-----------

KOLEKO (C)2000/2002 by Saverio Russo (SiRioKD)

- It can be distributed freely as long as it is not modified.
- When you use it you do so at your own risk.
- The author is not responsible for any loss or damage resulting 
  from the use or misuse of KOLEKO.

- COLECOVISION is registered trademarks of COLECO. 
  The author is in no way affiliated with COLECO.
  Games ROMS included in emulator are copyrighted and so 
  you can use it ONLY if you have original cartridge.
  
- If you do not agree with these terms delete KOLEKO now!!!


---------
What is?:
---------

KOLEKO is a COLECOVISION console emulator. 

Runs under Microsoft Windows 9x/NT/2K/XP.


-------------
Requirements:
-------------
- A fast MMX CPU (Pentium2 300MHz+)
- DirectX 7+ 




----------
Greetings:
----------

Reip (reip@emuita.it) for support!

Omar Cornut (omar@cornut.fr)
    for coding/know-how support.

Marat Fayzullin / Rst38h (http://www.komkon.org/fms/)
    for having released the sources of his TMS9918 vdp core.

Richard Mitton  (richard.mitton@bigfoot.com, http://etc.home.dhs.org/)
    for his RAZE-x86 Z80 emulator
    


--------
History:
--------

...................................................................................
25/Oct/2002	Version 1.33:

* Fixed some timing issues ("Defender" works!)
* Fixed PGUP/PGDN keys problems

...................................................................................
22/Oct/2002	Version 1.32:

+ Added state saving (see below for keys...)

...................................................................................
28/Apr/2002	Version 1.31:

+ Added VDP tables fast loading (see below for command line switches...)

...................................................................................
27/Mar/2002	Version 1.30:

+ Added 1st release of DInput JoyPad support (DX7+) see below for joy mapping.

+ Added PAUSE key to stop/run emulator.

...................................................................................
26/Mar/2002	Version 1.25:

* Fixed bug in VDP code. More games works!

...................................................................................
07/Feb/2002	Version 1.24:

+ Added command line EXTERNAL ROMS load (see below...)

* Changed screenshot filenames from "kolekXXXX.bmp" to "koleko_XXXX.bmp"

...................................................................................
22/Dec/2001	Version 1.23:

+ Added command line BLIT and RESOLUTION selection (see below...)

...................................................................................
21/Dec/2001	Version 1.22:

+ Added command line ROM selection (see below...)

...................................................................................
19/Dec/2001	Version 1.21:

+ Added Horizontal 25% scanline

+ Added 1024x768 resolution

+ Added Horizontal (3:1) 100% scanline for 1024x768

...................................................................................
18/Dec/2001	Version 1.2:

+ Added ROMS up to 50! (Some ROM still doesn't works...)

+ Added PGUP and PGDN in ROM's menu

* Patched KOLEKO bios to show some emul keys

* Changed EXIT key from ESC to F10

+ Added ESC key to exit from menus

* Fixed some bugs

...................................................................................
15/Dec/2001	Version 1.1:

+ Added ROMS up to 32! (Some ROM still doesn't works...)

* Changed SpriteLimit default to OFF

* Patched KOLEKO bios to change game's title screen delay time (~1 sec.)

...................................................................................
14/Dec/2001	Version 1.0:

* First Public Release!

...................................................................................


----------------------
Command Line Switches:
----------------------

/list			Create a "gamelist.txt" file, contains ROM list

/game <num>		Autoload ROM <num>, where <num> is the number preceding 
			ROM name in "gamelist.txt".

/file <filename>	Load external ROM file named <filename>.
				
/blit <num>		Select blitmode where <num> is:
			0 - MMX Horizontal Scanline 50%
			1 - MMX Horizontal Scanline 100%
			2 - MMX Horizontal Scanline 25%
			3 - MMX Doubled
			4 - BLT Doubled
			5 - BLT Fullscreen Stretch
			6 - BLT No Border Fullscreen Stretch

/res <w> <h>		Select resolution, <w>idth and <h>eight of desired resolution.
			Available (if supported by your videocard) resolutions:	
			512x384, 512x480, 640x480, 800x600, 1024x768



*** VDP TABLES FAST LOADING ***

			Some slow machines uses a much time to generate VDP tables so i introduced 
			capability to generate and save it to disk.

			Normally KOLEKO try to load VDP tabs from disk looking for "koleko_vos.vtb", 
			if not found generates it in RAM at runtime.
			You can use these switches to change this behaviour:

/vtab_save		Generate and save VDP tabs to disk as "koleko_vos.vtb" for fast loading.

/vtab_noload		Force no-load of "koleko_vos.vtb"

		
		
		

*** EXAMPLES ***

example1:		Command "koleko_vos.exe /game 8 /res 512 384 /blit 2" 
			Runs KOLEKO using internal ROM n.8, trying to switch to 512x384 and 
			choosing "MMX Horizontal Scanline 25%" as blit mode.
		
example2:		Command "koleko_vos.exe /blit 5 /res 640 480 /file c:\roms\frogger.rom" 
			Runs KOLEKO loading "c:\roms\frogger.rom", 
			trying to switch to 640x480 and 
			choosing "BLT Fullscreen Stretch" as blit mode.

example3:		Command "koleko_vos.exe /blit 4 /res 800 600 /game 3 /vtab_save" 
			Runs KOLEKO using internal ROM n.3, trying to switch to 800x600, 
			choosing "BLT Doubled" as blit mode and trying to save VDP tables 
			as "koleko_vos.vtb" for fast loading. (next time you load emulator!)
			
example4:		Command "koleko_vos.exe /blit 1 /game 1 /vtab_noload" 
			Runs KOLEKO using internal ROM n.1, using default resolution, 
			choosing "MMX Horizontal Scanline 100%" as blit mode and 
			forcing emulator to generate VDP tables at runtime 
			(no "koleko_vos.vtb" load.)
			



-------------------
Keyboard Shortcuts:
-------------------

  ESC	Exit from menus
PAUSE   Enable/Disable emulation

  F1 	Help
  F2 	ROM Select Menu ON/OFF ("RETURN" key to select ROM)
  F3 	Hard Reset
  F4 	Switch DirectInput Joypad Polling ON/OFF
  
  F5 	Switch between blit mode
  F6	Switch Sprite Limit ON/OFF
  F7 	Switch VGM logging ON/OFF (2MB buffer and save to file "koleko.vgm" in current directory)
  F8 	Save a screenshot
  
  F9 	Change resolution
  F10 	Quit
  F11 	Switch between use of VIDMEM / SYSMEM
  F12 	About message


SaveState keys

	CTRL + 
	F1~F8	Save machine state in slot 1~8 (save to file kolekostate_xx)

	SHIFT +
	F1~F8	Load machine state from slot 1~8 (load from file kolekostate_xx)

	PAGDN	Save machine state in temp slot (save to mem)
	PAGUP	Load machine state from temp slot (load from mem)
  
  
ColecoPad Stick   = Keyboard Curs, Joy Stick

ColecoPad Btn1    = Keyboard 'A',  Joy Button 1
ColecoPad Btn2    = Keyboard 'S',  Joy Button 2

ColecoPad Left    = Keyboard 'E',  Joy Button 3
ColecoPad Right   = Keyboard 'R',  Joy Button 4
ColecoPad Key '0' = Keyboard '0'
ColecoPad Key '1' = Keyboard '1',  Joy Button 5
ColecoPad Key '2' = Keyboard '2'
ColecoPad Key '3' = Keyboard '3'
ColecoPad Key '4' = Keyboard '4'
ColecoPad Key '5' = Keyboard '5'
ColecoPad Key '6' = Keyboard '6'
ColecoPad Key '7' = Keyboard '7'
ColecoPad Key '8' = Keyboard '8'
ColecoPad Key '9' = Keyboard '9'
ColecoPad Key '#' = Keyboard 'Q',  Joy Button 6
ColecoPad Key '*' = Keyboard 'W'


