devvga: implement screen tilting, remove panning and overlays

[plan9front.git] / sys / man / 3 / vga

diff --git a/sys/man/3/vga b/sys/man/3/vga
index d17858008a811046a99bbe3ad5996c7073d72ed6..993f9767bda272b453edbb436a699deb44cb5d36 100644 (file)
--- a/sys/man/3/vga
+++ b/sys/man/3/vga
@@ -5,10 +5,7 @@ vga \- VGA controller device
 .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
@@ -23,10 +20,6 @@ it is used to implement configuration and setup of VGA controller cards.
 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.
@@ -53,49 +46,51 @@ pixels wide by
 .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,
@@ -110,27 +105,34 @@ appropriately.
 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 
@@ -141,22 +143,6 @@ which must be either
 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
@@ -195,8 +181,7 @@ or
 .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
@@ -213,46 +198,6 @@ This must be sent after setting the
 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