Index: video.html =================================================================== RCS file: /cvsroot/mplayer/main/DOCS/video.html,v retrieving revision 1.130 diff -u -r1.130 video.html --- video.html 3 Feb 2003 17:06:47 -0000 1.130 +++ video.html 3 Feb 2003 17:47:27 -0000 @@ -220,14 +220,13 @@

2.3.1.2.2 DGA

-

2.3.1.2.2.1 Summary

+
PREAMBLE
-

This document tries to explain in some words what DGA is in general and what - the DGA video output driver for MPlayer can do (and what it - can't).

+

This section tries to explain in some words what DGA is in general and what + the DGA video output driver for MPlayer can do (and what it can't).

-

2.3.1.2.2.2 What is DGA

+
WHAT IS DGA

DGA is short for Direct Graphics Access and is a means for a program to bypass the X-Server and directly modifying the framebuffer memory. @@ -251,10 +250,10 @@

However DGA has some drawbacks. It seems it is somewhat dependent on the graphics chip you use and on the implementation of the X server's video - driver that controls this chip. So it does not work on every system ...

+ driver that controls this chip. So it does not work on every system.

-

2.3.1.2.2.3 Installing DGA support for MPlayer

+
INSTALLING DGA SUPPORT FOR MPLAYER

First make sure X loads the DGA extension, see in /var/log/XFree86.0.log:

@@ -291,7 +290,7 @@ much faster.

-

2.3.1.2.2.4 Resolution switching

+
RESOLUTION SWITCHING

The DGA driver allows for switching the resolution of the output signal. This avoids the need for doing (slow) software scaling and at the same time @@ -306,10 +305,10 @@ be found at: /var/log/XFree86.0.log.

-

See appendix A for some sample modeline definitions.

+

See some working modeline definitions here.

-

2.3.1.2.2.5 DGA & MPlayer

+
DGA & MPLAYER

DGA is used in two places with MPlayer: The SDL driver can be made to make use of it (-vo sdl:dga) and within the DGA driver (-vo dga). The above @@ -317,7 +316,7 @@ driver for MPlayer works.

-

2.3.1.2.2.6 Features of the DGA driver

+
FEATURES

The DGA driver is invoked by specifying -vo dga at the command line. The default behavior is to switch to a resolution matching the original @@ -356,7 +355,7 @@ CPU time!) depending on the implementation of DGA for your hardware.

-

2.3.1.2.2.7 Speed issues

+
SPEED ISSUES

Generally spoken, DGA framebuffer access should be at least as fast as using the X11 driver with the additional benefit of getting a fullscreen image. @@ -364,7 +363,7 @@ with some care, as for example, with the X11 driver they do not include the time used by the X-Server needed for the actual drawing. Hook a terminal to a serial line of your box and start top to see what is really going on in your - box...

+ box.

Generally spoken, the speedup done by using DGA against 'normal' use of X11 highly depends on your graphics card and how well the X-Server module for it @@ -381,7 +380,7 @@ CPUs might work at 400 MHZ and above.

-

2.3.1.2.2.8 Known bugs

+
KNOWN BUGS

Well, according to some developers of XFree, DGA is quite a beast. They tell you better not to use it. Its implementation is not always flawless @@ -397,14 +396,14 @@

  • Some drivers simply display strange colors.
  • Some drivers lie about the amount of memory they map into the process's address space, thus vo_dga won't use doublebuffering (SIS?).
  • -
  • some drivers seem to fail to report even a single valid mode. In this +
  • Some drivers seem to fail to report even a single valid mode. In this case the DGA driver will crash telling you about a nonsense mode of - 100000x100000 or the like ...
  • -
  • OSD only works with doublebuffering enabled.
  • + 100000x100000 or someathing like that. +
  • OSD only works with doublebuffering enabled (else it flickers).
  • -

    2.3.1.2.2.A Some modelines

    +
    SOME MODELINES
       Section "Modes"
    @@ -419,24 +418,10 @@
       EndSection
     
    -

    These entries work fine with my Riva128 chip, using nv.o X server driver +

    These entries work fine with authors (Acki) Riva128 chip, using nv.o X server driver module.

    -

    2.3.1.2.2.B Bug Reports

    - -

    If you experience troubles with the DGA driver please feel free to file - a bug report to me (e-mail address below). Please start MPlayer with - the -v option and include all lines in the bug report that start with - vo_dga:

    - -

    Please do also include the version of X11 you are using, the graphics card - and your CPU type. The X11 driver module (defined in XF86-Config) might - also help. Thanks!

    - -

    Acki (acki@acki-netz.de, www.acki-netz.de)

    - -

    2.3.1.2.3 SDL

    SDL (Simple Directmedia Layer) is basically a unified video/audio @@ -480,7 +465,7 @@ W/Smappings for * and / (mixer control) -

    Known bugs:

    +
    KNOWN BUGS