0-readme

linux 下svgalib编的一个界面程序示例

       joystick_update(3)
	      - query and process joystick state changes.
       joystick_sethandler(3), joystick_setdefaulthandler(3)
	      - define own joystick even handler.
       joystick_getnumaxes(3), joystick_getnumbuttons(3)
	      - query the capabilities of a joystick.
       joystick_getaxis(3), joystick_getbutton(3)
	      - query the state of a joystick.
       joystick_button1|2|3|4(3),      joystick_getb1|2|3|4(3),
	      joy- stick_x|y|z(3), joystick_getx|y|z(3)
	      -	 convenience  macros  to query the joystick posi-
	      tion.

   Accelerator interface (new style)




Svgalib 1.4.1		 16 December 1999			7





svgalib(7)	       Svgalib User Manual	       svgalib(7)


       vga_accel(3)
	      - calls the graphics accelerator.

   Accelerator interface (old style)
       vga_bitblt(3)
	      - copy pixmap on screen using an accelerator.
       vga_fillblt(3)
	      - fill rectangular area in video memory with a sin-
	      gle color.
       vga_hlinelistblt(3)
	      - draw horizontal scan lines.
       vga_imageblt(3)
	      -	 copy  a rectangular pixmap from system memory to
	      video memory.
       vga_blitwait(3)
	      - wait for any accelerator operation to finish.

   Controlling VC switches
       vga_lockvc(3)
	      - disables virtual console switching for safety.
       vga_unlockvc(3)
	      - re-enables virtual console switching.
       vga_oktowrite(3)
	      - indicates whether the program has  direct  access
	      to the SVGA.
       vga_runinbackground(3)
	      -	 enable	 running of the program while there is no
	      VGA access.
       vga_runinbackground_version(3)
	      - returns the version  of	 the  current  background
	      support.

   Debugging aids
       vga_dumpregs(3)
	      - dump the contents of the SVGA registers.
       vga_gettextfont(3), vga_puttextfont(3)
	      - get/set the font used in text mode.
       vga_gettextmoderegs(3), vga_settextmoderegs(3)
	      - get/set the vga state used in text mode.
       vga_flip(3)
	      - toggle between text and graphics mode.
       vga_setflipchar(3)
	      - set the character causing a vga_flip().



4. OVERVIEW OF SUPPORTED SVGA CHIPSETS AND MODES
   VGA and compatibles
       320x200x256,  and  the series of 16-color and non-standard
       planar 256 color modes supported by  VGAlib,  as	 well  as
       720x348x2.






Svgalib 1.4.1		 16 December 1999			8





svgalib(7)	       Svgalib User Manual	       svgalib(7)


   ALI2301
       Supports 640x480x256, 800x600x256, 1024x768x256 SVGA modes


   AT3D (AT25)
       Also known as Promotion at25. Popular as the 2D part of	a
       voodoo rush card. As of this writing there are a few known
       problems with this driver. Read below.


   ARK Logic ARK1000PV/2000PV
       Full  support,  limited	RAMDAC	support.  Only	ARK1000PV
       tested. Supports Clocks and Ramdac lines in config file.


   ATI SVGA (VGA Wonder and friends)
       This  is	 no  real driver. I do not support any new modes.
       However it saves additional card setup and thus allows use
       of  the	plain VGA modes even when you are using non stan-
       dard text modes. It is possible to  enforce  use	 of  this
       driver even on ATI Mach32 but not very useful.


   ATI Mach32
       The driver by Michael Weller supports all ATI BIOS-defined
       modes and more... It hits the best out of your card.  Some
       modes  may  not	have nice default timings but it uses the
       ATI's EEPROM for custom config or allows to specify  modes
       in  libvga.config(5).   Some problems may occur with quite
       some third party cards (usually	on  board)  Mach32  based
       controllers  as	they  do  not  completely  conform to the
       Mach32 data sheets.  Check out svgalib.mach32(7) (and lib-
       vga.config(5)).


   ATI Mach64 (rage)
       A driver for ATi Mach64 based cards with internal DAC.


   Chips  and  Technologies  chipsets 65525, 65535, 65546, 65548,
       65550, and 65554 (usually in laptops).
       This server was written using the SVGALIB patch from  Ser-
       gio  and Angelo Masci as a starting point. This version of
       the code resembled the XFree server code that was used  up
       to  XFree  3.1.2.  As such it was incapable of programming
       the clocks, using linear addressing, Hi-Color,  True-Color
       modes  or the hardware acceleration. All of these features
       have since been added to the code.  The	64200  and  64300
       chips  are unsupported, however these chips are very simi-
       lar to the 6554x chips which are supported.


   Cirrus Logic GD542x/3x
       All the modes, including 256  color,  32K/64K  color,  16M



