NAME
	advv - The manual video configurator

SYNOPSYS
	advv [-advmamev] [-advmessv] [-advpacv] [-advmenuv] [-vbev]
		[-vgav] [-log] [-logsync] [-rc RCFILE]

DESCRIPTION
	The `advv' utility is the main video configuration program
	for AdvanceMAME, AdvanceMESS, AdvancePAC, AdvanceMENU,
	AdvanceVBE and AdvanceVGA.
	It selects, creates and tweaks video modes interactively.

	This utility works differently if one of the -advmamev,
	-advmessv, -advpacv, -advmenuv, -vbev and -vgav option is
	specified.
	The main difference is the the name of the configuration
	file used to store the video modes. Respectively they
	are `advmame.rc', `advmess.rc', `advpac.rc', `advmenu.rc',
	`vbe.rc' and `vga.rc'.

	When the program starts a list of modelines is printed. You can
	walk on the list with the UP and DOWN arrows of your keyboard. 
	You can select the modelines to use in the emulator pressing
	SPACE.

	With the LEFT and RIGHT arrows you can select the bit depth of
	the video mode to test.

	To test a video mode you can press ENTER and ESC to return
	to the list.

	When you have finished the selection press F2 to save the video
	modes in the configuration file. At the next run the emulator
	will use one of the modelines that you have chosen.

	If you have problem please read the TROUBLESHOTTING chapter in
	the `install.txt' file.

OPTIONS
	-rc RCFILE
		Specify an alternate name of the configuration file.

	-log
		A very detailed log of operations is saved in
		a `.log' file. Very useful for debugging problems.

	-logsync
		Like the `-log' option but the log file is not
		buffered. This option must be used to get a complete
		log file in presence of a machine crash.

	-advmamev, -advmessv, -advpacv, -advmenuv, -vbev, -vgav
		Select the mode of operation for the programs `advmame',
		`advmess', `advpac', `advmenu', `vbe' and `vga'.
		The default is `advmame'.

VIDEO DRIVER
	There are many types of video drivers.

	This is the list of the drivers used by the various
	applications:
		AdvanceMAME for DOS - svgaline, vbeline, vgaline.
		AdvanceMENU for DOS - svgaline, vbeline, vgaline, vbe.
		AdvanceMAME/MENU for Linux - svgalib, fb.
		AdvanceVBE - vbeline
		AdvanceVGA - vgaline

    Driver for DOS :

	vgaline - Tweaked VGA modes
		Video modes obtained tweaking the hardware
		registers of the standard VGA. Usually these modes
		are called Tweaked, XMode, ZMode.
		Only the standard VGA pixel clocks 6.29, 7.08, 12.59,
		14.16 MHz are available. Only 8 bit color modes. Only
		256 kBytes of video memory.

		This driver supports also text modes with pixel clocks
		12.59, 14.16, 25.17, 28.32 MHz.

	svgaline - Tweaked SVGA modes
		Video modes obtained tweaking the hardware
		registers of the recognized SVGA.
		These are the most powerful modes.
		All clocks, all bit depths are available.

		To use these modes your video board must be supported
		by a `svgaline' driver listed in the `card.txt' file.
		The drivers are probed at the startup, and the first
		detected is used. The name of the video driver active
		is displayed in the upper right corner of the first
		screen of the utility `advv'.

		This driver is completly indipendent of the VBE BIOS
		of your board.

	vbeline - Tweaked VBE (VESA) modes
		Video modes obtained tweaking the standard VBE BIOS mode
		changing the hardware registers of the SVGA.

		To use these modes your video board must be supported
		by a `vbeline' driver listed in the `card.txt' file.
		The drivers are probed at the startup, and the first
		detected is used. The name of the video driver active
		is displayed in the upper right corner of the first
		screen of the utility `advv'.

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

    Drivers for Linux:

	svgalib - Tweaked SVGA
		SVGA Graphics modes from the SVGALIB library.
		You must install the SVGALIB library version 1.9.x.

	fb - Console Frame Buffer modes
		SVGA Graphics modes from the Linux Kernel Console Frame
		Buffer. You must activate the Console Frame Buffer
		support in your kernel.

	slang - sLang text modes.
		Text modes from the sLang library. This driver is only
		able to use the current text mode. It can't really
		change the video mode.

	If you have correctly configured the `clock' options
	in your configuration file, the video modes out of
	the frequency range supported by your monitor are displayed
	in red, and you are prevented to use them.

CREATING VIDEO MODES
	To create a new modeline you should press F5 and you must enter
	the :
		Vertical clock
		Horizontal resolution
		Vertical resolution

	If possible, a video mode compatible with your current monitor
	configuration is created.

	If a the `device_video_format' option is present in your
	configuration file, the video mode is created with this format.
	Otherwise a generic VGA monitor format is used.

ADJUSTING MODELINES
	You can modify the modelines in the test screen pressing ENTER
	or in the list screen directly.

	When you are in the test screen, `advv' prevent you to set a
	modeline out of the frequency range supported by your monitor.
	In this cases you can hear a grave long sound. Instead when you
	are in the list screen you don't have this limitation.

	If you request a parameter not supported by your hardware
	you hear an acute short sound.

	You can easily change one of the clock values of your modelines
	pressing F8.

	Finally you can rename the modelines pressing TAB.

	Remember to select the modified modelines with SPACE otherwise
	they aren't saved in your configuration file and will be lost.

