annotate drivers/README @ 15627:2c191764e8d9

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