drivers/README.Matrox

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