Svgalib 1.4.1		 16 December 1999			9





svgalib(7)	       Svgalib User Manual	       svgalib(7)


       color (3 bytes per pixel) and 32-bit pixel 16M color modes
       (5434). Some bitblt functions are supported.   The  driver
       doesn't	work with mode dumps, but uses a SVGA abstraction
       with mode timings like the X drivers.


   Genoa(?) GVGA6400 cards.
       Supported.


   Hercules Stingray 64/Video
       Is supported as an ARK2000PV


   NV3 driver for the Riva128.
       This driver was written by Matan	 Ziv-Av	 and  is  derived
       from  the XFree86 driver by David J. Mckay. It lacks 24bit
       modes (can the card do them at all?), acceleration support
       and pageflipping in threeDKit is broken.


   Oak Technologies OTI-037/67/77/87
       Driver  by Christopher Wiles; includes 32K color modes for
       OTI-087.


   S3
       The driver is not complete, but should work on a number of
       cards/RAMDACs,  and  640x480x256 should work on most card.
       The best support is for a 801/805 with AT&T20C490-compati-
       ble  RAMDAC, and S3-864 + SDAC.	All 256/32K/64K/16M works
       for them (within the  bounds  of	 video	memory	&  ramdac
       restrictions).

       The  supported cards include S3 Virge and S3 Trio64 cards.

       None of the acceleration function is supported yet.

       The chip level code should work with the 964/868/968,  but
       most likely the card they come on would use an unsupported
       ramdac/clock chip.  Support  for	 these	chips  is  slowly
       being added.

       Clocks and Ramdac lines in libvga.config(5) supported.

       The  maximum pixel clock (in MHz) of the ramdac can be set
       using a Dacspeed line in the  config  file.  A  reasonable
       default	is  assumed  if	 the  Dacspeed	line  is omitted.
       Clocks should be the same as in XFree86. Supported  ramdac
       IDs:   Sierra32K,   SC15025,   SDAC,   GenDAC,  ATT20C490,
       ATT20C498, IBMRGB52x.

       Example:
       Clocks 25.175 28.3 40 70 50 75 36 44.9 0 118 77	31.5  110



Svgalib 1.4.1		 16 December 1999		       10





svgalib(7)	       Svgalib User Manual	       svgalib(7)


       65 72 93.5
       Ramdac att20c490
       DacSpeed 85

       Also   supported,   at	least  in  combination	with  the
       SC15025/26A ramdac, is the ICD 2061A clock chip.	 Since it
       cannot be autodetected you need to define it in the config
       file using a Clockchip line. As there is no  way	 to  read
       the  current settings out of the 2061, you have the option
       to specify the frequency used when switching back to  text
       mode as second argument in the Clockchip line.

       This  is	 especially  required if your text mode is an 132
       column mode, since these modes use a clock from the  clock
       chip,  while  80 column modes use a fixed clock of 25 MHz.
       The text mode frequency defaults to 40 MHz, if omitted.

       Example:
       ClockChip icd2061a 40.0


   Trident TVGA 8900C/9000 (and possibly also 8800CS/8900A/B) and
       also TVGA 9440
       Derived from tvgalib by Toomas Losin. TVGA 9440 support by
       ARK <[e-mail], [e-mail]>.

       Supports 640x480x256,  800x600x256,  1024x768x256  (inter-
       laced  and non-interlaced) Might be useful to add 16-color
       modes (for those equipped with a 512K  TVGA9000)	 for  the
       8900 and 9000 cards.

       320x200x{32K,  64K,  16M},  640x480x{256,  32K, 64K, 16M},
       800x600x{256,  32K,   64K,   16M},   1024x768x{16,   256},
       800x600x{16,  256,  32K,	 64K} modes are supported for the
       TVGA 9440.

       Autodetection can be forced with a:

	      chipset TVGA memory flags

       line in the config file.

       memory is the amount of VGA memory in KB,  flags	 is  com-
       posed of three bits:

	      bit2 = false, bit1 = false
		     force 8900.

	      bit2 = false, bit1 = true
		     force 9440.

	      bit2 = true, bit1 = false
		     force 9680.




Svgalib 1.4.1		 16 December 1999		       11





