drivers/README

   1
   2 mga_vid  -  MGA G200/G400 YUV Overlay kernel module
   3
   4         Author:
   5                 Aaron Holtzman <aholtzma@ess.engr.uvic.ca>, Oct 1999
   6
   7         Contributions by:
   8                 Fredrik Vraalsen <vraalsen@cs.uiuc.edu>
   9                 Alan Cox <alan@lxorguk.ukuu.org.uk>
  10
  11                        WARNING  -----  WARNING
  12
  13 This code messes with your video card and your xserver. It will probably
  14 lock up your box, format your hard drive, and cause your brand new g400
  15 MAX to spout 6 inch flames. You have been warned.
  16
  17                        WARNING  -----  WARNING
  18
  19 What does this code do?
  20
  21          mga_vid is a kernel module that utilitizes the Matrox g200/g400 video
  22          scaler/overlay unit to perform YUV->RGB colorspace conversion and
  23          arbitrary video scaling.
  24
  25          mga_vid is also a monster hack.
  26
  27 How does mga_vid work?
  28
  29         This kernel module sets up the BES (backend scaler) with approriate values
  30         based on parameters supplied via ioctl. It also maps a chunk of video
  31         memory into userspace via mmap. This memory is stolen from X (which may
  32         decide to write to it later). The application can then write image data
  33         directly to the frame buffer (if it knows the right padding, etc).
  34
  35
  36 How do I know if mga_vid works on my system?
  37
  38         There are test applications called mga_vid_test_g400 and mga_vid_test_g200.
  39         Use the appropriate one for your card. This test code should draw some
  40         nice 256x256 images for you if all is working well.