Caprice32 - Amstrad CPC Emulator (c) Copyright 1997-2004 Ulrich Doewich http://sourceforge.net/projects/caprice32/ .......................................................................... WHAT IS IT? ~~~~~~~~~~~ Caprice32 is a software emulator of the Amstrad CPC 8bit home computer series. The emulator faithfully imitates the CPC464, CPC664, and CPC6128 models. By recreating the operations of all hardware components at a low level, the emulator achieves a high degree of compatibility with original CPC software. These programs or games can be run unmodified at real-time or higher speeds, depending on the emulator host environment. .......................................................................... USAGE ~~~~~ This is considered and alpha release, as the emulator in its current state lacks a lot of user friendliness (i.e. it lacks a graphical user interface). Open cap32.cfg in a text editor (Notepad for example) and edit values as necessary. Refer to the next section for an explanation of what it all means. Make especially sure the rom path reference is correct otherwise the emulator will fail to start! To load a disk, snapshot or tape image simply specify the complete path to the file on the command line. You can pass more than one type of file at the same time - simply separate them with spaces. Paths and filenames that contain spaces need to be enclosed by quotes. .......................................................................... THE CONFIG FILE ~~~~~~~~~~~~~~~ [system] model Defines the CPC model to emulate CPC464, 664 or 6128 Range: 0-2 Default: 2 ram_size RAM size in 64K increments Range: 64-576 Default: 128 speed emulation speed in 25% increments Range: 2-32 Default: 4 keyboard keyboard layout to use Range: 0 = original CPC 1 = French CPC 2 = Spanish CPC Default: 0 [video] scr_width width of video mode to use for fullscreen display Range: 320- Default: 800 scr_height height of video mode to use for fullscreen display Range: 200- Default: 600 scr_bpp bits per pixel of video mode to use Range: 8,15,16,24,32 Default: 8 scr_style rendering style Range: 0 = scanlines 1 = normal size, no scanlines 2 = double width 3 = half size 4 = half size with hardware flip 5 = Super Eagle 6 = Scale2x 7 = Advanced Scale2x 8 = TV 2x 9 = bilinear filter (in software) 10 = bicubic filter (in software) 11 = dot matrix 12 = OpenGL, no scanlines 13 = OpenGL, 25% scanlines 14 = OpenGL, 50% scanlines 15 = OpenGL, 75% scanlines 16 = OpenGL, 100% scanlines Default: 0 scr_oglfilter controls whether or not to apply filtering in OpenGL modes Range: 0-1 Default: 1 scr_fps controls FPS counter display Range: 0 = hide 1 = show Default: 0 scr_tube colour or green (monochrome) monitor Range: 0 = colour 1 = green Default: 0 scr_intensity colour intensity control Range: 5-15 Default: 10 scr_remanency blends the last and current frame together to reduce screen flicker in apps/demos that flip screens quickly to simulate more colours Range: 0-1 Default: 0 scr_window start in windowed or fullscreen mode Range: 0 = fullscreen 1 = window Default: 1 [sound] enabled control sound emulation Range: 0-1 Default: 1 playback_rate sound playback frequency in kHz Range: 0 = 11025 1 = 22050 2 = 44100 3 = 48000 4 = 96000 Default: 2 bits bits per sample Range: 0 = 8 1 = 16 Default: 0 stereo mono or stereo output Range: 0 = mono 1 = stereo Default: 1 volume sound volume in percent Range: 0-100 Default: 80 pp_device controls emulation of the DigiBlaster on the CPC printer port Range: 0-1 Default: 0 [control] kbd_layout the PC keyboard layout Range: 0 = US 1 = French 2 = Spanish Default: 0 [file] drvA_path path to a DSK file, or PATH+ZIP for a ZIPped up DSK drvA_file name of the DSK file drvA_zip indicates whether or not we're dealing with a compressed DSK image Range: 0-1 .......................................................................... KEYS ~~~~ F1 switch between windowed / fullscreen mode Ctrl+F3 PLAY button on virtual tape deck F5 reset Ctrl+F8 toggle joystick emulation on / off F10 quit F12 toggle regular / full speed Ctrl+F12 show / hide FPS (Frames Per Second) counter .......................................................................... SOURCE CODE AVAILABILITY ~~~~~~~~~~~~~~~~~~~~~~~~ The most recent source code release is always available from the Caprice32 project page on SourceForge.net - see the URL at the top. .......................................................................... COMMENTS OR READY TO CONTRIBUTE? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you have suggestions, a bug report or even want to join the development team, please feel free to use one of the many contact methods presented on the Caprice32 project page on SourceForge.net - see the URL at the top.