svgalib(7)	       Svgalib User Manual	       svgalib(7)


	      bit0 = true
		     force noninterlaced.

	      bit0 = false
		     force   interlaced	 which	only  matters  on
		     8900's with at least 1M since  there  is  no
		     512K  interlaced  mode on the 8900 or any of
		     the other cards.


   Tseng ET4000/ET4000W32(i/p)
       Derived from VGAlib; not the same register values.  ET4000
       register values are not compatible; see svgalib.et4000(7).

       Make sure the colors are right in hicolor mode; the  vgat-
       est  program  should  draw the same color bars for 256 and
       hicolor modes (the DAC type is defined at  compilation  in
       et4000.regs  or	the  dynamic registers file).  ET4000/W32
       based cards usually have an AT&T or  Sierra  15025/6  DAC.
       With  recent  W32p  based  cards, you might have some luck
       with the AT&T DAC type.	 If  the  high	resolution  modes
       don't work, you can try dumping the registers in DOS using
       the program in the et4000/ directory and putting them in a
       file  (/etc/vga/libvga.et4000  is  parsed  at  runtime  if
       DYNAMIC is defined in Makefile.cfg at compilation (this is
       default)).

       Supported     modes    are    640x480x256,    800x600x256,
       1024x768x256, 640x480x32K, 800x600x32K, 640x480x16M,  etc.

       Reports of ET4000/W32i/p functionality are welcome.

       There may be a problem with the way the hicolor DAC regis-
       ter is handled; dumped registers may use one of two timing
       methods, with the value written to the register for a par-
       ticular DAC for a hicolor mode (in vgahico.c)  being  cor-
       rect  for  just one of the these methods. As a consequence
       some dumped resolutions may work while others don't.


   Tseng ET6000
       Most modes of which the card  is	 capable  are  supported.
       The 8 15 16 24 and 32 bit modes are supported.

       The ET6000 has a built in DAC and there is no problem com-
       ing from that area. The ET6000 is capable of acceleration,
       but this as well as sprites are not yet implemented in the
       driver.

       The driver now uses modelines in	 libvga.config	for  user
       defined	modes.	 It is sometimes useful to add a modeline
       for a resolution which does not display well.   For  exam-
       ple,  the  G400x600  is too far to the right of the screen
       using standard modes.  This is corrected by  including  in



Svgalib 1.4.1		 16 December 1999		       12





svgalib(7)	       Svgalib User Manual	       svgalib(7)


       libvga.config the line

       Modeline	 "400x600@72"	25.000	400   440  488	520   600
       639  644	 666

       More examples are given below.

       This driver was provided by Don Secrest.


   VESA
       Please read README.vesa and README.lrmi in  doc	subdirec-
       tory of the standard distribution.

       Go figure! I turned off autodetection in the release, as a
       broken  bios  will  be  called  too,  maybe  crashing  the
       machine.	 Enforce  VESA	mode by putting a chipset VESA in
       the end of your libvga.config(5).

       Note that it will leave protected mode and call the  cards
       bios opening the door to many hazards.


5. DETAILED COMMENTS ON CERTAIN DEVICE DRIVERS
       This  section contains detailed information by the authors
       on certain chipsets.


   AT3D (AT25)
       Also known as Promotion at25. Popular as the 2D part of	a
       voodoo rush card.

       I  have	written	 a  driver for this chipset, based on the
       XF86 driver for this chipset.

       The programs that work with this driver	include	 all  the
       programs in the demos directory, zgv and dvisvga (tmview).

       I believe it should be easy  to	make  it  work	on  AT24,
       AT6422.


   ATI Mach32
       Please see svgalib.mach32(7).


   ATI Mach64
       The  rage.c  driver  works only on mach64 based cards with
       internal DAC.  The driver might misdetect  the  base  fre-
       quency the card uses, so if when setting any svgalib modes
       the screen blanks, or complains about out of bound freqen-
       cies,  or  the  display	is  unsynced, then try adding the
       option RageDoubleClock to the config file.




Svgalib 1.4.1		 16 December 1999		       13





svgalib(7)	       Svgalib User Manual	       svgalib(7)


   Chips and Technologies chipsets 65525,  65535,  65546,  65548,
       65550, and 65554 (usually in laptops).
       Please see svgalib.chips(7).


   Tseng ET4000/ET4000W32(i/p)
       Please see svgalib.et4000(7).


   Tseng ET6000
       I  have only 2 Mbytes of memory on my ET6000 card, so I am
       not able to get all possible modes running. I haven't even
       tried  to do all of the modes which I am capable of doing,
       but I am confident that I can manage  more  modes  when	I
       have  time.  I  have enough modes working to make the card
       useful, so I felt it was worth while to add the driver  to
       svgalib now.