GStreamer multimedia framework
Find a file
Wind Yuan 60b5c2da97 mpeg4: fix handling of temporal reference distances.
TRD and TRB fields are not large enough to hold the difference of PTS
expressed with nanosecond resolution. So, compute them from the original
VOP info.

Signed-off-by: Gwenole Beauchesne <gwenole.beauchesne@intel.com>
2012-04-12 11:44:16 +02:00
debian.upstream vaapipostproc: add new element for video postprocessing. 2012-03-26 14:37:24 +02:00
docs Fix a few documentation issues. 2012-04-02 13:06:15 +02:00
gst Add initial JPEG decoder. 2012-04-11 19:38:12 +02:00
gst-libs mpeg4: fix handling of temporal reference distances. 2012-04-12 11:44:16 +02:00
pkgconfig Really fix make distclean. 2010-03-29 14:47:49 +00:00
tests Add initial H.264 decoder. 2012-01-29 15:27:59 +01:00
.gitignore .gitignore: add test-subpicture. 2012-01-06 17:15:32 +01:00
AUTHORS AUTHORS: update to match current authors. 2012-03-16 14:21:36 +01:00
autogen.sh autogen: don't configure if NO_CONFIGURE variable is set. 2011-12-09 10:44:52 +01:00
configure.ac Add initial JPEG decoder. 2012-04-11 19:38:12 +02:00
COPYING.LIB Relicense gst-libs/ code to LGPL v2.1+. 2010-09-20 12:55:42 +02:00
Makefile.am Nuke older build dir. 2010-09-20 12:55:46 +02:00
NEWS mpeg2: fix calculation of macroblock_offset. 2012-04-02 18:42:12 +02:00
README Update introduction and changelog. 2012-04-02 11:38:44 +02:00

  gstreamer-vaapi
  VA-API support to GStreamer

  Copyright (C) 2010-2011 Splitted-Desktop Systems
  Copyright (C) 2011-2012 Intel Corporation
  Copyright (C) 2011 Collabora Ltd.


License
-------

gstreamer-vaapi helper libraries and plugin elements are available
under the terms of the GNU Lesser General Public License v2.1+

Overview
--------

gstreamer-vaapi consists in a collection of VA-API based plugins for
GStreamer and helper libraries.

  * `vaapidecode' is used to decode MPEG-2, MPEG-4, H.264, VC-1, WMV3
    videos to video/x-vaapi-surfaces surfaces, depending on the
    underlying HW capabilities.

  * `vaapiupload' is used to convert from video/x-raw-yuv pixels to
    video/x-vaapi-surface surfaces.

  * `vaapidownload' is used to convert from video/x-vaapi-surface
    surfaces to video/x-raw-yuv pixels.

  * `vaapipostproc' is used to postprocess video/x-vaapi-surface
    surfaces, for e.g. deinterlacing.

  * `vaapisink' is used to display video/x-vaapi-surface surfaces to
    screen.


Features
--------

  * VA-API support from 0.29 to 0.32
  * MPEG-2, MPEG-4, H.264 and VC-1 ad-hoc decoders
  * OpenGL rendering through VA/GLX or GLX texture-from-pixmap + FBO
  * Support for major HW video decoding solutions on Linux (AMD, Intel, NVIDIA)


Requirements
------------

Software requirements

  * libva-dev >= 1.0.3 (VA/GLX)
  * libgstreamer0.10-dev >= 0.10.35.1
      or with GstBaseSink::query()
  * libgstreamer-plugins-base0.10-dev >= 0.10.35
  * libgstreamer-plugins-bad0.10-dev >= 0.10.22.1
      or with GstVideoContext, GstSurfaceBuffer, codecparsers

  If codecparsers-based decoders are not used:

  * libavcodec-dev >= 0.6
      or with <libavcodec/vaapi.h>

Hardware requirements

  * AMD platforms with UVD2 (XvBA supported)
  * Intel Eaglelake (G45)
  * Intel Ironlake, Sandy Bridge and Ivy Bridge (HD Graphics)
  * Intel Poulsbo (US15W)
  * Intel Medfield or Cedar Trail
  * NVIDIA platforms with PureVideo (VDPAU supported)


Usage
-----

  VA elements are automatically plugged into GStreamer pipelines. So,
  using playbin2 should work as is. However, here are a few alternate
  pipelines constructed manually.

  * Play an H.264 video with an MP4 container in fullscreen mode
  $ gst-launch-0.10 -v filesrc location=/path/to/video.mp4 ! \
      qtdemux ! vaapidecode ! vaapisink fullscreen=true

  * Play a raw MPEG-2 interlaced stream
  $ gst-launch-0.10 -v filesrc location=/path/to/mpeg2.bits ! \
      mpegvideoparse ! vaapidecode ! vaapipostproc ! vaapisink