summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorGwenole Beauchesne <gwenole.beauchesne@intel.com>2014-01-23 19:32:28 +0100
committerGwenole Beauchesne <gwenole.beauchesne@intel.com>2014-01-23 19:33:15 +0100
commit271fb8298d2fa3371b5013fefa9b4b2e458032ca (patch)
treeff763665ec0c862b2d26ae7018ad4dd318081b38 /README
parent0b176dea0f7bedf84dd17ff5a2d50bc069c06027 (diff)
README: updates.
VA-API up to 0.34.0 is actually supported. Mention new video encoding support. Update copyright years, list of supported Intel HD Graphics hardware.
Diffstat (limited to 'README')
-rw-r--r--README35
1 files changed, 31 insertions, 4 deletions
diff --git a/README b/README
index bfb7993c..69c84135 100644
--- a/README
+++ b/README
@@ -3,7 +3,7 @@
VA-API support to GStreamer
Copyright (C) 2010-2011 Splitted-Desktop Systems
- Copyright (C) 2011-2013 Intel Corporation
+ Copyright (C) 2011-2014 Intel Corporation
Copyright (C) 2011 Collabora Ltd.
@@ -24,6 +24,11 @@ GStreamer and helper libraries.
WMV3 videos to video/x-vaapi-surfaces surfaces, depending on the
underlying HW capabilities.
+ * `vaapiencode_<CODEC>' is used to encode into MPEG-2, H.264 videos,
+ depending on the actual value of <CODEC> (mpeg2, h264, etc.). By
+ default, raw format bitstreams are generated, so the result may be
+ piped to an actual muxer like qtmux for MP4 containers.
+
* `vaapiupload' is used to convert from video/x-raw-yuv pixels to
video/x-vaapi-surface surfaces.
@@ -40,12 +45,14 @@ GStreamer and helper libraries.
Features
--------
- * VA-API support from 0.29 to 0.32
+ * VA-API support from 0.29 to 0.34
* JPEG, MPEG-2, MPEG-4, H.264 and VC-1 ad-hoc decoders
+ * MPEG-2, H.264 ad-hoc encoders
* 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)
+ * Support for HW video encoding on Intel HD Graphics hardware
* Support for VA Video Processing APIs (VA/VPP)
- Scaling and color conversion
- Image enhancement filters: Sharpening, Noise Reduction
@@ -65,7 +72,7 @@ Software requirements
libgstreamer-plugins-bad0.10-dev (>= 0.10.22.1)
or with GstVideoContext, GstSurfaceBuffer, codecparsers
- * GStreamer 1.0.x (including GStreamer 1.2):
+ * GStreamer 1.0.x (including GStreamer 1.2, 1.3):
libglib2.0-dev (>= 2.28)
libgstreamer1.0-dev (>= 1.0.0)
libgstreamer-plugins-base1.0-dev (>= 1.0.0)
@@ -81,7 +88,7 @@ Hardware requirements
* AMD platforms with UVD2 (XvBA supported)
* Intel Eaglelake (G45)
- * Intel Ironlake, Sandy Bridge and Ivy Bridge (HD Graphics)
+ * Intel Ironlake, Sandybridge, Ivybridge and Haswell (HD Graphics)
* Intel Poulsbo (US15W)
* Intel Medfield or Cedar Trail
* NVIDIA platforms with PureVideo (VDPAU supported)
@@ -108,6 +115,26 @@ Usage
videoparse format=yuy2 width=1280 height=720 ! \
vaapipostproc format=nv12 height=480 ! vaapisink
+ * Encode a 1080p stream in raw I420 format into H.264
+ $ gst-launch-1.0 -v filesrc location=/path/to/raw_video.yuv ! \
+ videoparse format=i420 width=1920 height=1080 framerate=30/1 ! \
+ vaapiencode_h264 rate-control=cbr tune=high-compression ! \
+ qtmux ! filesink location=/path/to/encoded_video.mp4
+
+
+Sources
+-------
+
+ gstreamer-vaapi is Open Source software, so updates to this
+ framework are really easy to get.
+
+ Stable source code releases can be found at:
+ <http://www.freedesktop.org/software/vaapi/releases/gstreamer-vaapi/>
+
+ Git repository for work-in-progress changes is available at:
+ <http://gitorious.org/vaapi/gstreamer-vaapi>
+
+
Reporting Bugs
--------------