Configuring E-UAE ================= E-UAE may be configured via options supplied in a plain-text configuration file. This configuration file contains options of the form = and each new option must begin a new line. Blanks lines are ignored, and lines beginning with a '#' character are treated as comments and thus also ignored. When E-UAE is started it tries to load a default configuration file. Where it looks for this file is platform-dependent, but typically it will look for a file called '.uaerc' in the current directory and (on multi-user platforms) in the user's home directory. On MacOS X, the default is called 'default.uaerc' instead since 'dot files' are not visible in Finder, the OS X file manager. You may tell E-UAE to load a configuration file in addition to the default by passing the '-f' switch to E-UAE on the command line. Any options found in this file will override the values of the same options in the default file. The '-s' switch may also be used to specify a single = option on the command line, which, again, will override options found in the default file. The default values for E-UAE's configuration options will cause E-UAE to emulate a 68000-based ECS system with 512 KB of Chip memory and 512 KB of Slow memory. The only option you absolutely need to specify is the path to the Kickstart image you want to use (unless you wish to use E-UAE's minimal Kickstart emulation, in which case you must instead supply the path to a floppy disk image to boot from). In the following descriptions of E-UAE's configuration options, the template refers to an integer value, to a value of 'true' or 'false', and refers to a file path using whatever conventions the host platform uses to specify paths. This document is a work-in-progress. Please note: this documentation was prepared for the PowerPC JIT implementation. There are some slight differences between the X86 and the PowerPC JIT compiler, therefore the configuration items are changed too. Please see the details below. General options =============== The following options all have a prefix of the form . The value of corresponds to the host platform on which you are running E-UAE. Target Platform ------ -------- amiga AmigaOS (and clones such as AROS and MorphOS) beos BeOS unix Unix-like platforms - including Linux and Max OS X .rom_path= Set the default path where Kernel ROM images may be found. The default is platform-dependent. Examples: unix.rom_path=/home/evilrich/UAE/roms/ .floppy_path= Set the default path where floppy disk images may be found. The default is platform-dependent. Examples: amiga.floppy_path=WORK:Apps/UAE/ADFs/ .hardfile_path= Set the default path where file-based hard disk images can be found. The default is platform-dependent. use_gui= (default=true) Open a configuration GUI at start-up before starting the emulation proper. This option is ignored on platforms without a configuration GUI or if E-UAE has been built without such a GUI. use_debugger= (default=false) Open the built-in debugger when the emulation starts. This option is ignored if E-UAE has been built without debugging support or if the debugger cannot be opened due to platform-specific restrictions (at the moment the debugger requires a terminal/console window, so it typically only works if you start E-UAE from a shell terminal). Host CPU-specific options ========================= x86.use_tsc= (default=true) On x86 machines, if this option is true then the processor's timestamp counter will be used for timing in E-UAE. This used to be a problem for machines which did power-saving by scaling down the CPU's clock frequency, but with E-UAE 0.8.28 and above this should no longer be an issue on Linux. If you are running E-UAE on some other x86 platform which does frequency scaling, then set this option to false. Performance will suffer, but at least timing won't be affected by changes in CPU frequency. amd64.use_tsc= (default=true) Same as the option above, but applies to AMD64 processors. ppc.use_tbc= (default=true) On PPC machines, if this option is true then use the processor's timebase register for timing in E-UAE. Since the PPC's TBC isn't affected by frequency scaling, this option is of little use and is supported only for completeness. It may be useful if E-UAE misdetects or miscalibrates your machine's timebase frequency (if it does, please let me know). CPU emulation options ===================== cpu_type= (default=68000) Select model of 68k processor to emulate. Valid values for are 68000, 68010, 68ec020, 68ec020/68881, 68020, 68020/68881, 68040 and 68060. Note: 1) The values '68ec020' and '68ec20/68881' correspond to the 68020 model with a 24-bit address bus (as found in the A1200). Zorro III memory and/or a RTG graphics card cannot be emulated. 2) The values '68ec020/68881' and '68020/68881' correspond to an 020 with a 68881 floating point co-processor. 3) The 68060 emulation is incomplete and not yet useful. cpu_speed= (default=real) configures the performance of the interpretive CPU emulation relative to the Amiga chipset. This may have the value 'real', 'max' or can be an integer between 1 and 20. If set to 'real', E-UAE will try to emulate the performance of an original 7MHz 68000-based Amiga such as an A500. That is, the relative balance of time spent emulating the CPU and the Amiga chipset will be similar to the performance of a real Amiga and E-UAE will try do the same amount of CPU work per display frame as a real 68000-based Amiga. Additionally, if any time is left over after emulating the A500's CPU and chipset in each display frame, then E-UAE will wait until until the next display frame is due. Thus, the setting 'real' is recommended for games designed to run on an A500-class Amiga but which won't work on faster Amigas. This includes many classic Amiga games. If set to 'max', the CPU emulation will run at the maximum speed that the host CPU can achieve. E-UAE will spend as much time as it can emulating the 68000 CPU and will not wait at all per frame. Integer values for adjust the relative amounts of time devoted to the CPU and custom chip emulations. Lower values increase the speed of the CPU emulation at the expense of the custom chips; higher values do vice-versa. Adjusting this value may allow better performance with some software. For example, when running Workbench on an RTG screen, better performance can be achieved from the interpretive emulation with a low value for 'cpu_speed'. finegrain_cpu_speed= (default=N/A) This option adjusts the relative speeds of the CPU and custom chip emulations just like supplying an integer value in cpu_speed= does, but it allows a more precise setting of the balance. The value corresponds to the value supplied in cpu_speed= multiplied by 512. cpu_compatible= (default=false) If enabled, E-UAE will use a slower but more compatible version of the CPU emulation. This may be necessary to run some some demos and games correctly. This option currently only applies when emulating a plain 68000 CPU. cpu_cycle_exact= (default=false) If enabled, E-UAE will employ a CPU emulation which tries to fully emulate the relative timing of CPU and chipset cycles. This is much more demanding even than the "compatible" CPU emulation, but more accurate - and so may be necessary to correctly run software which aggressively uses the Amiga chipset. This option only applies when emulating a plain 68000 CPU. JIT compiler options ==================== The following options configure the dynamically-recompiling CPU emulation (or JIT compiler). The JIT engine translates 68k instructions for the Amiga CPU directly into instructions for the host CPU and caches these translated instructions in host memory. It's thus much faster than the interpretative emulation, but it may be less compatible with some software. Notes: 1) The JIT is currently only supported on PPC host systems. 2) Direct memory access in JIT compiled code (a method used to speed up memory access when using the JIT - this has nothing to do with hardware DMA) is currently not implemented, the options for this feature were removed from the emulation. 3) You must emulate a 68ec020 CPU or better to be able to use the JIT compiler. The JIT compiler is depending on the availibility of the processor cache. 4) To enable direct memory access in compiled code, you must emulate a 32-bit CPU, e.g., a full 68020, or a 68040. Currently direct memory access is experimental, probably will fail. cachesize= (default=0) Use a cache of KBs for storing code generated by the JIT compiler. If set to 0, the JIT compiler will be disabled. Setting this option between 1024 and 8192 (i.e., 1 to 8 MB of cache) should allow the best performance. comp_optimize= (default=true) If true, try to optimize the compiled code and remove the unused instructions, flag emulation code. Please note: the optimization is not working properly, it might or might not work at the moment. comp_constjump= (default=true) If true, use indirect jumping for constant jumps (slower). Please note: this must be set to true at the moment. comp_trustbyte= (default=indirect) comp_trustword= (default=indirect) comp_trustlong= (default=indirect) How to access the emulated memory from the compiled code: direct - use direct memory access, avoid indirections. This is the fastest way, but it relies on the detection of the required indirection. indirect - use indirect memory access, slow, but safe. The indirect memory access makes sure that the custom chips are getting the required emulated access when needed. It also makes sure that the emulator won' try to access any random address on the host machine (and probably crash instantly). indirectKS - same as the indirect mode, except for the Kickstart addresses which will access memory directly. Same problems might apply as the direct memory access. afterPic - use direct memory access after Picasso96 was initialized. comp_flushmode= (default=hard) Specifies how the already compiled blocks should be handled, when the processor cache flush mode is executed on the emulated processor: soft - mark all compiled blocks for recalculating the checksum and recompile only if the checksum has changed when the block is executed next time. hard - remove all previously compiled block and reset the code cache. By setting the flush mode to soft it is possible to avoid the recompiling of all blocks when the blocks were not changed after the cache flush. Some programs execute global cache flush too regularly, the soft-flush mode might help gain some performance. On the other hand, the checksum calculation is very simple to lower the effort for producing checksum for each block. It could happen that the block is changed in a specific way and the new checksum matches the previously calculated one. In this case the block won't be recompiled according to the new memory content and the program will misbehave. Please note: this option has no effect on the current PowerPC JIT implementation. comp_log= (default=false) If true, additional JIT compiling related logs will be emitted to the console. Please note: excessive amount of logs will be dumped to the console, I suggest to redirect it into a file. The logging will slow down the emulation. comp_log_compiled= (default=false) if true, dump the macroblock data and the compiled code to the console. Please note: HUGE amount of logs will be dumped to the console, I suggest to redirect it into a file. The logging will slow down the emulation significantly. Chipset options =============== chipset= (default=ecs_agnus) Specifies the model of Amiga chipset to emulate. Valid value for type are: Type Description ---- ----------- ocs The original Amiga chipset, as found in the A1000, A500, etc. ecs_agnus The OCS chipset, but with the ECS or "Fat" Agnus. ecs The full ECS chipset, as found in the A500+ and the A600. aga The AGA chipset, as found in the A1200 and A4000. ntsc= (default=false that is, PAL) If enabled, the NTSC variant of the chipset model is emulated. If disabled, the PAL variant is emulated. immediate_blits= (default=false) If enabled then blits performed by the Amiga chipset emulation will be reported as finishing immediately. This may improve performance at the price of compatibility. This option is ignored in cycle-exact mode. collision_level= (default=playfields) Specifies the level of collision-detection performed by the Amiga chipset emulation. Valid values for are Type Description ---- ----------- none No collision-detection is emulated. sprites Sprite-to-sprite collisions are detected. playfields Sprite-to-sprite and sprite-to-playfield collisions (that is collisions of sprites with the background) are detected. full Full collision-detection (including collisions between the background and itself). The table above is ordered by the amount of work required to do the emulation. Thus, emulating just sprite-to-sprite collisions is faster than also emulating playfield collisions which is faster than full collision-detection. Full collision-detection is rarely required by software and much software (even games) will work with collision-detection disabled. ROM options =========== kickstart_rom_file= The file path of a Kickstart ROM image to load. may either be an absolute path or a path relative to the current directory when E-UAE was run. The token '$(FILE_PATH)' at the start of a path will be expanded to the path specified by the .rom_path= option. If is empty, E-UAE will use its built-in Kickstart emulation rather than a real Kickstart image. This requires a valid floppy disk to boot from mounted in the emulated DF0: drive. The Kickstart emulation is sufficient to play many classic Amiga games. Examples: kickstart_rom_file=/home/evilrich/UAE/ROMs/kick130.rom kickstart_rom_file=../shared/roms/kick310.rom kickstart_rom_file=$(FILE_PATH)/kick.rom kickstart_key_file= Kickstart ROM images provided by Cloanto in its Amiga Forever distribution are encrypted. This option specifies the key file required to decrypt such an image. may either be an absolute path to the ROM key file or a path relative to the current directory when E-UAE was run. The token '$(FILE_PATH)' at the start of a path will be expanded to the path specified by the .rom_path= option. Examples: kickstart_key_file=~/rom.key kickstart_ext_rom_file= The ROM images required to emulate a CDTV or CD32 are available as two files: a standard image (loaded via the kickstart_rom_file= option above) and an 'extended' image. This option specifies the file path of an extended ROM image to load. may either be an absolute path or a path relative to the current directory when E-UAE was run. The token '$(FILE_PATH)' at the start of a path will be expanded to the path specified by the .rom_path= option. If E-UAE has been compiled without support for emulating the CDTV or CD32, then this option will be ignored. cart_file= The path of a cartridge ROM to load. This is used to load a ROM image from an Action Replay cartridge. kickshifter= (default=false) If enabled, the Kickstart ROM image will be patched after it is loaded into memory to support the running of Shapeshifter, the software-based classic Mac emulation for AmigaOS, within E-UAE. RAM options =========== chipmem_size= (default=1, that is, 512 KB) Emulate * 512 KB of Chip memory (memory that is accessible by the Amiga chipset). The valid range of values for is between 1 and 16, that is, from 512 KB to 8 MB. Note that E-UAE must emulate an ECS ("Fat") Agnus to be able to use 1 MB of Chip memory or more. Also note that Fast memory cannot be used if you select more than 2MB of Chip memory. Example: chipmem_size=2 would provide 1 MB of Chip memory. bogomem_size= (default=2, that is, 512 KB) Emulate * 256 KB of "Slow" memory. The valid range of values for is 0, 2, 4 and 7, that is 0 KB, 512 KB, 1 MB and 1.8 MB, respectively. If AGA emulation is enabled, then the maximum is 1 MB. "Slow" memory is the type of memory provided by the A500 trapdoor slot. It cannot be accessed by the Amiga chipset like Chip memory, but, unlike Fast memory, this memory cannot be accessed by the CPU when the custom chipset is busy - hence the term "Slow". Some old games and demos may require this type of memory. If E-UAE reports strange exceptions occuring when booting a floppy or weird accesses to custom chip registers, then try adding some "Slow" memory. Really old games may fail when "Slow" memory is added. fastmem_size= (default=0) Emulate MB of Zorro II Fast memory. This is type of memory found on memory expansions cards for the A2000 and the A1200 trapdoor slot. z3mem_size= (default=0) Emulate MB of Zorro III Fast memory. E-UAE must emulate a 32-bit CPU (a 68020 or better, not an 68ec020) to support the emulation of Zorro III memory. gfxcard_size= (default=0) Emulate an RTG graphics card with MB of graphics memory. Selecting greater than 0, enables the graphics card or so-called 'Picasso96' emulation. A maximum of 32 MB of graphics card memory may be emulated. E-UAE must emulate a 32-bit CPU (a 68020 or better, not an 68ec020) to support the graphics card emulation. Floppy drive options ==================== In the following options, the template specifies the emulated drive number. Up to four floppy drives may be emulated, numbered 0 to 3, corresponding to the AmigaDOS devices DF0: to DF3:, respectively. Drive 0 is the first drive, and drive in which you would typically insert a floppy disk to boot from. E-UAE supports file-based images of Amiga floppy disks in a number of different file formats (see floppies.txt). floppy= Specifies the path of a floppy disk image to mount in drive DF:. may either be an absolute path or a path relative to the current directory when E-UAE was run. The token '$(FILE_PATH)/' at the start of a path will be expanded to the path specified by the .floppy_path= option. floppytype= (default=0 for drives 0 and 1, -1 for drives 2 and 3) Specifies the type of disk mounted in the emulated for drive DF:. may have the following values Type Disk type ---- --------- 0 A 3.5" double-density disk. This is the disk type supported by standard Amiga floppy drives. Such disks have a capacity of 880 KB when formatted under AmigaDOS. 1 A 3.5" high-density disk. This type of disk was supported by some add-on Amiga drives and in the drives shipped with some A4000s. A high-density disk formatted under AmigaDOS has a capacity of 1.76 MB. 2 A 5.25" single-density disk. This disk type is for legacy compatibility and was rarely used by real Amigas. This option may also be set to -1 to disable the drive. floppysound= (default=1) Specifies floppy drive sound emulation type. may have the following values Type Sound type ---- ---------- -1 Floppy sound emulation is on: use external samples. See floppysoundext configuration below. 0 Floppy sound emulation is off. 1 Floppy sound emulation is on: use internal samples. floppysoundext= These configuration items have effect only if floppysound is set to -1 for the same drive. (See above.) The format of the provided sample files is: WAV. specifies the name of the sample package: On AmigaOS4: Specifies the directory path to the external floppy sound samples. Sample names for the floppy sound emulation are: drive_click.wav, drive_spin.wav, drive_spinnd.wav, drive_startup.wav, drive_snatch.wav On other operating systems: Specifies the suffix to the sample file names. The sample files must be copied into the startup directory, under "uae_data" folder. The base name of the sample files (without any suffix) are: drive_click_, drive_spin_, drive_spinnd_, drive_startup_, drive_snatch_ floppy_speed= (default=100) E-UAE's floppy drive emulation will work at per cent of a real Amiga floppy drive (relative to the speed of the rest of the emulation). Valid values are from '100' to '800', that is 1x to 8x the speed of a standard Amiga floppy drive. Setting 'floppy_speed=' to values other then 100 may affect compatibility with Amiga software, especially the floppy-based copy-protection systems included with some games. Hard disk options ================= E-UAE may emulate hard drive partitions (AmigaOS volumes) or full, partitionable hard disks. Two basic types of emulation are supported: the virtual filesystem and the hard file. A virtual filesystem is a directory on the host system mounted as a virtual AmigaOS volume. The main advantages of a virtual filesystem are ease of use (no special setting-up is required) and the fact that both the host system and the emulated environment can access it at the same time (although this is not guaranteed to be safe, especially if host and emulated environment write to a directory simultaneously). A hard file is a file containing the raw image of a real AmigaOS filesystem or disk (an image of a partitionable disk is known as an "RDB" filesystem). A hard file is not so easy to set up, but provides faster access than a virtual filesystem and is more compatible with AmigaOS software (it can be formatted with any AmigaOS filesystem, de-fragmented, etc. just like a real Amiga partition). An RDB hard file can even be partitioned just like a real Amiga disk. filesystem2=,::, Mounts the host directory specified by the path as a virtual filesystem under AmigaOS with the volume name and a faked device name of . The volume will have the boot priory . The token specifies whether the volume is writable. If this is set to 'rw' then the device is writable; if it's 'ro' then the volume is read-only. Examples: filesystem2=rw,DH0:System:/home/evilrich/UAE/System,1 Mounts the directory /home/evilrich/UAE/System as the volume 'System' and AmigaDOS device 'DH0:' with a boot priority of 1. This volume can be written to. filesystem2=ro,CD0:CD0:/cdrom,0 Mount the host directory /cdrom as volume 'CD0:' and device 'CD0:' with boot priority 0. This volume may not be written to. filesystem=,: This is an older and simpler form of the filesystem2= option. You can use both the filesystem2= and filesystem= options to specify the same volume (for instance, for compatibility with older versions of UAE), but the filesystem= option must be after the filesystem2= option in the config file. hardfile2=,:,,,,,, Mount the hard file (partition or drive image) . The token specifies whether the hard file is writable. If it has the value 'rw', then the hard file is writable; if it is 'ro', then it's not writable. If the specified hard file is a partition image, then the partition will be mounted on the AmigaDOS device (the volume name will be taken from the filesystem that the partition contains). For a hard file containing a partition image, the geometry of the partition must be specified. = the number of sectors per track = the number of heads or surfaces on the disk (typically 1) = the number of reserved blocks at the start of the partition (typically 2). = the number of bytes per block (typically 512). specifies the boot priority of the volume. is optional and specifies a host path to locate the AmigaOS filesystem handler to use to mount this image. This option is useful when you wish to mount a volume that has been formatted with a filesystem not present in Kickstart - for example, SFS or PFS. If the specified hard file is an RDB hard file, that is, it's the image of a partitionable hard drive, you do not need to specify the geometry (the RDB - the Rigid Disk Block - in the hard file itself specifies the geometry). If is 0, then the hard file is assumed to be an RDB hard file. All other components of the hardfile2= option will be ignored apart from and . Examples: hardfile2=rw,DH1:/home/evilrich/myhardfile,32,1,2,512,1, hardfile2=rw,:/home/evilrich/rdbimage,0,0,0,0,0, Display options =============== The following options configure the emulation of native Amiga screenmodes (displays generated by the built-in Amiga chipset - not of display generated by Picasso96). Todo: need some general blurb about how Amiga screens are output, resolution, etc. gfx_framerate= (default=1) Specifies the rate at which display frames are rendered when emulating graphics output from the Amiga chipset. can be a number between 1 and 20, where 1 means that every display frame is rendered and 20 means only 1 in every 20 frames is rendered. Increasing increases the speed of emulation (there's less work to do), but decreases the quality of the display output. For example, when emulating a PAL display (50 Hz), for full-quality output (gfx_framerate=1), E-UAE must update its display 50 times a second. Setting gfx_framerate=4 will cause E-UAE to draw only 1 frame in 4 and thus its display will updated only 12.5 times a second. gfx_width_windowed= (default=720) gfx_height_windowed= (default=568) gfx_width_fullscreen= (default=800) gfx_height_fullscreen= (defaullt=600) Specify the dimensions of the E-UAE display for graphical output from the Amiga chipset. Ideally, the gfx_*_windowed options should specify the dimensions when E-UAE is running in a window on your desktop and the gfx_*_fullscreen options will apply when running full-screen. However, this is not supported yet, and E-UAE will use the gfx_*_windowed dimensions in both windowed and full-screen modes. To emulate a high-resolution, fully overscanned PAL screen - either non-interlaced with line-doubling, or interlaced - you need to use a display of at least 720 by 568 pixels. If you specify a smaller size, E-UAE's display will be clipped to fit (and you can use the gfx_center_* options - see below - to centre the clipped region of the display). Similarly, to fully display an over-scanned lo-res PAL screen, you need a display of 360 by 284 pixels. gfx_width= gfx_height= These option are for backwards-compatibility and have been superceded by the gfx_*_windowed and gfx_*_fullscreen options above. gfx_fullscreen_amiga= (default=false) E-UAE will open it's display for Amiga screens in full-screen mode by default - not as a window on the desktop. This option is not supported on all platforms. gfx_lores= (default=false) Determines the fundamental horizontal resolution of output. If true, then E-UAE will emulate a low-resolution output; high-res Amiga screens will have their horizontal resolution halved (only every other horizontal pixel will be drawn). If false, E-UAE will emulate a high-resolution output; low-resolution Amiga screens will have their horizontal resolution doubled. Most classic games employ low-resolution screens; Workbench uses a high-resolution screen by default. gfx_linemode= (default=double) Determines how many times each display line is drawn. Valid values for are: Type Description ---- ----------- none Each line is drawn once. double Each line is drawn twice. scanlines Each line is drawn once followed by an black line. gfx_correct_aspect= (default=false) If set to true and the emulated Amiga screen has a larger vertical size than the display window, E-UAE will fit the screen to the display by leaving out certain lines. This is useful, for example, if you wish to fit a 640x512 Amiga screen into a 640x480 window. Don't use the option with gfx_linemode=scanlines. It'll look ugly. gfx_center_horizontal= (default=none) If the Amiga screen emulated is wider than the E-UAE display, then this option will try to cause the screen to be rendered centred on the display. Type Description ---- ----------- false/none No centring will be performed. true/simple Simple centring will be performed. smart Smart centring will be performed. gfx_center_vertical= (default=none) Similar to gfx_center_horizontal, but centres the screen vertically within the E-UAE display. show_leds= (default=false) If true, show drive activity and power LEDs at the bottom right corner of the E-UAE display. hide_cursor= (default=true) If this option is set to true and E-UAE is displaying in windowed mode, then the host window manager's cursor is hidden; otherwise it is shown. This option may not be implemented on all platforms yet. Sound options ============= sound_output= Selects how native Amiga audio is emulated and output. Supported values for include: none - audio emulation is disabled. interrupts - audio emulation is enabled but audio output is disabled. normal - audio emulation is enabled and output enabled. exact - audio emulation is enabled and exact output enabled. sound_frequency= Selects the frequency of emulated audio output in Hertz. Typically, higher frequencies will require more work, but have better quality. The default is dependent on the host audio system used, but most will default to 44100 Hz (that is, CD-quality output). Typical values for include 11025, 22050 and 44100. sound_channels= The Amiga supports 4-voice stereo sound, with two channels output on the left channel and two on the right. This option selects how the Amiga's voices are output on the host audio system. Supported values for are: mono - monophonic output; all Amiga voices are output on a single channel. stereo - stereo output; two Amiga voices are output on the left channel and two on the right. mixed - stereo output; the four Amiga voices are mixed and output on both left and right channels. sound_latency= (default=100) Specifies the length of the audio buffer used by the audio emulation in microseconds independent of the other audio settings, and, hence, also the time lag between when a sample is played in the emulated Amiga environment and in the underlying host sound system (thus 'latency'). The default value of 100 ms attempts to strike a balance between acceptable latency and CPU usage. Larger values of may require less CPU time and lead to fewer drop-outs (gaps) in audio emulation, but will suffer increased latency (a latency of more than about 150ms becomes very noticeable). Smaller values will require more CPU power but reduce latency. Note that not all host sound systems will support arbitrary values of . For example, the Open Sound System will round the supplied value to one that corresponds to the nearest power-of-2 audio buffer size. sound_max_buff= From E-UAE 0.8.29, this option is obsolete and has been replaced by the option sound_latency. sound_interpol= (default=none) Selects the sound interpolation mode used for audio output (only supported when audio output is in 16-bit resolution). Interpolation is a technique which "smoothes out" the audio waveform generated by E-UAE and thus may lead to higher quality audio output. Supported values for are: none - no interpolation. rh - 'rh' method of interpolation is used. crux - 'crux' method of interpolation is used. sinc - 'sinc' meethod of interpolation is used. Input device options ==================== joyport0= Selects the method used to emulate the device attached to the Amiga joystick port 0 (the mouse port). none - no device is connected to this port. mouse - a mouse will be emulated on this port and input will be supplied from the host's default mouse (the device you use to move the mouse pointer on the host). joy0 - a joystick will be emulated on this port and input will be supplied from the first joystick found on the host. joy1 - a joystick will be emulated on this port and input will be supplied from the second joystick found on the host. kbd1 - a joystick will be emulated using the numeric keypad (8, 2, 4 and 6 are directions up, down, left and right, respectively, and 5 is the fire button). kbd2 - a joystick will be emulated using the cursor keys and the Right Ctrl key or Right Alt key for the fire button. kbd3 - a joystick will be emulated using the keys T, B, F and H for up, down, left and right, respectively, and the Left Alt key for the fire button. joyport1= Selects the method used to emulate the device attached to the Amiga joystick port 1 (the joystick port). Supported values for are the same as for the joyport0= option. SCSI emulation options ====================== E-UAE can provide direct access to a host optical drive like a CD-ROM drive to AmigaOS via an Exec device wrapper called uaescsi.device. The SCSI device emulation is not supported on all platforms. See the SCSI emulation section of the documentation for more details. scsi= (default=false) Enable or disabled the SCSI emulation. scsi_device= This option is used for passing a platform-specific configuration to the SCSI emulation layer. Network emulation ================= E-UAE can provide network access to AmigaOS applications via an emulated bsdsocket.library. This emulated bsdsocket.library is simply a wrapper around the host's networking stack. The AmigaOS environment within E-UAE will share the same IP address as the host. The bsdsocket.library emulation is not supported on all platforms. See the bsdsocket emulation section of the documentation for more details. bsdsocket_emu= (default=false) Enable or disable the bsdsocket.library emulation. X11-specific options ==================== The following options apply when E-UAE has been built with the X11 graphics driver. x11.map_raw_keys= (default=false) If true, the X11 driver maps raw host key codes to Amiga key codes; otherwise, the driver tries to map translated key codes, possible leading to poorer support for international keyboard layouts (see docs/keyboard.txt). For raw key-mapping to be supported, your X server must support the XKB extension. Also note that X keyboards that generate xfree86 key codes (typicallying PC and Mac keyboards with XFree86 or X.org servers) only are supported at the moment. x11.low_bandwidth= (default=false) If this option is set to true, then E-UAE will try to minimize the amount of data sent to the X server by only redrawing areas of the amiga screen that have changed. This may increase frame rate on slow machines or when running E-UAE on a separate host from the X server. x11.use_mitshm= (default=true) If this option is set to true, your X server supports the MITSHM extension and E-UAE is running on the same host as the server, then E-UAE will use memory shared between itself and the server for display buffers. This will increase display refresh speed. x11.hide_cursor= Deprecated. This option has been replaced by hide_cursor=. SDL-specific options ==================== The following options apply when E-UAE has been built with the SDL graphics driver. sdl.map_raw_keys= (default=false) If true, the SDL driver maps raw host key codes to Amiga key codes; otherwise, the driver tries to map translated key codes, possible leading to poorer support for international keyboard layouts (see docs/keyboard.txt). sdl.use_gl= (default=false) If true, the SDL driver uses OpenGL for display output. Depending on your OpenGL driver this may increase or decrease the speed of emulation. Note: This setting does not enable a OpenGL emulation for Amiga (e.g. Warp3D) but simply uses an OpenGL texture for the 2D Amiga and Picasso96 display. AmigaOS-specific options ======================== The following options apply when E-UAE has been built for AmigaOS (or similar platform) with the AmigaOS graphics driver. amiga.screen_type= (default=public) Specifies the type of screen that E-UAE will open it's display on. Valid values for are: Type Description ---- ----------- public The display will be a window on the default or named public screen. custom E-UAE will open a custom screen for its display. The best screenmode matching the configured dimensions will be used. ask E-UAE will present you with a requester to select the screenmode to use for display. If this requester is cancelled, E-UAE will use a window on the default or named public screen. amiga.publicscreen= Specifies the name of the public screen to open a window on. If is empty, the default public screen will be used. amiga.use_dither= (default=true) When displaying on a palette-mapped screen (that is, a screen with depth of 8 or less), dither output to compensate for lack of colour. amiga.use_grey= (default=false) When displaying on a palette-mapped screen (that is, a screen with depth of 8 or less), output in greyscale rather than colour. This option is particularly useful when displaying on a public screen with few free pens. amiga.use_overlay= (default=false) Use overlay screen if available. Currently the overlay screen feature is implemented on MorphOS Cybergraphix target only. ALSA-specific options ===================== The following options apply when E-UAE has been built with the ALSA audio driver. alsa.device= (default=default) Specifies the ALSA device to output to. The default value is 'default', which obviously uses the default ALSA PCM device. On recent ALSA installations, this may use ALSA's dmix plug-in (the dmix plug-in allows multiple applications to share an ALSA device for output) which may result in unacceptable latency and/or increased CPU load. If that is the case, add the option 'alsa.device=plughw:' to by-pass the dmix plug-in. See the libasound documentation for full details on how to specify ALSA devices. alsa.verbose= (default=false) If this options is set to true, the ALSA driver will log additional information about how it configures the specified ALSA device. This may help to diagnose problems with ALSA configuration, etc.