mirrors/gstreamer: GStreamer multimedia framework

mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-26 10:10:32 +00:00

GStreamer multimedia framework

c gitlab gstreamer official-mirror video

Find a file

Gwenole Beauchesne 1c5c5ea9b8 h264: review and report errors accordingly. Use GST_ERROR() to report real errors instead of hiding them into GST_DEBUG().		2012-09-21 16:43:38 +02:00
debian.upstream	debian: fix packaging on recent Ubuntu platforms.	2012-09-20 14:48:21 +02:00
docs	docs: fix build for make dist.	2012-09-17 17:56:57 +02:00
gst	plugins: include "sysdeps.h" instead of "config.h".	2012-09-12 13:41:47 +02:00
gst-libs	h264: review and report errors accordingly.	2012-09-21 16:43:38 +02:00
pkgconfig	pkgconfig: fix dependencies and slightly improve description.	2012-09-07 15:31:09 +02:00
tests	tests: dump VA display properties.	2012-08-28 17:42:19 +02:00
.gitignore	libs: use generic g_cclosure_marshal_VOID__VOID().	2012-07-19 15:19:16 +02:00
AUTHORS	AUTHORS: update to match current authors.	2012-03-16 14:21:36 +01:00
autogen.sh	autogen: fix configure script generation when srcdir != builddir.	2012-08-27 10:25:18 +02:00
configure.ac	configure: fix check for libva-glx and libva-drm.	2012-09-14 17:30:19 +02:00
COPYING.LIB	Relicense gst-libs/ code to LGPL v2.1+.	2010-09-20 12:55:42 +02:00
Makefile.am	configure: put m4 macros and autogenerated files into m4/ directory.	2012-07-19 13:07:20 +02:00
NEWS	NEWS: updates.	2012-09-20 16:02:39 +02:00
README	README: updates.	2012-09-20 16:18:27 +02:00

README

  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
  * JPEG, 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 the Wayland display server
  * Support for headless decode pipelines with VA/DRM
  * 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

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