gstreamer/README
Gwenole Beauchesne 894d65b81a vaapipostproc: add new element for video postprocessing.
Add vaapipostproc element for video postprocessing. So far, only basic
bob deinterlacing is implemented. Interlaced mode is automatically
detected based on sink caps ("interlaced" field).
2012-03-26 14:37:24 +02:00

80 lines
2.1 KiB
Text

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
-----
* 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