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 <key>=<value> 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' 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 <key>=<value> 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 68020-based ECS system with 2 MB of Chip 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 the following descriptions of E-UAE's configuration options, the template
<n> refers to an integer value, <boolean> to a value of 'true' or 'false',
and <path> refers to a file path using whatever conventions the host platform
uses to specify paths.

This document is a work-in-progress.


General options
===============

The following options all have a prefix of the form <target>. The value of
<target> 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


<target>.rom_path=<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/


<target>.floppy_path=<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/


<target>.hardfile_path=<path>

  Set the default path where file-based hard disk images can be found. The
  default is platform-dependent.


use_gui=<boolean> (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=<boolean> (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.


CPU options
===========

cpu_type=<type> (default=68020)

  Select model of 68k processor to emulate. Valid values for <type> are
  68000, 68010, 68ec020, 68ec020/881, 68020, 68020/881, 68040 and 68060.

  Note:

  1) The values '68ec020' and '68ec20/881' 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/881' and '68020/881' correspond to an 020 with a
     68881 floating point co-processor.
  3) The 68060 emulation is incomplete and not yet useful.


cpu_speed=<speed> (default=max)

  <speed> 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. Thus, the setting
  'real' is recommended for games designed to run an A500.

  If set to 'max', the CPU emulation will run at the maximum speed that the
  host CPU can achieve.

  Integer values for <speed> 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=<n> (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 <n> corresponds to
  the value supplied in cpu_speed= multiplied by 512.


cpu_compatible=<boolean> (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=<boolean> (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 options
===========

  The following options configure the dynamically-recompiling CPU emulation
  (or JIT compiler). The JIT engine is much faster than the interpretative
  emulation, but may be less compatible with some software.

  Notes:

  1) The JIT is currently only supported on x86 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 only supported when hosting on x86 Linux.

  3) You must emulate a 68ec020 CPU or better to be able to use the JIT
     compiler.

  4) To enable direct memory access in compiled code, you must emulate a
     32-bit CPU, e.g., a full 68020, or a 68040.


cachesize=<n> (default=0)

  Use a cache of <n> 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.


Chipset options
===============

