" />
Configuration ACE configuration can be modified using the tool types when launched through Ambient, or by using simple arguments from a CLI. Once launched, most of the main configuration options remain accessible using the "Preferences" menu. Tool types/Arguments : * RS=RAMSIZE/K/N : choose the size of the CPC memory. 64KB is the minimum and 576KB the maximum (64KB of main memory plus 512KB of expansion memory). Default value is 128KB (just like a stock Amstrad CPC6128). * FW=FIRMWARE/K : choose the firmware ROM to use. It must point to a binary ROM file of 16384 bytes max (or 16512 bytes if the Amsdos header is included). By default the firmware ROM matching your system's locale settings is used (PROGDIR:ROMs/Firmware_f3.ROM for French, PROGDIR:ROMs/Firmware_s3.ROM for Spanish, and PROGDIR:ROMs/Firmware_v3.ROM for any other locale). * BAS=BASIC/K : choose the BASIC ROM to use. It must point to a binary ROM file of 16384 bytes max (or 16512 bytes if the Amsdos header is included). Warning: not any BASIC ROM is compatible with any firmware ROM! You must use BASIC 1.0 for v1 firmware, BASIC 1.1 for v2 and BASIC 1.2x for v3. By default PROGDIR:ROMs/Basic_v1.23.ROM is used (it is the latest BASIC ROM available for the Amstrad CPC6128). * ROM0/K : choose the extension ROM #0 to use. This ROM must be a bootable ROM which will replace the default BASIC at boot time. It must then be a background ROM (such as another BASIC, a CP/M or a Hacker). By default none is installed. * ROM1/K : choose the extension ROM #1 to use. By default none is installed. * ROM2/K : choose the extension ROM #2 to use. By default none is installed. * ROM3/K : choose the extension ROM #3 to use. By default none is installed. * ROM4/K : choose the extension ROM #4 to use. By default none is installed. * ROM5/K : choose the extension ROM #5 to use. By default none is installed. * ROM6/K : choose the extension ROM #6 to use. By default none is installed. * ROM7/K : choose the extension ROM #7 to use. This ROM is historically the disc ROM of the CPC. To avoid compatibility problems with some softwares you should always configure a disc ROM at this slot (the bundled CP/M ROM or the PARADOS replacement ROM). By default none is installed but the tool type is set in the default icon and points to the CP/M ROM just like on a stock CPC664/CPC6128. * ROM8/K : choose the extension ROM #8 to use. By default none is installed. * ROM9/K : choose the extension ROM #9 to use. By default none is installed. * ROM10/K : choose the extension ROM #10 to use. By default none is installed. * ROM11/K : choose the extension ROM #11 to use. By default none is installed. * ROM12/K : choose the extension ROM #12 to use. By default none is installed. * ROM13/K : choose the extension ROM #13 to use. By default none is installed. * ROM14/K : choose the extension ROM #14 to use. By default none is installed. * ROM15/K : choose the extension ROM #15 to use. By default none is installed. * A=DRIVEA/K : choose the disc image file to preload in drive A. * B=DRIVEB/K : choose the disc image file to preload in drive B. * SNA=SNAPSHOT/K : choose the snapshot file to preload into the CPC. * CPR=CARTRIDGE/K : choose the cartridge file to preload into the CPC+ (in CPC+ emulation mode only). * PLUS=CPC+=AMSTRADPLUS/S : activate the CPC+ emulation at start-up. CRTC type 3 and Gate Array version 40489 will be automatically selected and CRTC and GATEARRAY options are ignored. * CRTC/K/N : choose the type of CRTC to use. You can change the type of CRTC at anytime while the emulator is running. Please note that at the moment only CRTC 1 is fully supported, CRTC 0 is just some compatible mode and the other CRTC types are not emulated at all. By default CRTC 1 is used. * GATEARRAY/K/N : choose the version of the Gate Array to use (possible values are 40007, 40008 or 40010). You can change the version of the Gate Array at anytime while the emulator is running. By default the Gate Array 40010 is used (the latest one). * BRAND=MANUFACTURER/K : choose the brand of the CPC to emulate. All the manufacturers planed by Amstrad are possible (ISP, Triumph, Saisho, Solavox, Awa, Schneider, Orion and Amstrad). By default Amstrad is used, except for German speaking countries where Schneider is used. * 64K=64KEXPMEMSCHEME/K : activate the emulation of a 64Kio-based model (basically a CPC464, CPC664 or 464 plus). On these models the main RAM is switched rather than the extension RAM when using non-existing memory pages. * EP=EMULATEPRINTER/S : by default ACE does nothing with the data sent to the printer port the the emulated CPC. This option activates the data capture to a file (by default it is stored into PROGDIR:Log/ACE_printer.log). You can change the file name with the option PRINTERFILE. * PF=PRINTERFILE/K : choose the printer data capture file name. * DB=DIGIBLASTER/S : activate the emulation of a Digiblaster/Soundplayer connected to the CPC. This option is disabled by default because the Digiblaster connects to the printer port; it can produce noise in the sound when it is initialized/used (which is often the case). The Digiblaster can be (un)plugged at anytime while ACE is running. It is a good choice only to plug it when required. * LD=LIGHTDEVICE/K : activate the emulation of a light gun device through the mouse pointer. Two models are handled, the Magnum Light Phaser and the le Trojan Light Phazer (CPC+ specific). Use the argument MagnumLightPhaser or TrojanLightPhazer to select the one you expect. The light gun can be (un)plugged at anytime while ACE is running. It is a good choice only to plug it when required. * DKB=DKTRONICSBUGS/K : activate the emulation of the DK'Tronics bugs. When using a DK'Tronics the upper ROM is visible in the area &4000-&7FFF instead of &C000-&FFFF if it is switched on while RAM pages &4000-&7FFF and &C000-&FFFF are swapped (&C3 mode of the Gate Array) and the shadowing of the RAM by I/O ASIC page of the Amstrad Plus is not handled. * THD=TAPE2HD/S : activate the tape to hard disc wrapper which allows you to directly access the files of your hard disc from the CPC operating system through the tape interface (by default you will have access to the files from PROGDIR:Share). You can change the shared directory using the option TAPE2HDPATH. This wrapper can be activated/deactivated at anytime while ACE is running. * TAPE2HDPATH/K : choose the shared directory through the tape to hard disc wrapper. By default "PROGDIR:Share" is used. * AV=AUDIOVOLUME/K/N : choose the start-up sound volume. The volume can be changed at anytime while ACE is running. By default the volume is at 100%. * AU=AHIUNIT/K/N : choose the AHI unit to use. By default ACE uses unit 0. * NAF=NOAUDIOFILTER/S : by default ACE filters out the frequencies from the PSG (Programmable Sound Generator) which are not in the audible audio spectrum (the PSG, aka AY-3-8912, can indeed create sounds up to 62.5kHz whereas the human ear can only hear frequencies up to 20kHz). Such sounds cannot be sampled by the audio sound card that might produce bad artefacts (because of aliasing). If you really have some professional sound card or if you prefer to rely on the AHI driver filters, you can disable the embedded filter with this option (generally not a good idea). * NS=NOSOUND/S : by default ACE plays sounds. This option disable the sound at start-up. You can change the sound state at anytime while ACE is running. * FULL=FULLSCREEN/S : switch ACE to full screen mode at start-up. Full screen mode can also the switched on/off at anytime while ACE is running. * ID=SCREENMODE/K/N : by default ACE clones Ambient screen to open its own screen in full screen mode; it is generally what you expect. Anyway, you can specify a mode ID to use instead. It can be useful if your screen supports 50Hz (or 100Hz) frame rate that you want ACE to use in order to have a smoother display (most CPC games and demo are running at 50Hz). * NO=NOOVERLAY/S : by default ACE tries to use overlay mode. This option tells ACE not to do so. Generally overlay should always be preferred because it is faster and it looks better. Moreover, the software rendering (without overlay) is limited and should only be used as a last chance. The overlay mode can also be activated/disabled at anytime while ACE is running. * NOWARN=NOWARNINGS/S : by default ACE displays warning messages when bad DSK or SNA files are loaded. This option disable these messages. * OSC=OFFSCREENCOLOR/K/N : when ACE is running windowed or in full screen mode with a ratio different from the real CPC screen, some margins are automatically added at the top/bottom or left/right of the display to ensure the original CPC pixel ratio. With this option you can choose the color of this border in the form of a 24 bit RGB value. By default it is a dark grey (0x181820). * SLC=SCANLINECOLOR/K/N : when overlay rendering is disabled, a very slow software rendering is used. You can specify here a 24 bits RGB value to use to fill the odd lines instead of duplicating the even lines into them. The display will be twice as fast. This option had no effect in overlay mode. * KJ=KEYJOY/S : set this option to use the keyboard instead of a real joystick 0 ("up", "down", "left", "right", "control" (fire 2), "left alt" (fire 1), and "left shift" (fire 3) are used). This option can be activated/disabled at anytime while ACE is running. * WS=WILDSPEED/S : disable the accurate speed emulation limit for a real CPC. In this wild mode, the emulator runs at the maximum possible speed on your computer. However, the relative speed of the emulated CPC chipsets remains accurate and the emulation quality is not altered. This mode can be activated/disabled at anytime while ACE is running. * MR=MAXFRAMERATE/K/N : specify the maximum frame per second to display in wild speed mode. The greater is this value the slower the wild speed will be because the display update is very CPU consuming. Also, note that values greater than the refresh frequency of your monitor (generally 60Hz) are useless. The default value is 10. This option has no effect if the wild speed mode is not activated. * FD=FASTDRIVES/S : active the fast drive emulation mode of the floppy disc drives. Track and sector access are done with no delay which makes the disc read/write operation faster. Warning: this option must be used with care because it is not compatible with some protected softwares and demos. This fast drive mode can also be activated/disabled at anytime while ACE is running. * CKR=CARTRIDGESKEEPEXTROM/S : disable the automatic deactivation of the extension ROMs when a CPC+ cartridge is inserted. This deactivation prevents problems with cartridges incompatible with extension ROMs. For some reason you might need to disable this behavior (i.e. when using the original system cartridge instead of the one emulated by ACE). * UBC=USERBREAKPOINTCOMMAND/K : choose a command to be executed every time at each encountered breakpoint. The placeholder "%s3 can be used in the command to retrieve the name of the AREXX port of ACE's instance. By default no command is executed. * DISCSPATH/K : choose the default path to the image disc files for the file requesters. By default "PROGDIR:Discs" is used. * SNAPSHOTSPATH/K : choose the default path to the snapshot files for the file requesters. By default "PROGDIR:Snapshots" is used. * CARTRIDGESPATH/K : choose the default path to the cartridges files for the file requesters. By default "PROGDIR:Cartridges" is used. * D=DEBUG/S : no effect in ACE public version.