1.\" $NetBSD: vga.4,v 1.9 2001/09/11 23:18:55 wiz Exp $ 2.Dd March 20, 1999 3.Os 4.Dt VGA 4 5.Sh NAME 6.Nm vga 7.Nd VGA graphics driver for wscons 8.Sh SYNOPSIS 9.Cd "vga0 at isa?" 10.Cd "vga* at pci?" 11.Cd "wsdisplay* at vga? console ?" 12.Sh DESCRIPTION 13This driver handles 14.Tn VGA 15graphics hardware within the 16.Xr wscons 4 17console framework. It doesn't provide direct device 18driver entry points but makes its functions available via 19the internal 20.Xr wsdisplay 4 21interface. 22.Pp 23The 24.Nm 25driver supports multiple virtual screens on one physical 26display. The screens allocated on one display can be of different 27.Dq types , 28where a type refers to various display properties. The type is 29determined at the time the virtual screen is created and can't 30be changed later. Screens are either created at kernel startup 31(then the default type is used) or later with help of the 32.Xr wsconscfg 8 33utility. 34.Pp 35Currently, the following screen types are supported: 36.Bl -hang 37.It 80x25 38This is the standard 39.Tn VGA 40text mode with 80 columns and 25 rows. 16 different colors 41can be displayed at the same time. Characters are 8 x 16 42pixels large, and a font consists of 256 characters. A builtin 43font of this size is always present on a 44.Tn VGA 45card. It's also possible to use a downloaded font instead. 46.It 80x25bf 47is a modified version of the previous. It only allows 8 48colors to be displayed. In exchange, it can access two 49fonts at the same time, so that 512 different characters 50can be displayed. 51.It 80x40 52A text mode with 80 columns and 40 rows. Similar to the 53standard mode, 16 colors and 256 characters are available. 54Characters are 8 x 10 pixels large. For this mode to be useful, 55a font of that character size must be downloaded. 56.It 80x40bf 57is analogously to 58.Dq 80x25bf 59a version with 512 displayable characters but 8 colors only. 60.It 80x50 61A text mode with 80 columns and 50 rows. Similar to the 62standard mode, 16 colors and 256 characters are available. 63Characters are 8 x 8 pixels large. For this mode to be useful, 64a font of that character size must be downloaded. 65.It 80x50bf 66is analogously to 67.Dq 80x25bf 68a version with 512 displayable characters but 8 colors only. 69.It 80x24 70is a variant of the 71.Dq 80x25 72screen type which displays 24 lines only. It uses the standard 8x16 VGA font. 73This mode might be useful for applications which depend on closer 74.Tn DEC VT100 75compatibility. 76.It 80x24bf 77Analogously, like 78.Dq 80x24 79but with 512 character slots and 8 colors. 80.El 81.Pp 82The 83.Nm 84driver can display fonts of the original 85.Tn IBM 86type and ISO-8859-1 encoded fonts. As an experimental feature, the 87.Dq higher half 88fonts of the former 89.Nx Ns /i386 90.Nm pcvt 91driver distribution can be used too if the kernel option 92.Dq WSCONS_SUPPORT_PCVTFONTS 93was set at compile time. This is only useful with the 94.Dq *bf 95screen types; a font containing the 96.Tn ASCII 97range of characters must be available too on this screen. 98.Sh SEE ALSO 99.Xr isa 4 , 100.Xr pcdisplay 4 , 101.Xr pci 4 , 102.Xr wscons 4 , 103.Xr wsconscfg 8 , 104.Xr wsfontload 8 105.Sh BUGS 106Only a subset of the possible text modes is supported. 107.Pp 108.Tn VGA 109cards are supposed to emulate an 110.Tn MDA 111if a monochrome display is connected. In this case, the 112device will naturally not support colors at all, but 113offer the capability to display underlined characters instead. 114The 115.Dq 80x25bf , 116.Dq 80x40bf , 117.Dq 80x50bf 118and 119.Dq 80x24bf 120screen types will not be available. This mode of operation 121is not tested. 122