GStreamer multimedia framework
Find a file
U. Artie Eoff 9fd020a117 vaapipostproc: handle size and direction together in src events
Mapping a pointer event needs to consider both size and
video-direction operations together, not just one or the other.

This fixes an issue where x,y were not being mapped correctly
for 90r, 90l, ur-ll and ul-lr video-direction. In these directions,
the WxH are swapped and GST_VAAPI_POSTPROC_FLAG_SIZE is set.  Thus,
the first condition in the pointer event handling was entered and
x,y scale factor were incorrectly computed due to srcpad WxH
swap.

This also fixes all cases where both video-direction and scaling
are enabled at the same time.

Test that all pointer events map appropriately:

for i in `seq 0 7`
do
 GST_DEBUG=vaapipostproc:5 gst-launch-1.0 -vf videotestsrc \
  ! vaapipostproc video-direction=${i} width=300 \
  ! vaapisink
 GST_DEBUG=vaapipostproc:5 gst-launch-1.0 -vf videotestsrc \
  ! vaapipostproc video-direction=${i} width=300 height=200 \
  ! vaapisink
 GST_DEBUG=vaapipostproc:5 gst-launch-1.0 -vf videotestsrc \
  ! vaapipostproc video-direction=${i} height=200 \
  ! vaapisink
 GST_DEBUG=vaapipostproc:5 gst-launch-1.0 -vf videotestsrc \
  ! vaapipostproc video-direction=${i} \
  ! vaapisink
done
2019-09-04 16:03:24 -07:00
common@59cb678164 Update common submodule back to 59cb678164719ff59dcf6c8b93df4617a1075d11 2019-03-11 18:39:57 -03:00
docs docs: Update plugin cache 2019-05-16 20:20:52 +00:00
gst vaapipostproc: handle size and direction together in src events 2019-09-04 16:03:24 -07:00
gst-libs libs: encoder: clean two virtual func in encoder class 2019-08-30 21:21:04 +08:00
m4 build: handle git ignore in m4 directory 2016-03-09 20:28:21 +01:00
tests libs: remove surface's parent context 2019-08-20 17:11:23 +02:00
.gitlab-ci.yml Add Gitlab CI configuration 2018-11-12 17:43:54 +01:00
.gitmodules Update common submodule location 2018-11-05 05:41:13 +00:00
AUTHORS AUTHORS: Update 2015-12-07 12:47:04 +02:00
autogen.sh use gst-common submodule 2016-02-03 20:03:47 +01:00
ChangeLog Release 1.16.0 2019-04-19 00:38:13 +01:00
configure.ac meson: Bump minimal GLib version to 2.44 2019-06-03 08:56:23 +02:00
COPYING.LIB Relicense gst-libs/ code to LGPL v2.1+. 2010-09-20 12:55:42 +02:00
git.mk build: update git.mk 2016-05-06 12:16:44 +02:00
gstreamer-vaapi.doap Release 1.16.0 2019-04-19 00:38:13 +01:00
Makefile.am docs: Port to hotdoc 2019-05-13 17:00:00 -04:00
meson.build meson: Bump minimal GLib version to 2.44 2019-06-03 08:56:23 +02:00
meson_options.txt docs: Port to hotdoc 2019-05-13 17:00:00 -04:00
NEWS Release 1.16.0 2019-04-19 00:38:13 +01:00
README Update README 2019-06-28 17:28:02 +02:00
RELEASE Back to development 2019-04-19 11:00:07 +01:00

  gstreamer-vaapi
  VA-API support to GStreamer

  Copyright (C) 2010-2011 Splitted-Desktop Systems
  Copyright (C) 2011-2014 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.

  * `vaapi<CODEC>dec' is used to decode JPEG, MPEG-2, MPEG-4:2, H.264
    AVC, H.264 MVC, VP8, VC-1, WMV3, HEVC videos to VA surfaces,
    depending on the actual value of <CODEC> and the underlying
    hardware capabilities.  This plugin is also able to implicitly
    download the decoded surface to raw YUV buffers.

  * `vaapi<CODEC>enc' is used to encode into MPEG-2, H.264 AVC, H.264
    MVC, JPEG, VP8, HEVC videos, depending on the actual value of
    <CODEC> (mpeg2, h264, etc.) and the hardware capabilities. By
    default, raw format bitstreams are generated, so the result may be
    piped to a muxer, e.g. qtmux for MP4 containers.

  * `vaapipostproc' is used to filter VA surfaces, for e.g. scaling,
    deinterlacing (bob, motion-adaptive, motion-compensated), noise
    reduction or sharpening. This plugin is also used to upload raw
    YUV pixels into VA surfaces.

  * `vaapisink' is used to render VA surfaces to an X11 or Wayland
    display. This plugin also features a "headless" mode (DRM) more
    suited to remote transcode scenarios, with faster throughput.


Features
--------

  * VA-API support from 0.39
  * JPEG, MPEG-2, MPEG-4, H.264 AVC, H.264 MVC, VP8, VC-1, HEVC and
    VP9 ad-hoc decoders
  * MPEG-2, H.264 AVC,H.264 MVC, JPEG, VP8 and HEVC ad-hoc encoders
  * OpenGL rendering through VA/GLX or GLX texture-from-pixmap + FBO
  * Support for EGL backend
  * 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 Reductio, Color
      Balance, Skin-Tone-Enhancement
    - Advanced deinterlacing: Motion-Adaptive, Motion-Compensated


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

Software requirements

  * GStreamer 1.9.x:
      libgstreamer1.0-dev (>= 1.9.x)
      libgstreamer-plugins-base1.0-dev (>= 1.9.x)
      libgstreamer-plugins-bad1.0-dev (>= 1.9.0)

  * Renderers:
      DRM: libva-dev (>= 1.1.0), libdrm-dev, libudev-dev
      X11: libva-dev (>= 1.0.1)
      GLX: libva-dev (>= 1.0.3)
      Wayland: libva-dev (>= 1.1.0), libwayland-dev (>= 1.0.2)

Hardware requirements

  * Intel Eaglelake (G45)
  * Intel Ironlake, Sandybridge, Ivybridge, Haswell, Broadwell,
    Skylake, etc. (HD Graphics)
  * Intel BayTrail, Braswell
  * Intel Poulsbo (US15W)
  * Intel Medfield or Cedar Trail
  * Hardware supported by Mesa VA gallium state-tracker


Usage
-----

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

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

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

  * Convert from one pixel format to another, while also downscaling
  $ gst-launch-1.0 -v filesrc location=/path/to/raw_video.yuv ! \
      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 ! \
      vaapih264enc 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:
  <https://gstreamer.freedesktop.org/src/gstreamer-vaapi/>

  GitLab repository for work-in-progress changes is available at:
  <https://gitlab.freedesktop.org/gstreamer/gstreamer-vaapi>


Reporting Bugs
--------------

  Bugs can be reported in the GStreamer's GitLab system at:
  <https://gitlab.freedesktop.org/gstreamer/gstreamer-vaapi/issues>