media-video/mplayer/files/README-vdpau.txt

   1 MPlayer patches for VDPAU
   2
   3 Brief Overview:
   4         These patches add VDPAU support to ffmpeg and MPlayer:
   5
   6         * HW decode acceleration is provided for MPEG-1/2, H.264 and VC-1.
   7
   8         * A VDPAU video output module is added to MPlayer.
   9
  10 Current support:
  11         The NVIDIA 180.06 beta driver for Linux, Solaris, and FreeBSD
  12         provides initial VDPAU support for some GeForce 8xxx and 9xxx
  13         series GPUs.  Please see the VDPAU announcement on the nvnews.net
  14         Linux forum for further details.
  15
  16 Prerequisite:
  17         The following should be acquired using your distribution package
  18         management system, or from source if required:
  19
  20         * Subversion (svn); See http://subversion.tigris.org
  21         * C development tools: make, gcc, binutils.
  22         * Various X11 libraries (and their development packages)
  23           that MPlayer relies upon.
  24
  25 Installing the patch:
  26         Run the supplied shell script:
  27
  28         $ sh checkout-patch-build.sh
  29
  30 Running MPlayer:
  31         $ cd mplayer-vdpau
  32         $ ./mplayer -vc <VDPAU-codec-name> -vo vdpau <filename>
  33
  34         'VDPAU-codec-name' can be one of:
  35
  36             ffmpeg12vdpau
  37             ffh264vdpau
  38             ffwmv3vdpau
  39             ffvc1vdpau
  40
  41         based on the type of video bitstream (ffmpeg12vdpau for MPEG-1
  42         or MPEG-2, ffh264vdpau for H.264, ffwmv3vdpau for WMV3, and
  43         ffvc1vdpau for VC-1).
  44
  45         If a VDPAU codec is used, the VDPAU output module must be used.
  46
  47         Alternatively, you may use the VDPAU output module without specifying
  48         a VDPAU codec. In this case, the bitstream decoding is not accelerated
  49         using VDPAU, but the decoded video is still presented using VDPAU:
  50
  51         $ cd mplayer-vdpau
  52         $ ./mplayer -vo vdpau <filename>
  53
  54 Known Limitations:
  55         1. Playing some video streams may cause GPU errors and/or hang or
  56            crash the system.
  57         2. The skip forward/backward features are not robust yet and
  58            can cause application or system hangs/crashes.
  59         3. MPlayer OSD or Composite Picture is currently not supported.
  60         4. Problems have been observed when building MPlayer with these
  61            patches using gcc-4.3.2.
  62
  63 Example Movie Clips:
  64         MPEG:   http://inventaaustralia.zftp.com.nyud.net/videos/MPEGIO3MBPS30sec.mpg
  65                 ./mplayer -vo vdpau -vc ffmpeg12vdpau MPEGIO3MBPS30sec.mpg
  66
  67         H.264:  http://samples.mplayerhq.hu.nyud.net/V-codecs/h264/PAFF/Grey.ts
  68                 ./mplayer -vo vdpau -vc ffh264vdpau Grey.ts
  69                 http://samples.mplayerhq.hu.nyud.net/V-codecs/h264/nature_704x576_25Hz_1500kbits.h264
  70                 ./mplayer -vo vdpau -vc ffh264vdpau nature_704x576_25Hz_1500kbits.h264
  71
  72         WMV3:   http://download.microsoft.com.nyud.net/download/0/9/d/09d051c4-decc-4d39-9c57-f520187213a1/Amazing_Caves_720.exe
  73                     (use `unzip` to extract the .exe)
  74                 ./mplayer -vo vdpau -vc ffwmv3vdpau Amazing_Caves_720.wmv
  75
  76         VC-1:   http://samples.mplayerhq.hu.nyud.net/V-codecs/WVC1/FlightSimX_720p60_51_15Mbps.wmv
  77                 ./mplayer -vo vdpau -vc ffvc1vdpau FlightSimX_720p60_51_15Mbps.wmv
  78
  79         Note: .nyud.net added to the above URLs to cache the content on CoralCDN (http://www.coralcdn.org/)
  80