view drivers/README @ 1306:7ce37211e454

yuv2rgb_mmx crashes with ffdivx codec, when we play back avi files that have a frame width that is not an exact multiple of 8. Testcase: 405.avi (356x240). Playing on an MMX capable x86 system using the x11 video-out driver results in a segfault. The MMX routines convert image data in quantities of 8 pixels in each loop, and the inner loop was not terminated in case there are only 1-7 pixels left, producing too much RGB output. For now, just ignore the last few pixels on each row, to avoid the segfaults. (Gives a black vertical border on the right, if you play a video with width%8 != 0) A possible future enhancement would be, to add a second loop to convert the last width%8 pixels to RGB using a byte loop.

+
��
+
��mga_vid  -  MGA G200/G400 YUV Overlay kernel module
+
��
+
��	Author:
+
��		Aaron Holtzman <[e-mail]>, Oct 1999
+
��
+
��	Contributions by:
+
��		Fredrik Vraalsen <[e-mail]>
+
��		Alan Cox <[e-mail]>
+
��
+
��                       WARNING  -----  WARNING
+
��
+
��This code messes with your video card and your xserver. It will probably
+
��lock up your box, format your hard drive, and cause your brand new g400 
+
��MAX to spout 6 inch flames. You have been warned.
+
��
+
��                       WARNING  -----  WARNING
+
��
+
��What does this code do?
+
��
+
��	 mga_vid is a kernel module that utilitizes the Matrox g200/g400 video 
+
��	 scaler/overlay unit to perform YUV->RGB colorspace conversion and
+
��	 arbitrary video scaling.
+
��
+
��	 mga_vid is also a monster hack.
+
��
+
��How does mga_vid work?
+
��
+
��	This kernel module sets up the BES (backend scaler) with approriate values
+
��	based on parameters supplied via ioctl. It also maps a chunk of video
+
��	memory into userspace via mmap. This memory is stolen from X (which may
+
��	decide to write to it later). The application can then write image data
+
��	directly to the frame buffer (if it knows the right padding, etc).
+
��
+
��
+
��How do I know if mga_vid works on my system?
+
��
+
��	There are test applications called mga_vid_test_g400 and mga_vid_test_g200.
+
��	Use the appropriate one for your card. This test code should draw some
+
��	nice 256x256 images for you if all is working well.