diff options
authorTim-Philipp Müller <>2018-03-19 20:30:28 +0000
committerTim-Philipp Müller <>2018-03-19 20:30:29 +0000
commit67ebe1f45a7ded01f27c91a583243770a829b8c9 (patch)
parentbfa2fbd39bea8928bbfcfe0e914dc6384b2140a5 (diff)
5 files changed, 209 insertions, 62 deletions
diff --git a/ChangeLog b/ChangeLog
index b18880de..1b1e9287 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,7 +1,30 @@
+=== release 1.14.0 ===
+2018-03-19 20:30:28 +0000 Tim-Philipp Müller <>
+ * ChangeLog:
+ * NEWS:
+ *
+ * gstreamer-vaapi.doap:
+ *
+ Release 1.14.0
+2018-03-12 16:59:01 +0000 Julien Isorce <>
+ * gst-libs/gst/vaapi/gstvaapidecoder_h264.c:
+ libs: decoder: h264: ensure num_ref_frames is greater than 0
+ Even if it is the h264parse fault or bad video file, vaapih264dec
+ should set a proper value for VAPictureParameterBufferH264.num_ref_frames
+ as the driver might use it.
+ Also see "info.ref_frames = dpb_size;" in
+ gstvaapidecoder_h264.c::ensure_context
=== release 1.13.91 ===
2018-03-13 19:32:05 +0000 Tim-Philipp Müller <>
+ * ChangeLog:
* gstreamer-vaapi.doap:
diff --git a/NEWS b/NEWS
index 407ab983..64dcb91e 100644
--- a/NEWS
+++ b/NEWS
@@ -3,17 +3,19 @@
-GStreamer 1.14.0 has not been released yet. It is scheduled for release
-in early March 2018.
+The GStreamer team is proud to announce a new major feature release in
+the stable 1.x API series of your favourite cross-platform multimedia
-There are unstable pre-releases available for testing and development
-purposes. The latest pre-release is version 1.13.91 (rc2) and was
-released on 12 March 2018.
+As always, this release is again packed with new features, bug fixes and
+other improvements.
+GStreamer 1.14.0 was released on 19 March 2018.
See for the latest
version of this document.
-_Last updated: Monday 12 March 2018, 18:00 UTC (log)_
+_Last updated: Monday 19 March 2018, 12:00 UTC (log)_
@@ -72,6 +74,13 @@ Highlights
- Major gobject-introspection annotation improvements for large parts
of the library API
+- GStreamer C# bindings have been revived and seen many updates and
+ fixes
+- The externally maintained GStreamer Rust bindings had many usability
+ improvements and cover most of the API now. Coinciding with the 1.14
+ release, a new release with the 1.14 API additions is happening.
Major new features and changes
@@ -153,7 +162,6 @@ New Elements
pipeline into multiple processes_ or his lightning talk from last
year's GStreamer Conference in Prague for all the gory details.
- proxysink and proxysrc are new elements to pass data from one
pipeline to another within the same process, very similar to the
existing inter elements, but not limited to raw audio and video
@@ -191,12 +199,14 @@ New Elements
- The curl plugin has gained a new curlhttpsrc element, which is
useful for testing HTTP protocol version 2.0 amongst other things.
+- The msdk plugin has gained a MPEG-2 video decoder(msdkmpeg2dec), VP8
+ decoder(msdkvp8dec) and a VC1/WMV decoder(msdkvc1dec)
Noteworthy new API
- GstPromise provides future/promise-like functionality. This is used
in the GStreamer WebRTC implementation.
- GstReferenceTimestampMeta is a new meta that allows you to attach
additional reference timestamps to a buffer. These timestamps don't
have to relate to the pipeline clock in any way. Examples of this
@@ -204,18 +214,15 @@ Noteworthy new API
counter on the capture side or the (local) UNIX timestamp when the
media was captured. The decklink elements make use of this.
- GstVideoRegionOfInterestMeta: it's now possible to attach generic
free-form element-specific parameters to a region of interest meta,
for example to tell a downstream encoder to use certain codec
parameters for a certain region.
- gst_bus_get_pollfd can be used to obtain a file descriptor for the
bus that can be poll()-ed on for new messages. This is useful for
integration with non-GLib event loops.
- gst_get_main_executable_path() can be used by wrapper plugins that
need to find things in the directory where the application
executable is located. In the same vein,
@@ -229,23 +236,19 @@ Noteworthy new API
function. gst-inspect-1.0 will use this information to print pad
- new convenience functions to iterate over element pads without using
the GstIterator API: gst_element_foreach_pad(),
gst_element_foreach_src_pad(), and gst_element_foreach_sink_pad().
- GstBaseSrc and appsrc have gained support for buffer lists:
GstBaseSrc subclasses can use gst_base_src_submit_buffer_list(), and
applications can use gst_app_src_push_buffer_list() to push a buffer
list into appsrc.
- The GstHarness unit test harness has a couple of new convenience
functions to retrieve all pending data in the harness in form of a
single chunk of memory.
- GstAudioStreamAlign is a new helper object for audio elements that
handles discontinuity detection and sample alignment. It will align
samples after the previous buffer's samples, but keep track of the
@@ -254,7 +257,6 @@ Noteworthy new API
This simply factors out code that was duplicated in a number of
elements into a common helper API.
- The GstVideoEncoder base class implements Quality of Service (QoS)
now. This is disabled by default and must be opted in by setting the
"qos" property, which will make the base class gather statistics
@@ -265,7 +267,6 @@ Noteworthy new API
can just drop them and skip encoding in the hope that the pipeline
will catch up.
- The GstVideoOverlay interface gained a few helper functions for
installing and handling a "render-rectangle" property on elements
that implement this interface, so that this functionality can also
@@ -274,7 +275,6 @@ Noteworthy new API
require all implementors to provide it which would not be
- A new base class, GstNonstreamAudioDecoder for non-stream audio
decoders was added to gst-plugins-bad. This base-class is meant to
be used for audio decoders that require the whole stream to be
@@ -283,7 +283,6 @@ Noteworthy new API
files (GYM/VGM/etc), MIDI files and others. The new openmptdec
element is based on this.
- Full list of API new in 1.14:
- GStreamer core API new in 1.14
- GStreamer base library API new in 1.14
@@ -320,7 +319,6 @@ New RTP features and improvements
streams in RED packets, and such streams need to be wrapped and
unwrapped in order to use ULPFEC with chrome.
- a few new buffer flags for FEC support:
GST_BUFFER_FLAG_NON_DROPPABLE can be used to mark important buffers,
e.g. to flag RTP packets carrying keyframes or codec setup data for
@@ -333,11 +331,12 @@ New RTP features and improvements
payloaders to make use of these.
- rtpbin now has an option for increasing timestamp offsets gradually:
- Instant large changes to the internal ts_offset may cause timestamps
- to move backwards and also cause visible glitches in media playback.
- The new "max-ts-offset-adjustment" and "max-ts-offset" properties
- let the application control the rate to apply changes to ts_offset.
- There have also been some EOS/BYE handling improvements in rtpbin.
+ Sudden large changes to the internal ts_offset may cause timestamps
+ to move backwards and may also cause visible glitches in media
+ playback. The new "max-ts-offset-adjustment" and "max-ts-offset"
+ properties let the application control the rate to apply changes to
+ ts_offset. There have also been some EOS/BYE handling improvements
+ in rtpbin.
- rtpjitterbuffer has a new fast start mode: in many scenarios the
jitter buffer will have to wait for the full configured latency
@@ -395,10 +394,10 @@ New element features
continue streaming if one of the inputs stops producing data.
- jpegenc has gained a "snapshot" property just like pngenc to make it
- easier to just output a single encoded frame.
+ easier to output just a single encoded frame.
- jpegdec will now handle interlaced MJPEG streams properly and also
- handle frames without an End of Image marker better.
+ handles frames without an End of Image marker better.
- v4l2: There are now video encoders for VP8, VP9, MPEG4, and H263.
The v4l2 video decoder handles dynamic resolution changes, and the
@@ -414,7 +413,7 @@ New element features
- rtspsrc now has support for RTSP protocol version 2.0 as well as
ONVIF audio backchannels (see below for more details). It also
- sports a new ["accept-certificate"] signal for "manually" checking a
+ sports a new "accept-certificate" signal for "manually" checking a
TLS certificate for validity. It now also prints RTSP/SDP messages
to the gstreamer debug log instead of stdout.
@@ -432,8 +431,9 @@ New element features
software like Adobe Premiere and FinalCut Pro to import the files
while they are still being written to. This only works with constant
framerate I-frame only streams, and for now only support for ProRes
- video and raw audio is implemented but adding new codecs is just a
- matter of defining appropriate maximum frame sizes.
+ video and raw audio is implemented. Adding support for additional
+ codecs is just a matter of defining appropriate maximum frame sizes
+ though.
- qtmux also supports writing of svmi atoms with stereoscopic video
information now. Trak timescales can be configured on a per-stream
@@ -441,7 +441,7 @@ New element features
new formats can be muxed: MPEG layer 1 and 2, AC3 and Opus, as well
as PNG and VP9.
-- souphttpsrc now does connection sharing by default, shares its
+- souphttpsrc now does connection sharing by default: it shares its
SoupSession with other elements in the same pipeline via a
GstContext if possible (session-wide settings are all the defaults).
This allows for connection reuse, cookie sharing, etc. Applications
@@ -466,7 +466,7 @@ New element features
will handle this just fine, but that's often more luck than by
design. In any case, it's not right, so we disallow it now.
-- matroskamux had Table of Content (TOC) support now (chapters etc.)
+- matroskamux has Table of Content (TOC) support now (chapters etc.)
and matroskademux TOC support has been improved. matroskademux has
also seen seeking improvements searching for the right cluster and
@@ -482,7 +482,6 @@ New element features
passing through data (e.g. because target-timecode and end-timecode
respectively have been reached).
- h265parse and h265parse will try harder to make upstream output the
same caps as downstream requires or prefers, thus avoiding
unnecessary conversion. The parsers also expose chroma format and
@@ -537,11 +536,18 @@ New element features
- work continued on the msdk plugin for Intel's Media SDK which
enables hardware-accelerated video encoding and decoding on Intel
- graphics hardware on Windows or Linux. More tuning options were
- added, and more pixel formats and video codecs are supported now.
- The encoder now also handles force-key-unit events and can insert
- frame-packing SEIs for side-by-side and top-bottom stereoscopic 3D
- video.
+ graphics hardware on Windows or Linux. Added the video memory,
+ buffer pool, and context/session sharing support which helps to
+ improve the performance and resource utilization. Rendernode support
+ is in place which helps to avoid the constraint of having a running
+ graphics server as DRM-Master. Encoders are exposing a number rate
+ control algorithms now. More encoder tuning options like
+ trellis-quantiztion (h264), slice size control (h264), B-pyramid
+ prediction(h264), MB-level bitrate control, frame partitioning and
+ adaptive I/B frame insertion were added, and more pixel formats and
+ video codecs are supported now. The encoder now also handles
+ force-key-unit events and can insert frame-packing SEIs for
+ side-by-side and top-bottom stereoscopic 3D video.
- dashdemux can now do adaptive trick play of certain types of DASH
streams, meaning it can do fast-forward/fast-rewind of normal (non-I
@@ -552,7 +558,6 @@ New element features
supports webvtt subtitle streams now and has seen improvements when
seeking in live streams.
- kmssink has seen lots of fixes and improvements in this cycle,
@@ -662,7 +667,7 @@ all scenarios, e.g. where the OpenGL driver does not properly support
multiple sharing contexts in different threads; on Linux Nouveau is
known to be broken in this respect, whilst NVIDIA's proprietary drivers
and most other drivers generally work fine, and the experience with
-Intel's driver seems to be fixed; some proprietary embedded Linux
+Intel's driver seems to be mixed; some proprietary embedded Linux
drivers don't work; macOS works).
GstPhysMemoryAllocator interface moved from -bad to -base
@@ -757,7 +762,6 @@ Tracing framework and debugging improvements
log handler of course, this just provides this functionality as part
of GStreamer.
- 'fakevideosink is a null sink for video data that advertises
video-specific metas ane behaves like a video sink. See above for
more details.
@@ -786,7 +790,7 @@ Tracing framework and debugging improvements
reordering if delay > packet-spacing, so by setting
"allow-reordering" to FALSE you guarantee that the packets are in
order, while at the same time introducing delay/jitter to them. By
- using the new "delay-distribution" property the use can control how
+ using the new "delay-distribution" property the user can control how
the delay applied to delayed packets is distributed: This is either
the uniform distribution (as before) or the normal distribution; in
addition there is also the gamma distribution which simulates the
@@ -810,9 +814,8 @@ Tools
GStreamer RTSP server
-- Initial support for [RTSP protocol version
- 2.0][rtsp2-lightning-talk] was added, which is to the best of our
- knowledge the first RTSP 2.0 implementation ever!
+- Initial support for RTSP protocol version 2.0 was added, which is to
+ the best of our knowledge the first RTSP 2.0 implementation ever!
- ONVIF audio backchannel support. This is an extension specified by
ONVIF that allows RTSP clients (e.g. a control room operator) to
@@ -824,7 +827,6 @@ GStreamer RTSP server
ONVIF-specific subclasses GstRTSPOnvifServer and
GstRTSPOnvifMediaFactory to enable this functionality.
- The internal server streaming pipeline is now dynamically
reconfigured on PLAY based on the transports needed. This means that
the server no longer adds the pipeline plumbing for all possible
@@ -852,22 +854,125 @@ GStreamer RTSP server
GStreamer VAAPI
-- this section will be filled in shortly {FIXME!}
+- Improve DMABuf's usage, both upstream and dowstream, and
+ memory:DMABuf caps feature is also negotiated when the dmabuf-based
+ buffer cannot be mapped onto user-space.
+- VA initialization was fixed when it is used in headless systems.
+- VA display sharing, through GstContext, among the pipeline, has been
+ improved, adding the possibility to the application share its VA
+ display (external display) via context.
+- VA display cache was removed.
+- libva's log messages are now redirected into the GStreamer log
+ handler.
+- Decoders improved their upstream re-negotiation by avoiding to
+ re-instantiate the internal decoder if stream caps are compatible
+ with the previous one.
+- When downstream doesn't support GstVideoMeta and the decoded frames
+ don't have standard strides, they are copied onto system
+ memory-based buffers.
+- H.264 decoder has a low-latency property, for live streams which
+ doesn't conform the H.264 specification but still it is required to
+ push the frames to downstream as soon as possible.
+- As part of the Google Summer of Code 2017 the H.264 decoder drops
+ MVC and SVC frames when base-only property is enabled.
+- Added support for libva-2.0 (VA-API 1.0).
+- H.264 and H.265 encoders handle Region-Of-Interest metas by adding a
+ delta-qp for every rectangle within the frame specified by those
+ metas.
+- Encoders for H.264 and H.265 set the media profile by the downstream
+ caps.
+- H.264 encoder inserts an AU delimiter for each encoded frame when
+ aud property is enabled (it is only available for certain drivers
+ and platforms).
+- H.264 encoder supports for P and B hierarchical prediction modes.
+- All encoders handles a quality-level property, which is a number
+ from 1 to 8, where a lower number means higher quality, but slower
+ processing, and vice-versa.
+- VP8 and VP9 encoders support constant bit-rate mode (CBR).
+- VP8, VP9 and H.265 encoders support variable bit-rate mode (VBR).
+- Resurrected GstGLUploadTextureMeta handling for EGL backends.
+- H.265 encoder can configure its number of reference frames via the
+ refs property.
+- Add H.264 encoder mbbrc property, which controls the macro-block
+ bitrate as auto, on or off.
+- Add H.264 encoder temporal-levels property, to select the number of
+ temporal levels to be included.
+- Add to H.264 and H.265 encoders the properties qp-ip and qp-ib, to
+ handle the QP (quality parameter) difference between the I and P
+ frames, and the I and B frames, respectively.
+- vaapisink was demoted to marginal rank on Wayland because COGL
+ cannot display YUV surfaces.
GStreamer Editing Services and NLE
-- this section will be filled in shortly {FIXME!}
+- Handle crossfade in complex scenarios by using the new
+ compositorpad::crossfade-ratio property
+- Add API allowing to stop using proxies for clips in the timeline
+- Allow management of none square pixel aspect ratios by allowing
+ application to deal with them in the way they want
+- Misc fixes around the timeline editing API
GStreamer validate
-- this section will be filled in shortly {FIXME!}
+- Handle running scenarios on live pipelines (in the "content sense",
+ not the GStreamer one)
+- Implement RTSP support with a basic server based on gst-rtsp-server,
+ and add RTSP 1.0 and 2.0 integration tests
-GStreamer Python Bindings
+- Implement a plugin that allows users to implement configurable
+ tests. It currently can check if a particular element is added a
+ configurable number of time in the pipeline. In the future that
+ plugin should allow us to implement specific tests of any kind in a
+ descriptive way
-- this section will be filled in shortly {FIXME!}
+- Add a verbosity configuration which behaves in a similare way as the
+ gst-launch-1.0 verbose flags allowing the informations to be
+ outputed on any running pipeline when enabling GstValidate.
+- Misc optimization in the launcher, making the tests run much faster.
+GStreamer C# bindings
+- Port to the meson build system, autotools support has been removed
+- Use a new GlibSharp version, set as a meson subproject
+- Update wrapped API to GStreamer 1.14
+- Removed the need for "glue" code
+- Provide a nuget
+- Misc API fixes
Build and Dependencies
@@ -1058,7 +1163,15 @@ the git 1.14 branch, which is a stable branch.
-1.14.0 is scheduled to be released in early March 2018.
+1.14.0 was released on 19 March 2018.
+The first 1.14 bug-fix release (1.14.1) is scheduled to be released
+around the end of March or beginning of April.
+This release only contains bugfixes and it should be safe to update from
Known Issues
@@ -1075,7 +1188,7 @@ unstable development version leading up to the stable 1.16 release. The
development of 1.15/1.16 will happen in the git master branch.
The plan for the 1.16 development cycle is yet to be confirmed, but it
-is expected that feature freeze will be around August 2017 followed by
+is expected that feature freeze will be around August 2018 followed by
several 1.15 pre-releases and the new 1.16 stable release in September.
1.16 will be backwards-compatible to the stable 1.14, 1.12, 1.10, 1.8,
@@ -1084,6 +1197,7 @@ several 1.15 pre-releases and the new 1.16 stable release in September.
_These release notes have been prepared by Tim-Philipp Müller with_
-_contributions from Sebastian Dröge._
+_contributions from Sebastian Dröge, Sreerenj Balachandran, Thibault
+Saunier_ _and Víctor Manuel Jáquez Leal._
_License: CC BY-SA 4.0_
diff --git a/ b/
index 49129abf..7b5d131c 100644
--- a/
+++ b/
@@ -1,7 +1,7 @@
# gstreamer-vaapi package version number
m4_define([gst_vaapi_major_version], [1])
-m4_define([gst_vaapi_minor_version], [13])
-m4_define([gst_vaapi_micro_version], [91])
+m4_define([gst_vaapi_minor_version], [14])
+m4_define([gst_vaapi_micro_version], [0])
m4_define([gst_vaapi_nano_version], [0])
@@ -16,17 +16,17 @@ dnl - interfaces added/removed/changed -> increment CURRENT, REVISION = 0
dnl - interfaces added -> increment AGE
dnl - interfaces removed -> AGE = 0
# gstreamer-vaapi library (libtool) version number
-m4_define([gst_vaapi_lt_current], [1391])
+m4_define([gst_vaapi_lt_current], [1400])
m4_define([gst_vaapi_lt_revision], [0])
-m4_define([gst_vaapi_lt_age], [1391])
+m4_define([gst_vaapi_lt_age], [1400])
# glib version number
m4_define([glib_version], [2.40])
# gstreamer version number
-m4_define([gst_version], [1.13.91])
-m4_define([gst_plugins_base_version], [1.13.91])
-m4_define([gst_plugins_bad_version], [1.13.91])
+m4_define([gst_version], [1.14.0])
+m4_define([gst_plugins_base_version], [1.14.0])
+m4_define([gst_plugins_bad_version], [1.14.0])
# Wayland minimum version number
m4_define([wayland_api_version], [1.0.2])
diff --git a/gstreamer-vaapi.doap b/gstreamer-vaapi.doap
index 3f471b98..97abcc7c 100644
--- a/gstreamer-vaapi.doap
+++ b/gstreamer-vaapi.doap
@@ -27,6 +27,16 @@
+ <revision>1.14.0</revision>
+ <branch>master</branch>
+ <name></name>
+ <created>2018-03-19</created>
+ <file-release rdf:resource="" />
+ </Version>
+ </release>
+ <release>
+ <Version>
diff --git a/ b/
index 6074f5b8..49139316 100644
--- a/
+++ b/
@@ -1,5 +1,5 @@
project('gstreamer-vaapi', 'c',
- version : '1.13.91',
+ version : '1.14.0',
meson_version : '>= 0.36.0',
default_options : [ 'warning_level=1',
'buildtype=debugoptimized' ])