This file describes the video, sound, joystick, mouse and keyboard drivers used by the Advance programs.
The sections of this document are:
They always work in `fullscreen' output mode and generally support only a subset of video boards.
To function correctly these drivers require a correct configuration of the `device_video_*' options.
The `Generate' drivers are always the preferred choice.
They can work in `fullscreen' mode, `window' mode and `zoom' output mode using the video board hardware acceleration to stretch the image. The default output mode is `window' if you run the program in a window manager, otherwise the output mode `fullscreen' is chosen.
Please note that these drivers generally need to stretch the image losing a lot in image quality and speed.
These drivers don't require any `device_video_*' options because they cannot control how the video modes are generated.
All clocks, all RGB bit depths are available. This driver is generally able to synchronize with the vertical sync of the video mode.
To use these modes your video board must be supported by a `svgalib' driver listed in the `cardlinx.txt' file. To use this driver you need to install the SVGALIB library version 1.9.x.
To use this driver you need to correctly configure the SVGALIB HorizSync and VertRefresh options in the file /etc/vga/libvga.config file. You must use a range equal or a bit larger than the range specified with the AdvanceMAME `device_video_clock' option.
This driver is not available in X (when the environment DISPLAY variable is defined).
In the `contrib/svgalib' directory there are various SVGALIB patches to fix some problems with recent video boards, and to work with systems with kernel 2.6 and udev.
All clocks, all RGB bit depths are available.
This driver is able to use the Linux fb API to synchronize with the vertical sync of the video mode, but generally it isn't possible because the low-end drivers don't support this feature. Anyway, if you run the program as root it can use the standard VGA registers to detect the vsync. This is the major limitation compared with the svgalib driver.
To allow any user to run the program as root, you can use the following commands to change the executable permissions:
chown root:root /usr/local/bin/advmame chmod u+s /usr/local/bin/advmame |
To use this driver you must activate the Console Frame Buffer support in your Linux kernel.
This driver is not available in X (when the environment DISPLAY variable is defined).
The Frame Buffer device opened is `/dev/fb0' and `/dev/fb/0', you can change it setting the FRAMEBUFFER environment variable.
The generic Frame Buffer `vesafb' driver cannot be used because it doesn't allow the creation of new video modes. If it's your only option you can use it through the SDL library.
All clocks, all RGB bit depths are available.
To use these modes your video board must be supported by a `svgaline' driver listed in the `carddos.txt' file.
This driver is completely independent of the VGA/VBE BIOS of your board.
All clocks, all RGB bit depths are available.
To use these modes your video board must be supported by a `vbeline' driver listed in the `carddos.txt' file.
These drivers work setting a video mode using the default VBE2 services and tweak some hardware SVGA registers to modify the obtained video mode. The driver `vbe3' is an exception. It requires the presence of a VBE3 BIOS to change the frequency of the desired video mode. Unfortunately the standard VBE3 services don't support a resolution size change.
The resolution is changed modifying only the standard VGA registers. This hack may or not may works. Also the interlaced modes are only rarely supported by the various VBE3 BIOS because they are very rarely used in the standard PC monitors.
If your video board isn't supported by any drivers and you don't have a VBE3 BIOS you can try installing a software VESA BIOS like the SciTech Display Doctor.
Only the standard VGA pixel clocks 6.29, 7.08, 12.59, 14.16 MHz are available. Only 8 bit color modes. Only 64 kBytes of video memory.
This driver supports also text modes with pixel clocks 12.59, 14.16, 25.17, 28.32 MHz.
This driver is completely independent of the VGA BIOS of your board.
All clocks, all RGB bit depths are available.
To use these modes your video board must be supported by a `svgawin' driver listed in the `cardwin.txt' file.
To use this driver you need to install the included SVGAWIN driver. Please read the `svgawin.txt' file carefully.
This driver is experimental. At present it's only tested on Windows 2000 with a GeForce 2 board. It may not work will all the other boards.
It supports all RGB/YUY2 bit depths available. The output in the YUY2 modes is generally accelerated, and can be used to scale the video output to an arbitrary size. You can enable this feature with the `-device_video_output overlay' option.
You can change some options of this driver using the SDL specific environment variables described in the contrib/sdl/env.txt file.
It isn't able to use the hardware volume control of the sound card. The volume changes are simulated reducing the sample values.
It isn't able to precisely control the amount of bufferized samples. This means that it may add a small latency on the sound output.
You can change some options of this driver using the SDL specific environment variables described in the contrib/sdl/env.txt file.
The source patch and the library source can be downloaded from the MAME site:
|
http://www.mame.net/
|
More info is in the VSyncMAME page:
|
http://vsynchmame.mameworld.net/
|
It supports more than one keyboard at the same time.
You can change console with ALT+Fx. No other hotkeys are available. The hotkeys can be optionally disabled.
For an emergency keyboard restore you can use the emergency Linux SysRq key. Check:
http:///usr/src/linux/Documentation/sysrq.txt |
It supports only one keyboard.
You can change console with ALT+Fx and break the program with CTRL+C. No other hotkeys are available. The hotkeys can be optionally disabled.
For an emergency keyboard restore you can use the emergency Linux SysRq key. Check:
http:///usr/src/linux/Documentation/sysrq.txt |
It supports only one keyboard.
You can change console with ALT+Fx and break the program with CTRL+C. No other hotkeys are available. The CTRL+C hotkey can be optionally disabled. The ALT+Fx hotkeys are always enabled.
For an emergency keyboard restore you can use the emergency Linux SysRq key. Check:
http:///usr/src/linux/Documentation/sysrq.txt |
It supports only one keyboard.
You can change some options of this driver using the SDL specific environment variables described in the contrib/sdl/env.txt file.
In a Window Manager environment you can switch to fullscreen pressing ALT+ENTER.
It supports only one keyboard.
You can break the program pressing CTRL+C, CTRL+BREAK or ALT+CTRL+END.
It supports more than one joystick or light-gun at the same time.
For USB devices this driver doesn't require any configuration. It's able to autodetect all the present hardware.
This driver is also able to correctly report the type of devices found. You should for example expects to have the gas pedal mapped on the gas control of the game.
It can also be used with some custom devices connected at the Parallel Port. Details on how to build these custom interfaces are in the file:///usr/src/linux/Documentation/input/joystick-parport.txt file.
It has a special support for the ACT Light-gun to fix the wrong behavior of the light-gun when shooting out of screen.
The joysticks are searched on the /dev/input/eventX devices.
If you have a gameport joystick, the Linux Kernel Joystick driver may prevent a correct video vsync if the joystick polling is too slow. Generally it results in a missing frame every 5-10 seconds.
It supports up to 4 joysticks at the same time.
The joysticks are searched on the /dev/jsX and /dev/input/jsX devices.
If you have a gameport joystick, the Linux Kernel Joystick driver may prevent a correct video vsync if the joystick polling is too slow. Generally it results in a missing frame every 5-10 seconds.
It supports up to 4 joysticks at the same time.
The joysticks are searched on the /dev/jsX devices.
If you have a gameport joystick, the Linux Kernel Joystick driver may prevent a correct video vsync if the joystick polling is too slow. Generally it results in a missing frame every 5-10 seconds.
It supports more than one joystick at the same time.
You can change some options of this driver using the SDL specific environment variables described in the contrib/sdl/env.txt file.
It supports only one joystick.
Details on how to build the Parallel Port hardware interfaces for SNES, PSX, N64 and other pads are in the Allegro sources.
It supports more than one mouse at the same time.
For USB devices this driver doesn't require any configuration. It's able to autodetect all the present hardware.
For serial mouse you must use the `inputattach' system utility to attach the serial line at the event interface. Generally this utility is available in the joystick calibration package of your distribution. In this case it's probably simpler to use the `raw' mouse driver.
The mice are searched on the /dev/input/eventX devices.
It supports more than one mouse at the same time.
To use this driver you need to configure correctly the device_raw_* options to specify the mouse types and the mouse devices.
It supports only one mouse.
To use this driver you need to configure correctly the SVGALIB mouse support in the file /etc/vga/libvga.config file.
It supports only one mouse and only two axes.
You can change some options of this driver using the SDL specific environment variables described in the contrib/sdl/env.txt file.
It supports up to 2 mice at the same time using the special `optimous' driver present in the `contrib/' directory.
device_video auto | (DEVICE[/MODEL])+
Options:
| auto | Automatic detection of all the available drivers (default). |
The order of detection:
| DOS | svgaline, vbeline, vgaline, vbe. | |
| Linux | svgalib, fb, sdl, slang, curses. | |
| Mac OS X | sdl. | |
| Windows | svgawin, sdl. |
Options for Linux:
| svgalib | SVGA generated graphics modes with the SVGALIB 1.9.x library. | |
| fb | SVGA generated graphics modes with the Linux Console Frame Buffer. | |
| slang | Text video modes with the sLang library. | |
| curses | Text video modes with the ncurses library. | |
| sdl | SDL graphics and fake text modes. |
Options for Mac OS X:
| sdl | SDL graphics and fake text modes. |
Options for DOS:
| svgaline | SVGA generated graphics modes. | |
| vbeline | VBE generated graphics modes. | |
| vgaline | VGA generated text and graphics modes. | |
| vbe | VBE graphics modes. |
Options for Windows:
| svgawin | SVGA generated graphics modes with the SVGAWIN included library. To use this driver you need to install the `svgawin.sys' driver with the `svgawin.exe' command line utility. | |
| sdl | SDL graphics and fake text modes. |
Please note that to use the utilities `advv' and `advcfg' you must at least select a graphics and a text video driver. The available text video drivers are `vgaline' for DOS, `slang', `curses' for Linux and `sdl' for Windows.
You can force the detection of a specific model of video board adding the name of the model driver after the driver name using the `/' separator. For example to force the `vbe3' model detection of the `vbeline' driver you must specify `vbeline/vbe3'. A complete list of all the available model is in the `card*.txt' files.
Please note that forcing a specific video driver is discouraged. Generally you don't need it.
For a more complete description of the drivers check the previous `VIDEO DRIVER' section.
Example to enable the `vbeline' and the `vgaline' drivers with auto-detection for DOS:
device_video vbeline vgaline |
Example to force the `vbeline/vbe3' driver and the `vgaline' driver for DOS:
device_video vbeline/vbe3 vgaline |
Example to enable the `fb' and `slang' driver for Linux:
device_video fb slang |
device_video_output auto | window | fullscreen | overlay
Options:
| auto | Automatically chosen (default). | |
| window | Use a window display. | |
| fullscreen | Use a fullscreen display. | |
| overlay | Use a YUV fullscreen overlay using the video board hardware acceleration to display and stretch it. This mode is available only in some environments, like xv in X Window and DirectX in Windows. The specific color format used is YUY2. |
Please note that with the zoom mode, if the original image is in the RGB format instead of a palette format, the program needs to convert it to the YUY2 format before displaying it. It requires some time.
device_video_overlaysize SIZE
Options:
| SIZE | The favorite horizontal size (default 1024). |
This option has effect only with the `overlay' output mode.
device_video_cursor auto | off | on
Options:
| auto | Automatically choose (default). The cursor is enabled in window modes, and disabled in fullscreen modes. | |
| off | Always off. | |
| on | Always on, only if the video mode support it. |
device_video_clock PIXEL_CLOCK / HORZ_CLOCK / VERT_CLOCK [; ...]
Options:
| PIXEL_CLOCK | Pixel clock range in MHz. The lower value is the lower clock generable by your video board. The higher value is the video bandwidth of your monitor. If you don't know these values you can start with `5 - 100' which essentially enable any video mode. | |
| HORZ_CLOCK | Horizontal clock range in kHz. |
| VERT_CLOCK- Vertical clock range in Hz. |
For any range you can specify a single value like `60' or a range of values like `50 - 60'. For multistandard TVs and monitors you can use more clock specifications separating them with `;'.
For example:
device_video_clock 5 - 50 / 15.62 / 50 ; 5 - 50 / 15.73 / 60 |
Check the `install.txt' file for examples and other information.
device_video_modeline Name CLOCK HDE HRS HRE HT VDE VRS VRE VT [-hsync] [-vsync] [+hsync] [+vsync] [doublescan] [interlace]
Options:
| Name | Name of the video mode. You can use the quotes '"` for the names with spaces. | |
| CLOCK | Pixel clock in MHz | |
| HDE HRS HRE HT | Horizontal `Display End', `Retrace Start', `Retrace End', `Total' | |
| VDE VRS VRE VT | Vertical `Display End', `Retrace Start', `Retrace End', `Total' | |
| -hsync -vsync +hsync +vsync | Polarization mode. | |
| doublescan | Doublescan mode. | |
| interlace | Interlaced mode. |
Examples:
device_video_modeline tweak320x240 12.59 320 336 356 400 240 \ 249 254 262 doublescan -hsync -vsync |
device_video_format HCLOCK HDE HRS HRE HT VDE VRS VRE VT
Options:
| HCLOCK | Horizontal clock in Hz | |
| HDE HRS HRE HT VDE VRS VRE VT | Like the modeline option |
When a new modeline is created, AdvanceMAME uses a linear interpolation of the two formats with the nearest horizontal clock.
The default value of this option is for an Arcade 15 kHz monitor:
15720 0.737 0.075 0.074 0.113 0.916 0.012 0.012 0.060 |
and for an Arcade 25 kHz monitor:
25000 0.800 0.020 0.100 0.080 0.922 0.006 0.012 0.060 |
and for a VGA 31.5 kHz monitor:
31500 0.800 0.020 0.120 0.060 0.914 0.019 0.004 0.063 |
Which one of these defaults is used depends on the setting of the `device_video_clock' option.
device_video_singlescan yes | no device_video_doublescan yes | no device_video_interlace yes | no
Options:
| yes | Permits the use of the feature if the low-end driver allows it (default). | |
| no | Disable completely the feature. |
device_color_palette8 yes | no device_color_bgr8 yes | no device_color_bgr15 yes | no device_color_bgr16 yes | no device_color_bgr24 yes | no device_color_bgr32 yes | no device_color_yuy2 yes | no
Modes:
| palette8 | Palettized 8 bits mode. | |
| bgr8 | RGB 8 bits mode. | |
| bgr15 | RGB 15 bits mode. | |
| bgr16 | RGB 16 bits mode. | |
| bgr24 | RGB 24 bits mode. | |
| bgr32 | RGB 32 bits mode. | |
| yuy2 | YUV mode in the YUY2 format. |
Options:
| yes | Permits the use of the bit depth if the low-end driver allows it (default). | |
| no | Disable completely the bit depth. |
device_video_fastchange yes | no
Options:
| yes | Enable the fast video mode change. | |
| no | Disable the fast video mode change (default). |
The use of this option is discouraged, it's present only for testing.
device_vbeline_mode smaller | bigger | ...
Options:
| smaller | Use the biggest `vbe' mode contained in the `vbeline' mode (default). | |
| bigger | Use the smallest `vbe' mode which contains the `vbeline' mode. | |
| smaller_upto640 | Like `smaller' but not bigger than 640x480. | |
| bigger_upto640 | Like `bigger' but not bigger than 640x480. | |
| 320 | Use always the 320x240 mode. | |
| 400 | Use always the 400x300 mode. | |
| 512 | Use always the 512x384 mode. | |
| 640 | Use always the 640x480 mode. | |
| 800 | Use always the 800x600 mode. |
device_svgaline_skipboard 0 | 1 | 2 | 3
Options:
| 0 | Don't skip any board (default). | |
| 1 | Skip 1 boards. | |
| 2 | Skip 2 boards. | |
| 3 | Skip 3 boards. |
Examples:
device_svgaline_skipboard 1 |
The use of this option is discouraged, it's present only for testing.
device_svgaline_divideclock yes | no
Options:
| yes | Divide the clock by 2. | |
| no | Don't divide the clock (default). |
device_svgawin_skipboard 0 | 1 | 2 | 3
Options:
| 0 | Don't skip any board (default). | |
| 1 | Skip 1 boards. | |
| 2 | Skip 2 boards. | |
| 3 | Skip 3 boards. |
Examples:
device_svgawin_skipboard 1 |
The use of this option is discouraged, it's present only for testing.
Options:
| none | Don't use the Windows graphics support. | |
| window | Create a stub window before setting the video mode. | |
| fullscreen | Create a stub fullscreen window before setting the video mode (default). |
The use of this option is discouraged, it's present only for testing.
device_svgawin_divideclock yes | no
Options:
| yes | Divide the clock by 2. | |
| no | Don't divide the clock (default). |
device_sound auto | none | DEVICE
Options:
| none | No sound. | |
| auto | Automatic detection (default). |
Options for Linux:
| alsa | ALSA sound interface. | |
| oss | OSS sound interface. | |
| sdl | SDL sound interface. |
Options for Mac OS X:
| sdl | SDL sound interface. |
Options for DOS:
| seal | SEAL automatic detection. | |
| seal/sb | Sound Blaster. | |
| seal/pas | Pro Audio Spectrum. | |
| seal/gusmax | Gravis Ultrasound Max. | |
| seal/gus | Gravis Ultrasound. | |
| seal/wss | Windows Sound System. | |
| seal/ess | Ensoniq Soundscape. | |
| allegro | Allegro automatic detection. | |
| allegro/sb10 | Sound Blaster 1.0. | |
| allegro/sb15 | Sound Blaster 1.5. | |
| allegro/sb20 | Sound Blaster 2.0. | |
| allegro/sbpro | Sound Blaster Pro. | |
| allegro/sb16 | Sound Blaster 16. | |
| allegro/audio | Ensoniq AudioDrive. | |
| allegro/wss | Windows Sound System. | |
| allegro/ess | Ensoniq Soundscape. | |
| vsync/sb | Sound Blaster. | |
| vsync/sbwin | Sound Blaster (Windows). | |
| vsync/ac97 | AC97. | |
| vsync/ac97win | AC97 (Windows). | |
| vsync/gusmax | Gravis Ultrasound Max. | |
| vsync/gus | Gravis Ultrasound. | |
| vsync/audio | Ensoniq AudioDrive. | |
| vsync/wss | Windows Sound System. | |
| vsync/ess | Ensoniq Soundscape. |
Options Windows:
| sdl | SDL sound interface. |
device_alsa_device DEVICE
Options:
| DEVICE | Output device (default 'default'). |
Other possible choices generally are 'hw:0,0' for using the frequency and format chosen directly by the hardware, or 'dmix' for allow concurrent access to other applications at the audio card.
Example:
device_alsa_device dmix |
If you want to configure the ALSA library to remap the `default' device to the `dmix' device for all the applications, you can create the `.asoundrc' file in your home directory with the following content:
pcm.!default {
type plug
slave.pcm "dmixer"
}
pcm.dmixer {
type dmix
ipc_key 1024
slave {
pcm "hw:0,0"
period_time 0
period_size 1024
buffer_size 16384
rate 44100
}
bindings {
0 0
1 1
}
}
ctl.dmixer {
type hw
card 0
}
|
Note that the suggested `.asoundrc' on the ALSA web site has a lower `buffer_size' value (4096). For AdvanceMAME a bigger buffer is required.
device_alsa_mixer DEVICE
Options:
| DEVICE | Mixer device. The special 'channel' value is used to adjust the volume changing the samples instead of using the card mixer. Other values like `default' are used to select the ALSA mixer. (default 'channel'). |
The use of this option is discouraged, it's present only for testing.
device_sdl_samples 512 | 1024 | 2048 | 2560 | 3072 | 3584 | 4096 | 6144 | 8192
Options:
| SAMPLES | Number of samples of an audio fragment (default 2048 in Windows, 512 otherwise). |
Lower values can be used to reduce the sound latency. Increase the value if your hear a choppy audio.
device_keyboard auto | none
Options:
| none | No keyboard. | |
| auto | Automatic detection (default). |
Options for Linux:
| event | Linux input-event interface. | |
| svgalib | SVGALIB keyboard interface. | |
| raw | Linux kernel keyboard interface. | |
| sdl | SDL keyboard interface. This driver is available only if the SDL video output is used. |
If you are using the SDL video driver you must also use the SDL keyboard driver.
Options for Mac OS X:
| sdl | SDL keyboard interface. |
Options for DOS:
| allegro | Allegro keyboard interface. |
Options for Windows:
| sdl | SDL keyboard interface. |
device_joystick auto | none | DEVICE
Options:
| none | No joystick (default). | |
| auto | Automatic detection. |
Options for Linux:
| event | Linux input-event interface. | |
| svgalib | SVGALIB joystick interface. | |
| raw | Linux kernel joystick interface. | |
| sdl | SDL joystick interface. |
Options for Mac OS X:
| sdl | SDL joystick interface. |
Options for DOS:
| allegro | Allegro automatic detection. | |
| allegro/standard | Standard joystick. | |
| allegro/dual | Dual joysticks. | |
| allegro/4button | 4-button joystick. | |
| allegro/6button | 6-button joystick. | |
| allegro/8button | 8-button joystick. | |
| allegro/fspro | CH Flightstick Pro. | |
| allegro/wingex | Logitech Wingman Extreme. | |
| allegro/sidewinder | Sidewinder. | |
| allegro/sidewinderag | Sidewinder Aggressive. | |
| allegro/gamepadpro | GamePad Pro. | |
| allegro/grip | GrIP. | |
| allegro/grip4 | GrIP 4-way. | |
| allegro/sneslpt1 | SNESpad LPT1. | |
| allegro/sneslpt2 | SNESpad LPT2. | |
| allegro/sneslpt3 | SNESpad LPT3. | |
| allegro/psxlpt1 | PSXpad LPT1. | |
| allegro/psxlpt2 | PSXpad LPT2. | |
| allegro/psxlpt3 | PSXpad LPT3. | |
| allegro/n64lpt1 | N64pad LPT1. | |
| allegro/n64lpt2 | N64pad LPT2. | |
| allegro/n64lpt3 | N64pad LPT3. | |
| allegro/db9lpt1 | DB9 LPT1. | |
| allegro/db9lpt2 | DB9 LPT2. | |
| allegro/db9lpt3 | DB9 LPT3. | |
| allegro/tgxlpt1 | TGX LPT1. | |
| allegro/tgxlpt2 | TGX LPT2. | |
| allegro/tgxlpt3 | TGX LPT3. | |
| allegro/segaisa | IF-SEGA/ISA. | |
| allegro/segapci | IF-SEGA2/PCI. | |
| allegro/segapcifast | IF-SEGA2/PCI. | |
| allegro/wingwarrior | Wingman Warrior. |
Options for Windows:
| sdl | SDL joystick interface. |
For the `allegro/psxlpt*', `allegro/db9lpt*', `allegro/tgxlpt*' drivers you can see the source file `advance/dos/jalleg.c' for instructions on how to build the lpt interface. See also the Allegro library source distribution.
device_mouse auto | none
Options:
| none | No mouse (default). | |
| auto | Automatic detection. |
Options for Linux:
| event | Linux input-event interface. | |
| svgalib | SVGALIB mouse interface. | |
| raw | Direct serial communication. | |
| sdl | SDL mouse interface. |
Options for Mac OS X:
| sdl | SDL mouse interface. |
Options for DOS:
| allegro | Allegro mouse interface. |
Options for Windows:
| sdl | SDL mouse interface. |
device_raw_mousetype[0,1,2,3] auto | DEVICE
Devices:
| auto | Auto detection. It works only sometimes, generally it's better to manually select the type. | |
| pnp | Plug And Play serial (3 buttons). | |
| ms | Microsoft Mouse serial (3 buttons). | |
| ms3 | Microsoft Intellimouse serial (3 buttons). | |
| ps2 | PS/2 (3 buttons). | |
| imps2 | Microsoft Intellimouse PS/2 (3 buttons). | |
| exps2 | Microsoft Intellimouse Explorer PS/2 (5 buttons). | |
| msc | Mouse System. | |
| mscgpm | Mouse System compatible with GPM. | |
| mman | Logitech MouseMan. | |
| mm | Logitech MM series | |
| logi | Logitech old protocol. | |
| bm | Bus Mouse. | |
| spaceball | Spacetec SpaceBall (6 buttons). | |
| wacomgraphire | Wacom Graphire tablet/mouse. | |
| drmousee4ds | Digital Research double-wheeled mouse. |
The Linux mice under /dev/input/* are always of type ps2, imps2 or exps2.
Examples:
device_raw_mousetype[0] ps2 device_raw_mousetype[1] ms |
device_raw_mousedev[0,1,2,3] auto | DEVICE
Options:
| auto | Automatically map to /dev/mouse or /dev/input/mouseX. | |
| DEVICE | Complete path of the mouse device. |
Examples:
device_raw_mousedev[0] /dev/input/mouse0 device_raw_mousedev[1] /dev/ttyS2 |