" /> ContentsIndex< BrowseBrowse >


    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.