chipset=<type> (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=<boolean> (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=<boolean> (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.


fast_copper=<boolean> (default=true)

  To do.


collision_level=<type> (default=playfields)

  Specifies the level of collision-detection performed by the Amiga chipset
  emulation. Valid values for <type> 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=<path>

  The file path of a Kickstart ROM image to load. <path> 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 <target>.rom_path= option.

  If <path> 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=<path>

  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. <path> 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 <target>.rom_path= option.

  Examples:

  kickstart_key_file=~/rom.key


kickstart_ext_rom_file=<path>

  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.
  <path> 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 <target>.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=<path>

  The path of a cartridge ROM to load. This is used to load a ROM image
  from an Action Replay cartridge.


kickshifter=<boolean> (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=<n> (default=4, that is, 2MB)

  Emulate <n> * 512 KB of Chip memory (memory that is accessible by the Amiga
  chipset). The valid range of values for <n> 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=<n> (default=0)

  Emulate <n> * 256 KB of "Slow" memory. The valid range of values for <n>
  is 0, 2, 4 and 6, that is 0 KB, 512 KB, 1 MB and 1.5 MB, respectively.

  "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".


fastmem_size=<n> (default=0)

  Emulate <n> 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=<n> (default=0)

  Emulate <n> 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=<n> (default=0)

  Emulate an RTG graphics card with <n> MB of graphics memory. Selecting <n>
  greater than 0, enables the graphics card or so-called 'Picasso96'
  emulation. A maximum of 8 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 <drive> 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 support file-based images of Amiga floppy disks in a number of
different file formats.


floppy<drive>=<path>

  Specifies the path of a floppy disk image to mount in drive DF<drive>:.
  <path> 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 <target>.floppy_path=
  option.


floppy<drive>=<type> (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<drive>:.
  <type> 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.


floppy_speed=<speed> (default=100)

  E-UAE's floppy drive emulation will work at <speed> 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.

  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=<access>,<device>:<volume>:<path>,<bootpri>

  Mounts the host directory specified by the path <path> as a virtual
  filesystem under AmigaOS with the volume name <volume> and a faked device
  name of <device>. The volume will have the boot priory <bootpri>. The
  token <access> 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=<access>,<volume>:<path>

  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=<access>,<device>:<path>,<sectors>,<surfaces>,<reserved>,<blocksize>,<bootpri>,<handler>

  Mount the hard file (partition or drive image) <path>. The token <access>
  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 <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.

  <sectors>   = the number of sectors per track
  <surfaces>  = the number of heads or surfaces on the disk (typically 1)
  <reserved>  = the number of reserved blocks at the start of the partition
                (typically 2).
  <blocksize> = the number of bytes per block (typically 512).

  <bootpri> specifies the boot priority of the volume.

  <handler> 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 partionable 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 <blocksize> 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
  <path> and <access>.

  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 Amiga chipset - not of display generated by
Picasso96).

Todo: need some general blurb about how Amiga screens are output,
resolution, etc.


gfx_framerate=<n> (default=1)

  Specifies the rate at which display frames are rendered when emulating
  graphics output from the Amiga chipset. <n> 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 <n> 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=<n> (default=800)
gfx_height=<n> (default=600)
gfx_width_windowed=<n> (default=800)
gfx_height_windowed=<n> (default=600)
gfx_width_fullscreen=<n> (default=800)
gfx_height_fullscreen=<n> (defaullt=600)

  Specifies the dimensions of the E-UAE display. To do.
  (Note that, currently, E-UAE does not use the gfx_*_fullscreen options,
  even when the disply is full-screen.)


gfx_fullscreen_amiga=<bool> (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=<boolean> (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=<type> (default=scanlines)

  Determines how many times each display line is drawn. Valid values for
  <type> 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=<boolean> (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=<type> (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=<type> (default=none)

  Similar to gfx_center_horizontal, but centres the screen vertically within
  the E-UAE display.


show_leds=<bool>

  If true, show drive activity and power LEDs at the bottom right corner of
  the E-UAE display.


Sound options
=============

sound_output=<type>

  Selects how native Amiga audio is emulated and output. Supported values
  for <type> 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_bits=<n>

  Selects the resolution of audio output. <n> can be 8 or 16 for 8-bit and
  16-bit output, respectively. Most hosts will use 16-bit output and this
  will be the default.


sound_frequency=<n>

  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 <n> include 11025, 22050 and 44100.


sound_channels=<type>

  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 <type>
  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_max_buff=<n>

  Specifies the size of buffer used by the audio emulation (in bytes).
  Larger sizes generally lead to fewer drop-outs (gaps) in audio emulation,
  but increase the audio lag. The optimum value for <n> depends on the sound
  resolution and frequency and the default value will depend on the host
  audio system.

  A typical default is 8192 bytes. For 44100 Hz output at 16 bits, this
  would typically correspond to an audio buffer of about 100 ms - although
  different audio driver do interpret this option in different ways.

  This option really needs to be replaced with something more useful. ;-)


sound_interpol=<type> (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 <type> are:

  none - no interpolation.
  rh   - 'rh' method of interpolation is used.
  crux - 'crux' method of interpolation is used.


Input device options
====================

joyport0=<mode>

  Selects the method used to emulate the device attached to the Amiga
  joystick port 0 (the mouse 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=<mode>

  Selects the method used to emulate the device attached to the Amiga
  joystick port 1 (the joystick port). Supported values for <mode> 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=<bool> (default=false)

  Enable or disabled the SCSI emulation.


scsi_device=<config>

  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=<bool> (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.low_bandwidth=<bool> (default=false)
x11.use_mitshm=<bool> (default=true)
x11.hide_cursor=<bool> (default=true)

  To do.

SDL-specific options
====================

The following options apply when E-UAE has been built with the SDL graphics
driver.

sdl.map_raw_keys=<bool> (default=false)

  If true, enabled 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).

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=<type> (default=public)

  Specifies the type of screen that E-UAE will open it's display on. Valid
  values for <type> 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=<name>

  Specifies the name of the public screen to open a window on. If <name> is
  empty, the default public screen will be used.


amiga.use_dither=<bool> (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=<bool> (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.

