annotate drivers/README @ 4516:d604c3db9a76

Direct rendering expansion: test with -vc divx4vfw: -vaa_dr: BENCHMARKs: V: 7.043s VO: 0.005s A: 0.528s Sys: 22.331s = 29.907s BENCHMARK%: V: 23.5498% VO: 0.0156% A: 1.7670% Sys: 74.6676% = 100.0000% -vaa_nodr: BENCHMARKs: V: 5.454s VO: 2.433s A: 0.519s Sys: 21.513s = 29.920s BENCHMARK%: V: 18.2296% VO: 8.1321% A: 1.7351% Sys: 71.9032% = 100.0000% speed up on 7.043 vs 7.687 = 10% on K7
author nick
date Sun, 03 Feb 2002 16:13:05 +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.