.nf
.B bind #v /dev
-.B /dev/vgabios
.B /dev/vgactl
-.B /dev/vgaovl
-.B /dev/vgaovlctl
.fi
.SH DESCRIPTION
The VGA device allows configuration of a graphics controller
This is usually performed by
.IR vga (8).
.PP
-.B Vgabios
-provides read-only access to the low 640kB of memory,
-where the VGA and other BIOS ROMs are located.
-.PP
Writing strings to
.B vgactl
configures the VGA device.
.I Y
pixels high.
This message is optional;
-it is used to implement panning and to accommodate
-displays that require the in-memory screen image
-to have certain alignment properties.
+it is used to accommodate displays that require the
+in-memory screen image to have certain alignment properties.
For example, a 1400x1050 screen with a 1408x1050 in-memory image
will use
.B "size 1408x1050
but
.BR "actualsize 1400x1050" .
.TP
-.BI panning " mode"
-Depending on whether
-.I mode
-is
-.B on
-or
-.BR off ,
-enable or disable panning in a virtual screen.
-If panning is on and the screen's
-.B size
-is larger than its
-.BR actualsize ,
-the displayed portion of the screen will pan to follow the mouse.
-Setting the panning mode after the first attach of the
-.B #i
-driver has no effect.
+.BI tilt " value"
+Set the tilt of the screen,
+altering the screen's orientation.
+The
+.I value
+can be one of:
+.BR none ,
+.BR left ,
+.B inverted
+and
+.BR right .
.TP
.BI type " ctlr"
Set the type of VGA controller being used.
.I Ctlr
is one of
+.BR 3dfx ,
.BR ark200pv ,
.BR clgd542x ,
.BR clgd546x ,
.BR ct65545 ,
.BR cyber938x ,
+.BR et4000 ,
+.BR geode ,
.BR hiqvideo ,
+.BR i81x ,
+.BR igfx ,
.BR mach64xx ,
.BR mga2164w ,
+.BR mga4xx ,
.BR neomagic ,
.BR nvidia ,
+.BR radeon ,
.BR s3 ,
+.BR t2r4
and
-.BR t2r4 .
+.BR vmware .
.IP
Note that this list does not indicate the full set of VGA chips
supported. For example,
Set the type of hardware graphics cursor being used.
.I Gc
is one of
+.BR soft ,
+.BR 3dfxhwgc ,
.BR ark200pvhwgc ,
.BR bt485hwgc ,
.BR clgd542xhwgc ,
.BR clgd546xhwgc ,
.BR ct65545hwgc ,
.BR cyber938xhwgc ,
+.BR et4000hwgc ,
+.BR geodehwgc ,
.BR hiqvideohwgc ,
-.BR mach64xxhwgc ,
+.BR i81xhwgc ,
+.BR igfxhwgc ,
.BR mga2164whwgc ,
+.BR mach64xxhwgc ,
.BR neomagichwgc ,
.BR nvidiahwgc ,
+.BR radeonhwgc ,
.BR rgb524hwgc ,
.BR s3hwgc ,
.BR t2r4hwgc ,
.BR tvp3020hwgc ,
+.BR tvp3026hwgc
and
-.BR tvp3026hwgc .
+.BR vmwarehwgc .
A value of
.B off
disables the cursor.
-There is no software cursor.
.TP
.BI palettedepth " d"
Set the number of bits of precision used by the
or
.BR 8 .
.TP
-.B blank
-Blank the screen.
-This consists of setting the hardware
-color map to all black as well as, on some controllers, setting the
-VGA hsync and vsync signals so as to turn off
-VESA DPMS-compliant monitors.
-The screen also blanks after 30 minutes of inactivity.
-The screen can be unblanked by moving the mouse.
-.TP
-.BI blanktime " minutes"
-Set the timeout before the
-screen blanks; the default is 30 minutes.
-If
-.I minutes
-is zero, blanking is disabled.
-.TP
.BI hwaccel " mode"
Depending on whether
.I mode
The default setting is
.BR on .
.TP
+.BI softscreen " mode"
+Depending on whether
+.I mode
+is
+.B on
+or
+.BR off ,
+enable or disable shadow framebuffer to reduce
+slow bus reads. Enabling
+.BI softscreen
+disables hardware acceleration. The default setting is
+.BR off
+except for the
+.BR vesa
+driver.
+.TP
.BI hwblank " mode"
Depending on whether
.I mode
.BR off ,
enable or disable the use of DPMS blanking
(see
-.B blank
-above).
+.IR mouse (3)).
.TP
.BI linear " size align"
Use a linear screen aperture of size
Reading
.B vgactl
returns the current settings, one per line.
-.PP
-Some VGA cards support overlay graphics.
-Writing strings to
-.B vgaovlctl
-configures such cards.
-The following are valid overlay control commands:
-.TP
-.BI openctl
-opens the overlay device.
-.TP
-.BI configure " w h format"
-allocates resources inside the driver to support an overlay area
-of width
-.I w
-and height
-.I h
-pixels. Currently, the only supported
-.I format
-is
-.B YUYV
-packed.
-In
-.B YUYV
-two pixels are encoded by their separate Y values
-and their combined U and V values.
-The size of the two pixels is 32 bits.
-.TP
-.BI enable " x y w h"
-enables drawing data on the display through the overlay mode. The data
-is drawn at position
-.IR x , y
-and has a width and height of
-.IR w , h
-respectively.
-.TP
-.BI closectl
-terminates overlay control.
-.PP
-Overlay data can be written to
-.BR vgaovl .
.SH EXAMPLES
The following disables hardware acceleration.
.IP