STARTUP TEXT MODE
	The program at startup tries to set a text mode supported by
	your hardware to show his data.

	If a modelines named `default_text' is present in your
	configuration file the program use it.

	If correct `device_video_clock' options are found in your
	configuration file the program try to use a text mode that
	match your `clock' configuration.
	First are tried modes in the configuration file, after
	modes present in a internal list of the program.
	If no one of these modes match your configuration the current
	text mode is used.

CONFIGURATION
    "device_video"
	Selects the video driver to use.

	device_video auto | (DEVICE[/MODEL])+

	Options:
		auto - Automatic detection of all the available drivers
			(default). The order of detection is for DOS :
			svgaline, vbeline, vgaline. And for Linux :
			svgalib, fb, slang.

	Options for DOS:
		svgaline - SVGA graphics modes.
		vbeline - VBE graphics modes.
		vgaline - VGA text and graphics video modes.

	Options for Linux:
		svgalib - SVGA graphics modes with the SVGALIB 1.9.x
			library.
		fb - SVGA grahics modes with the Linux Console Frame
			Buffer.
		slang - Text video modes with the sLang library.

	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 and `slang'
	for Linux.

	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' file. Plese note that forcing a specific video
	driver is discouraged with the only exception of the
	`vbeline/vbe3' model.

	For a more complete description of the drivers check the
	previous `VIDEO DRIVER' section.

	Examples:

	Enable the `vbeline' and the `vgaline' drivers with
	autodetection for DOS :

		device_video vbeline vgaline

	Enable the `vbeline/vbe3' driver and the `vgaline' driver for
	DOS :

		device_video vbeline/vbe3 vgaline

	Enable the `fb' and `slang' driver for Linux :

		device_video fb slang

    "device_video_pclock/hclock/vclock"
	Specify the monitor frequency range in term of horizontal and
	vertical clocks. This option is MANDATORY.
	Generally these values are specified in the technical page of 
	your monitor manual. 

	device_video_pclock P_LOW - P_HIGH
	device_video_hclock H_LOW - H_HIGH [, H_LOW - H_HIGH] [, H_FIXED]
	device_video_vclock V_LOW - V_HIGH [, V_LOW - V_HIGH] [, V_FIXED]

	Options:
		P_LOW - P_HIGH - 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 don't know
			these values you can start with `pclock 5 - 90'
			which essentially enable any video mode.
		H_LOW - H_HIGH - Horizontal clock range in kHz
		H_FIXED - Horizontal fixed clock in kHz
		V_LOW - V_HIGH - Vertical clock range in Hz
		V_FIXED - Vertical fixed clock in Hz

	These are some example:

		Generic PC SVGA multisync monitor :
			device_video_pclock 10 - 70
			device_video_hclock 31 - 60
			device_video_vclock 55 - 90

		Generic PC VGA monitor :
			device_video_pclock 10 - 50
			device_video_hclock 31.5
			device_video_vclock 55 - 110

		PAL/SECAM TV (European) :
			device_video_pclock 5 - 50
			device_video_hclock 15.62
			device_video_vclock 50

		PAL/SECAM TV (European) which supports also NTSC 
		modes (very common if you use the SCART input) :
			device_video_pclock 5 - 50
			device_video_hclock 15.62, 15.73
			device_video_vclock 50, 60

		NTSC TV (USA) :
			device_video_pclock 5 - 50
			device_video_hclock 15.73
			device_video_vclock 59.94

		Generic Arcade Monitor Standard Resolution 15 kHz (CGA) :
			device_video_pclock 5 - 50
			device_video_hclock 15.75
			device_video_vclock 50 - 60

		Generic Arcade Monitor Medium Resolution 25 kHz (EGA) :
			device_video_pclock 5 - 50
			device_video_hclock 24.84
			device_video_vclock 50 - 60

		Generic Atari Monitor Extended Resolution 16 kHz
			device_video_pclock 5 - 50
			device_video_hclock 16.5
			device_video_vclock 53

    "device_video_modeline"
	Define a video modeline. The modeline format is compatible with
	the format used by the Linux SVGALIB library and by the
	XFree Window system.

	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 - double scanned mode
		interlace - interlaced mode

	Example:
		device_video_modeline tweak320x240 12.59 320 336 356 400 240 249 254 262 doublescan -hsync -vsync

    "device_video_format"
	Select the format of the video modes to create.
	You can insert more than one of these option.
	
	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.

    "device_video_singlescan/doublescan/interlace"
	Limit the use of certains features.

	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 allow it (default).
		no - Disable completly the feature.

    "device_video_fastchange"
	Enable or disable the fast video mode change. If enabled the
	current video mode is not reset before setting another video
	mode. The reset should generally not required, but some
	limited BIOS need it. So, the fast change is disabled for
	default.

	device_video_fastchange yes | no

	Options:
		yes - Enable the fast video mode change.
		no - Disable the fast video mode change (default).

VBELINE CONFIGURATION
	These options have effects only on the `vbeline' drivers.

    "device_vbeline_driver"
	Select the video driver used. The program uses the specified
	driver ONLY if it's correctly detected.
	Generally you should use this option only to force the
	`vbe3' driver.

	device_video_vbeline_driver none | auto | vbe3 | ...

	Options:
		none - don't use any `vbeline' driver.
		auto - autodetect (default).
		vbe3 - use the VBE3 BIOS if available, this is the
			last driver detected.
		... - check the `card.txt' file for a complete list of
			the video driver available.
	Example:
		device_vbeline_driver vbe3

    "device_vbeline_mode"
	Select which `vbe' mode to use when generating `vbeline' modes.

	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.

VERSION
	2001/11/28 - Andrea Mazzoleni - First revision
	2002/01/05 - Andrea Mazzoleni - Updates
