qtdemux: Make function foreach method friendly
[platform/upstream/gst-plugins-good.git] / NEWS
diff --git a/NEWS b/NEWS
index 74fb1ea..5366a0d 100644 (file)
--- a/NEWS
+++ b/NEWS
-# GStreamer 1.12 Release Notes
 
 
-GStreamer 1.12.0 was originally released on 4th May 2017.
 
 
-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 framework!
+GSTREAMER 1.16 RELEASE NOTES
 
 
-As always, this release is again packed with new features, bug fixes and other
-improvements.
 
 
-See [https://gstreamer.freedesktop.org/releases/1.12/][latest] for the latest
-version of this document.
-
-*Last updated: Thursday 4 May 2017, 11:00 UTC [(log)][gitlog]*
-
-[latest]: https://gstreamer.freedesktop.org/releases/1.12/
-[gitlog]: https://cgit.freedesktop.org/gstreamer/www/log/src/htdocs/releases/1.12/release-notes-1.12.md
-
-## Introduction
-
-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 framework!
-
-As always, this release is again packed with new features, bug fixes and other
-improvements.
-
-## Highlights
-
-- new `msdk` plugin for Intel's Media SDK for hardware-accelerated video
-  encoding and decoding on Intel graphics hardware on Windows or Linux.
-
-- `x264enc` can now use multiple x264 library versions compiled for different
-  bit depths at runtime, to transparently provide support for multiple bit
-  depths.
-
-- `videoscale` and `videoconvert` now support multi-threaded scaling and
-  conversion, which is particularly useful with higher resolution video.
-
-- `h264parse` will now automatically insert AU delimiters if needed when
-  outputting byte-stream format, which improves standard compliance and
-  is needed in particular for HLS playback on iOS/macOS.
-
-- `rtpbin` has acquired bundle support for incoming streams
-
-## Major new features and changes
-
-### Noteworthy new API
-
-- The video library gained support for a number of new video formats:
-
-  - `GBR_12LE`, `GBR_12BE`, `GBRA_12LE`, `GBRA_12BE` (planar 4:4:4 RGB/RGBA, 12 bits per channel)
-  - `GBRA_10LE`, `GBRA_10BE` (planar 4:4:4:4 RGBA, 10 bits per channel)
-  - `GBRA` (planar 4:4:4:4 ARGB, 8 bits per channel)
-  - `I420_12BE`, `I420_12LE` (planar 4:2:0 YUV, 12 bits per channel)
-  - `I422_12BE`,`I422_12LE` (planar 4:2:2 YUV, 12 bits per channel)
-  - `Y444_12BE`, `Y444_12LE` (planar 4:4:4 YUV, 12 bits per channel)
-  - `VYUY` (another packed 4:2:2 YUV format)
-
-- The high-level `GstPlayer` API was extended with functions for taking video
-  snapshots and enabling accurate seeking. It can optionally also use the
-  still-experimental `playbin3` element now.
-
-### New Elements
-
-- msdk: new plugin for Intel's Media SDK for hardware-accelerated video encoding
-  and decoding on Intel graphics hardware on Windows or Linux. This includes
-  an H.264 encoder/decoder (`msdkh264dec`, `msdkh264enc`),
-  an H.265 encoder/decoder (`msdkh265dec`, `msdkh265enc`),
-  an MJPEG encoder/encoder (`msdkmjpegdec`, `msdkmjpegenc`),
-  an MPEG-2 video encoder (`msdkmpeg2enc`) and a VP8 encoder (`msdkvp8enc`).
-
-- `iqa` is a new Image Quality Assessment plugin based on [DSSIM][dssim],
-  similar to the old (unported) videomeasure element.
-
-- The `faceoverlay` element, which allows you to overlay SVG graphics over
-  a detected face in a video stream, has been ported from 0.10.
-
-- our `ffmpeg` wrapper plugin now exposes/maps the ffmpeg Opus audio decoder
-  (`avdec_opus`) as well as the GoPro CineForm HD / CFHD decoder (`avdec_cfhd`),
-  and also a parser/writer for the IVF format (`avdemux_ivf` and `avmux_ivf`).
-
-- `audiobuffersplit` is a new element that splits raw audio buffers into
-  equal-sized buffers
-
-- `audiomixmatrix` is a new element that mixes N:M audio channels according to
-  a configured mix matrix.
-
-- The `timecodewait` element got renamed to `avwait` and can operate in
-  different modes now.
-
-- The `opencv` video processing plugin has gained a new `dewarp` element that
-  dewarps fisheye images.
-
-- `ttml` is a new plugin for parsing and rendering subtitles in Timed Text
-  Markup Language (TTML) format. For the time being these elements will not
-  be autoplugged during media playback however, unless the `GST_TTML_AUTOPLUG=1`
-  environment variable is set. Only the EBU-TT-D profile is supported at this
-  point.
-
-[dssim]: https://github.com/pornel/dssim
-
-### New element features and additions
+GStreamer 1.16 has not been released yet. It is scheduled for release
+around September 2018.
 
 
-- `x264enc` can now use multiple x264 library versions compiled for different
-  bit depths at runtime, to transparently provide support for multiple bit
-  depths. A new configure parameter `--with-x264-libraries` has been added to
-  specify additional paths to look for additional x264 libraries to load.
-  Background is that the libx264 library is always compile for one specific
-  bit depth and the `x264enc` element would simply support the depth supported
-  by the underlying library. Now we can support multiple depths.
+1.15.0.1 is the unstable development version that is being developed in
+the git master branch and which will eventually result in 1.16.
 
 
-- `x264enc` also picks up the interlacing mode automatically from the input
-  caps now and passed interlacing/TFF information correctly to the library.
+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
+several 1.15 pre-releases and the new 1.16 stable release in September.
 
 
-- `videoscale` and `videoconvert` now support multi-threaded scaling and
-  conversion, which is particularly useful with higher resolution video.
-  This has to be enabled explicitly via the `"n-threads"` property.
+1.16 will be backwards-compatible to the stable 1.14, 1.12, 1.10, 1.8,
+1.6, 1.4, 1.2 and 1.0 release series.
 
 
-- `videorate`'s new `"rate"` property lets you set a speed factor
-  on the output stream
-
-- `splitmuxsink`'s buffer collection and scheduling was rewritten to make
-  processing and splitting deterministic; before it was possible for a buffer
-  to end up in a different file chunk in different runs. `splitmuxsink` also
-  gained a new `"format-location-full"` signal that works just like the existing
-  `"format-location"` signal only that it is also passed the primary stream's
-  first buffer as argument, so that it is possible to construct the file name
-  based on metadata such as the buffer timestamp or any GstMeta attached to
-  the buffer. The new `"max-size-timecode"` property allows for timecode-based
-  splitting. `splitmuxsink` will now also automatically start a new file if the
-  input caps change in an incompatible way.
-
-- `fakesink` has a new `"drop-out-of-segment"` property to not drop
-  out-of-segment buffers, which is useful for debugging purposes.
-
-- `identity` gained a `"ts-offset"` property.
-
-- both `fakesink` and `identity` now also print what kind of metas are attached
-  to buffers when printing buffer details via the `"last-message"` property
-  used by `gst-launch-1.0 -v`.
-
-- multiqueue: made `"min-interleave-time"` a configurable property.
-
-- video nerds will be thrilled to know that `videotestsrc`'s snow is now
-  deterministic. `videotestsrc` also gained some new properties to make the
-  ball pattern based on system time, and invert colours each second
-  (`"animation-mode"`, `"motion"`, and `"flip"` properties).
-
-- `oggdemux` reverse playback should work again now. You're welcome.
-
-- `playbin3` and `urisourcebin` now have buffering enabled by default, and
-  buffering message aggregation was fixed.
-
-- `tcpclientsrc` now has a `"timeout"` property
-
-- `appsink` has gained support for buffer lists. For backwards compatibility
-  reasons users need to enable this explicitly with `gst_app_sink_set_buffer_list_support()`,
-  however. Once activated, a pulled `GstSample` can contain either a buffer
-  list or a single buffer.
-
-- `splitmuxsrc` reverse playback was fixed and handling of sparse streams, such
-  as subtitle tracks or metadata tracks, was improved.
-
-- `matroskamux` has acquired support for muxing G722 audio; it also marks all
-  buffers as keyframes now when streaming only audio, so that `tcpserversink`
-  will behave properly with audio-only streams.
-
-- `qtmux` gained support for ProRes 4444 XQ, HEVC/H.265 and CineForm (GoPro) formats,
-  and generally writes more video stream-related metadata into the track headers.
-  It is also allows configuration of the maximum interleave size in bytes and
-  time now. For fragmented mp4 we always write the `tfdt` atom now as required
-  by the DASH spec.
-
-- `qtdemux` supports FLAC, xvid, mp2, S16L and CineForm (GoPro) tracks now, and
-  generally tries harder to extract more video-related information from track
-  headers, such as colorimetry or interlacing details. It also received a
-  couple of fixes for the scenario where upstream operates in TIME format and
-  feeds chunks to qtdemux (e.g. DASH or MSE).
-
-- `audioecho` has two new properties to apply a delay only to certain channels
-  to create a surround effect, rather than an echo on all channels. This is
-  useful when upmixing from stereo, for example. The `"surround-delay"` property
-  enables this, and the `"surround-mask"` property controls which channels
-  are considered surround sound channels in this case.
-
-- `webrtcdsp` gained various new properties for gain control and also exposes
-  voice activity detection now, in which case it will post `"voice-activity"`
-  messages on the bus whenever the voice detection status changes.
-
-- The `decklink` capture elements for Blackmagic Decklink cards have seen a
-  number of improvements:
-
-  - `decklinkvideosrc` will post a warning message on "no signal" and an info
-    message when the signal lock has been (re)acquired. There is also a new
-    read-only `"signal"` property that can be used to query the signal lock
-    status. The `GAP` flag will be set on buffers that are captured without
-    a signal lock. The new `drop-no-signal-frames` will make `decklinkvideosrc`
-    drop all buffers that have been captured without an input signal. The
-    `"skip-first-time"` property will make the source drop the first few
-    buffers, which is handy since some devices will at first output buffers
-    with the wrong resolution before they manage to figure out the right input
-    format and decide on the actual output caps.
-
-  - `decklinkaudiosrc` supports more than just 2 audio channels now.
-
-  - The capture sources no longer use the "hardware" timestamps which turn
-    out to be useless and instead just use the pipeline clock directly.
-
-- `srtpdec` now also has a readonly `"stats"` property, just like `srtpenc`.
-
-- `rtpbin` gained RTP bundle support, as used by e.g. WebRTC. The first
-   rtpsession will have a `rtpssrcdemux` element inside splitting the streams
-   based on their SSRC and potentially dispatch to a different rtpsession.
-   Because retransmission SSRCs need to be merged with the corresponding media
-   stream the `::on-bundled-ssrc` signal is emitted on `rtpbin` so that the
-   application can find out to which session the SSRC belongs.
-
-- `rtprtxqueue` gained two new properties exposing retransmission
-  statistics (`"requests"` and `"fulfilled-requests"`)
-
-- `kmssink` will now use the preferred mode for the monitor and render to the
-  base plane if nothing else has set a mode yet. This can also be done forcibly
-  in any case via the new `"force-modesetting"` property. Furthermore, `kmssink`
-  now allows only the supported connector resolutions as input caps in order to
-  avoid scaling or positioning of the input stream, as `kmssink` can't know
-  whether scaling or positioning would be more appropriate for the use case at
-  hand.
-
-- `waylandsink` can now take DMAbuf buffers as input in the presence
-  of a compatible Wayland compositor. This enables zero-copy transfer
-  from a decoder or source that outputs DMAbuf.
-
-- `udpsrc` can be bound to more than one interface when joining a
-  multicast group, this is done by giving a comma separate list of
-  interfaces such as multicast-iface="eth0,eth1".
-
-### Plugin moves
-
-- `dataurisrc` moved from gst-plugins-bad to core
-
-- The `rawparse` plugin containing the `rawaudioparse` and `rawvideoparse`
-  elements moved from gst-plugins-bad to gst-plugins-base. These elements
-  supersede the old `videoparse` and `audioparse` elements. They work the
-  same, with just some minor API changes. The old legacy elements still
-  exist in gst-plugins-bad, but may be removed at some point in the future.
-
-- `timecodestamper` is an element that attaches time codes to video buffers
-  in form of `GstVideoTimeCodeMeta`s. It had a `"clock-source"` property
-  which has now been removed because it was fairly useless in practice. It
-  gained some new properties however: the `"first-timecode"` property can
-  be used to set the inital timecode; alternatively `"first-timecode-to-now"`
-  can be set, and then the current system time at the time the first buffer
-  arrives is used as base time for the time codes.
-
-
-### Plugin removals
-
-- The `mad` mp1/mp2/mp3 decoder plugin was removed from gst-plugins-ugly,
-  as libmad is GPL licensed, has been unmaintained for a very long time, and
-  there are better alternatives available. Use the `mpg123audiodec` element
-  from the `mpg123` plugin in gst-plugins-ugly instead, or `avdec_mp3` from
-  the `gst-libav` module which wraps the ffmpeg library. We expect that we
-  will be able to move mp3 decoding to gst-plugins-good in the next cycle
-  seeing that most patents around mp3 have expired recently or are about to
-  expire.
-
-- The `mimic` plugin was removed from gst-plugins-bad. It contained a decoder
-  and encoder for a video codec used by MSN messenger many many years ago (in
-  a galaxy far far away). The underlying library is unmaintained and no one
-  really needs to use this codec any more. Recorded videos can still be played
-  back with the MIMIC decoder in gst-libav.
-
-## Miscellaneous API additions
-
-- Request pad name templates passed to `gst_element_request_pad()` may now
-  contain multiple specifiers, such as e.g. `src_%u_%u`.
-
-- [`gst_buffer_iterate_meta_filtered()`][buffer-iterate-meta-filtered] is a
-  variant of `gst_buffer_iterate_meta()` that only returns metas of the
-  requested type and skips all other metas.
-
-- [`gst_pad_task_get_state()`][pad-task-get-state] gets the current state of
-  a task in a thread-safe way.
-
-- [`gst_uri_get_media_fragment_table()`][uri-get-fragment-table] provides the
-  media fragments of an URI as a table of key=value pairs.
-
-- [`gst_print()`][print], [`gst_println()`][println], [`gst_printerr()`][printerr],
-  and [`gst_printerrln()`][printerrln] can be used to print to stdout or stderr.
-  These functions are similar to `g_print()` and `g_printerr()` but they also
-  support all the additional format specifiers provided by the GStreamer
-  logging system, such as e.g. `GST_PTR_FORMAT`.
-
-- a `GstParamSpecArray` has been added, for elements who want to have array
-  type properties, such as the `audiomixmatrix` element for example. There are
-  also two new functions to set and get properties of this type from bindings:
-   - gst_util_set_object_array()
-   - gst_util_get_object_array()
-
-- various helper functions have been added to make it easier to set or get
-  GstStructure fields containing caps-style array or list fields from language
-  bindings (which usually support GValueArray but don't know about the GStreamer
-  specific fundamental types):
-   - [`gst_structure_get_array()`][get-array]
-   - [`gst_structure_set_array()`][set-array]
-   - [`gst_structure_get_list()`][get-list]
-   - [`gst_structure_set_list()`][set-list]
-
-- a new ['dynamic type' registry factory type][dynamic-type] was added to
-  register dynamically loadable GType types. This is useful for automatically
-  loading enum/flags types that are used in caps, such as for example the
-  `GstVideoMultiviewFlagsSet` type used in multiview video caps.
-
-- there is a new [`GstProxyControlBinding`][proxy-control-binding] for use
-  with GstController. This allows proxying the control interface from one
-  property on one GstObject to another property (of the same type) in another
-  GstObject. So e.g. in parent-child relationship, one may need to call
-  `gst_object_sync_values()` on the child and have a binding (set elsewhere)
-  on the parent update the value. This is used in `glvideomixer` and `glsinkbin`
-  for example, where `sync_values()` on the child pad or element will call
-  `sync_values()` on the exposed bin pad or element.
-
-  Note that this doesn't solve GObject property forwarding, that must
-  be taken care of by the implementation manually or using GBinding.
-
-- `gst_base_parse_drain()` has been made public for subclasses to use.
-
-- `gst_base_sink_set_drop_out_of_segment()' can be used by subclasses to
-  prevent GstBaseSink from dropping buffers that fall outside of the segment.
-
-- [`gst_calculate_linear_regression()`][calc-lin-regression] is a new utility
-  function to calculate a linear regression.
-
-- [`gst_debug_get_stack_trace`][get-stack-trace] is an easy way to retrieve a
-  stack trace, which can be useful in tracer plugins.
-
-- allocators: the dmabuf allocator is now sub-classable, and there is a new
-  `GST_CAPS_FEATURE_MEMORY_DMABUF` define.
-
-- video decoder subclasses can use the newly-added function
-  `gst_video_decoder_allocate_output_frame_with_params()` to
-  pass a `GstBufferPoolAcquireParams` to the buffer pool for
-  each buffer allocation.
-
-- the video time code API has gained a dedicated [`GstVideoTimeCodeInterval`][timecode-interval]
-  type plus related API, including functions to add intervals to timecodes.
-
-- There is a new `libgstbadallocators-1.0` library in gst-plugins-bad, which
-  may go away again in future releases once the `GstPhysMemoryAllocator`
-  interface API has been validated by more users and was moved to
-  `libgstallocators-1.0` from gst-plugins-base.
-
-[timecode-interval]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-gstvideo.html#gst-video-time-code-interval-new
-[buffer-iterate-meta-filtered]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstBuffer.html#gst-buffer-iterate-meta-filtered
-[pad-task-get-state]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#gst-pad-task-get-state
-[uri-get-fragment-table]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstUri.html#gst-uri-get-media-fragment-table
-[print]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-print
-[println]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-println
-[printerr]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-printerr
-[printerrln]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-printerrln
-[get-array]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-get-array
-[set-array]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-set-array
-[get-list]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-get-list
-[set-list]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-set-list
-[dynamic-type]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstDynamicTypeFactory.html
-[proxy-control-binding]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer-libs/html/gstreamer-libs-GstProxyControlBinding.html
-[calc-lin-regression]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstUtils.html#gst-calculate-linear-regression
-[get-stack-trace]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstUtils.html#gst-debug-get-stack-trace
-
-### GstPlayer
-
-New API has been added to:
-
- - get the number of audio/video/subtitle streams:
-   - `gst_player_media_info_get_number_of_streams()`
-   - `gst_player_media_info_get_number_of_video_streams()`
-   - `gst_player_media_info_get_number_of_audio_streams()`
-   - `gst_player_media_info_get_number_of_subtitle_streams()`
-
- - enable accurate seeking: `gst_player_config_set_seek_accurate()`
-   and `gst_player_config_get_seek_accurate()`
-
- - get a snapshot image of the video in RGBx, BGRx, JPEG, PNG or
-   native format: [`gst_player_get_video_snapshot()`][snapshot]
-
- - selecting use of a specific video sink element
-   ([`gst_player_video_overlay_video_renderer_new_with_sink()`][renderer-with-vsink])
-
- - If the environment variable `GST_PLAYER_USE_PLAYBIN3` is set, GstPlayer will
-   use the still-experimental `playbin3` element and the `GstStreams` API for
-   playback.
-
-[snapshot]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-bad-libs/html/gst-plugins-bad-libs-gstplayer.html#gst-player-get-video-snapshot
-[renderer-with-vsink]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-bad-libs/html/gst-plugins-bad-libs-gstplayer-videooverlayvideorenderer.html#gst-player-video-overlay-video-renderer-new-with-sink
-
-## Miscellaneous changes
-
-- video caps for interlaced video may contain an optional `"field-order"` field
-  now in the case of `interlaced-mode=interleaved` to signal that the field
-  order is always the same throughout the stream. This is useful to signal to
-  muxers such as mp4mux. The new field is parsed from/to `GstVideoInfo` of course.
-
-- video decoder and video encoder base classes try harder to proxy
-  interlacing, colorimetry and chroma-site related fields in caps properly.
-
-- The buffer stored in the `PROTECTION` events is now left unchanged. This is a
-  change of behaviour since 1.8, especially for the mssdemux element which used to
-  decode the base64 parsed data wrapped in the protection events emitted by the
-  demuxer.
-
-- `PROTECTION` events can now be injected into the pipeline from the application;
-  source elements deriving from GstBaseSrc will forward those downstream now.
-
-- The DASH demuxer is now correctly parsing the MSPR-2.0 ContentProtection nodes
-  and emits Protection events accordingly. Applications relying on those events
-  might need to decode the base64 data stored in the event buffer before using it.
-
-- The registry can now also be disabled by setting the environment variable
-  `GST_REGISTRY_DISABLE=yes`, with similar effect as the `GST_DISABLE_REGISTRY`
-  compile time switch.
-
-- Seeking performance with gstreamer-vaapi based decoders was improved. It would
-  recreate the decoder and surfaces on every seek which can be quite slow.
-
-- more robust handling of input caps changes in videoaggregator-based elements
-  such as `compositor`.
-
-- Lots of adaptive streaming-related fixes across the board (DASH, MSS, HLS). Also:
-
-  - `mssdemux`, the Microsoft Smooth Streaming demuxer, has seen various
-    fixes for live streams, duration reporting and seeking.
-
-  - The DASH manifest parser now extracts MS PlayReady ContentProtection objects
-    from manifests and sends them downstream as `PROTECTION` events. It also
-    supports multiple Period elements in external xml now.
-
-- gst-libav was updated to ffmpeg 3.3 but should still work with any 3.x
-  version.
+See https://gstreamer.freedesktop.org/releases/1.16/ for the latest
+version of this document.
 
 
-- GstEncodingProfile has been generally enhanced so it can, for
-  example, be used to get possible profiles for a given file
-  extension. It is now possible to define profiles based on element
-  factory names or using a path to a `.gep` file containing a
-  serialized profile.
+_Last updated: Tuesday 20 March 2018, 01:30 UTC (log)_
 
 
-- `audioconvert` can now do endianness conversion in-place. All other
-  conversions still require a copy, but e.g. sign conversion and a few others
-  could also be implemented in-place now.
 
 
-- The new, experimental `playbin3` and `urisourcebin` elements got many
-  bugfixes and improvements and should generally be closer to a full
-  replacement of the old elements.
+Introduction
 
 
-- `interleave` now supports > 64 channels.
+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
+framework!
 
 
-### OpenGL integration
+As always, this release is again packed with new features, bug fixes and
+other improvements.
 
 
-- As usual the GStreamer OpenGL integration library has seen numerous
-  fixes and performance improvements all over the place, and is hopefully
-  ready now to become API stable and be moved to gst-plugins-base during the
-  1.14 release cycle.
 
 
-- The GStreamer OpenGL integration layer has also gained support for the
-  Vivante EGL FB windowing system, which improves performance on platforms
-  such as Freescale iMX.6 for those who are stuck with the proprietary driver.
-  The `qmlglsink` element also supports this now if Qt is used with eglfs or
-  wayland backend, and it works in conjunction with [gstreamer-imx][gstreamer-imx]
-  of course.
+Highlights
 
 
-- various `qmlglsrc` improvements
+-   this section will be completed in due course
 
 
-[gstreamer-imx]: https://github.com/Freescale/gstreamer-imx
 
 
-## Tracing framework and debugging improvements
+Major new features and changes
 
 
-- New tracing hooks have been added to track GstMiniObject and GstObject
-  ref/unref operations.
+Noteworthy new API
 
 
-- The memory leaks tracer can optionally use this to retrieve stack traces if
-  enabled with e.g. `GST_TRACERS=leaks(filters="GstEvent,GstMessage",stack-traces-flags=full)`
+-   this section will be filled in in due course
 
 
-- The `GST_DEBUG_FILE` environment variable, which can be used to write the
-  debug log output to a file instead of printing it to stderr, can now contain
-  a name pattern, which is useful for automated testing and continuous
-  integration systems. The following format specifiers are supported:
+New Elements
 
 
-   - `%p`: will be replaced with the PID
-   - `%r`: will be replaced with a random number, which is useful for instance
-     when running two processes with the same PID but in different containers.
+-   this section will be filled in in due course
 
 
-## Tools
+New element features and additions
 
 
-- `gst-inspect-1.0` can now list elements by type with the new `--types`
-   command-line option, e.g. `gst-inspect-1.0 --types=Audio/Encoder` will
-   show a list of audio encoders.
+-   this section will be filled in in due course
 
 
-- `gst-launch-1.0` and `gst_parse_launch()` have gained a new operator (`:`)
-   that allows linking all pads between two elements. This is useful in cases
-   where the exact number of pads or type of pads is not known beforehand, such
-   as in the `uridecodebin : encodebin` scenario, for example. In this case,
-   multiple links will be created if the encodebin has multiple profiles
-   compatible with the output of uridecodebin.
+Plugin and library moves
 
 
-- `gst-device-monitor-1.0` now shows a `gst-launch-1.0` snippet for each
-  device that shows how to make use of it in a `gst-launch-1.0` pipeline string.
+-   this section will be filled in in due course
 
 
-## GStreamer RTSP server
+Plugin removals
 
 
-- The RTSP server now also supports Digest authentication in addition to Basic
-  authentication.
+-   this section will be filled in in due course
 
 
-- The `GstRTSPClient` class has gained a `pre-*-request` signal and virtual
-  method for each client request type, emitted in the beginning of each rtsp
-  request. These signals or virtual methods let the application validate the
-  requests, configure the media/stream in a certain way and also generate error
-  status codes in case of an error or a bad request.
 
 
-## GStreamer VAAPI
+Miscellaneous API additions
 
 
-- GstVaapiDisplay now inherits from GstObject, thus the VA display logging
-  messages are better and tracing the context sharing is more readable.
+-   this section will be filled in in due course
 
 
-- When uploading raw images into a VA surfaces now VADeriveImages are tried
-  fist, improving the upload performance, if it is possible.
+GstPlayer
 
 
-- The decoders and the post-processor now can push dmabuf-based buffers to
-  downstream under certain conditions. For example:
+-   this section will be filled in in due course
 
 
-  `GST_GL_PLATFORM=egl gst-play-1.0 video-sample.mkv --videosink=glimagesink`
 
 
-- Refactored the wrapping of VA surface into gstreamer memory, adding lock
-  when mapping and unmapping, and many other fixes.
+Miscellaneous changes
 
 
-- Now `vaapidecodebin` loads `vaapipostproc` dynamically. It is possible to
-  avoid it usage with the environment variable `GST_VAAPI_DISABLE_VPP=1`.
+-   this section will be filled in in due course
 
 
-- Regarding encoders: they have primary rank again, since they can discover,
-  in run-time, the color formats they can use for upstream raw buffers and
-  caps renegotiation is now possible. Also the encoders push encoding info
-  downstream via tags.
+OpenGL integration
 
 
-- About specific encoders: added constant bit-rate encoding mode for VP8 and
-  H265 encoder handles P010_10LE color format.
+-   this section will be filled in in due course
 
 
-- Regarding decoders, flush operation has been improved, now the internal VA
-  encoder is not recreated at each flush. Also there are several improvements
-  in the handling of H264 and H265 streams.
 
 
-- VAAPI plugins try to create their on GstGL context (when available) if they
-  cannot find it in the pipeline, to figure out what type of VA Display they
-  should create.
+Tracing framework and debugging improvements
 
 
-- Regarding `vaapisink` for X11, if the backend reports that it is unable to
-  render correctly the current color format, an internal VA post-processor, is
-  instantiated (if available) and converts the color format.
+-   this section will be filled in in due course
 
 
-## GStreamer Editing Services and NLE
 
 
-- Enhanced auto transition behaviour
+Tools
 
 
-- Fix some races in `nlecomposition`
+-   this section will be filled in in due course
 
 
-- Allow building with msvc
 
 
-- Added a UNIX manpage for `ges-launch`
+GStreamer RTSP server
 
 
-- API changes:
-  - Added ges_deinit (allowing the leak tracer to work properly)
-  - Added ges_layer_get_clips_in_interval
-  - Finally hide internal symbols that should never have been exposed
+-   this section will be filled in in due course
 
 
-## GStreamer validate
 
 
-- Port `gst-validate-launcher` to python 3
+GStreamer VAAPI
 
 
-- `gst-validate-launcher` now checks if blacklisted bugs have been fixed on
-  bugzilla and errors out if it is the case
+-   this section will be filled in in due course
 
 
-- Allow building with msvc
 
 
-- Add ability for the launcher to run GStreamer unit tests
+GStreamer Editing Services and NLE
 
 
-- Added a way to activate the leaks tracer on our tests and fix leaks
+-   this section will be filled in in due course
 
 
-- Make the http server multithreaded
 
 
-- New testsuite for running various test scenarios on the DASH-IF test vectors
+GStreamer validate
 
 
-## Build and Dependencies
+-   this section will be filled in in due course
 
 
-- Meson build files are now disted in tarballs, for jhbuild and so distro
-  packagers can start using it. Note that the Meson-based build system is not
-  100% feature-equivalent with the autotools-based one yet.
 
 
-- Some plugin filenames have been changed to match the plugin names: for example
-  the file name of the `encoding` plugin in gst-plugins-base containing the
-  `encodebin` element was `libgstencodebin.so` and has been changed to
-  `libgstencodebin.so`. This affects only a handful of plugins across modules.
+GStreamer Python Bindings
 
 
-  **Developers who install GStreamer from source and just do `make install`**
-  **after updating the source code, without doing `make uninstall` first, will**
-  **have to manually remove the old installed plugin files from the installation**
-  **prefix, or they will get 'Cannot register existing type' critical warnings.**
+-   this section will be filled in in due course
 
 
-- Most of the docbook-based documentation (FAQ, Application Development Manual,
-  Plugin Writer's Guide, design documents) has been converted to markdown and
-  moved into a new gst-docs module. The gtk-doc library API references and
-  the plugins documentation are still built as part of the source modules though.
 
 
-- GStreamer core now optionally uses libunwind and libdw to generate backtraces.
-  This is useful for tracer plugins used during debugging and development.
+Build and Dependencies
 
 
-- There is a new `libgstbadallocators-1.0` library in gst-plugins-bad (which
-  may go away again in future releases once the `GstPhysMemoryAllocator`
-  interface API has been validated by more users).
+-   this section will be filled in in due course
 
 
-- `gst-omx` and `gstreamer-vaapi` modules can now also be built using the
-  Meson build system.
 
 
-- The `qtkitvideosrc` element for macOS was removed. The API is deprecated
-  since 10.9 and it wasn't shipped in the binaries since a few releases.
+Platform-specific improvements
 
 
-## Platform-specific improvements
+Android
 
 
-### Android
+-   this section will be filled in in due course
 
 
-- androidmedia: add support for VP9 video decoding/encoding and Opus audio
-  decoding (where supported)
+macOS and iOS
 
 
-### OS/X and iOS
+-   this section will be filled in in due course
 
 
-- `avfvideosrc`, which represents an iPhone camera or, on a Mac, a screencapture
-  session, so far allowed you to select an input device by device index only.
-  New API adds the ability to select the position (front or back facing) and
-  device-type (wide angle, telephoto, etc.). Furthermore, you can now also
-  specify the orientation (portrait, landscape, etc.) of the videostream.
+Windows
 
 
-### Windows
+-   this section will be filled in in due course
 
 
-- `dx9screencapsrc` can now optionally also capture the cursor.
 
 
-## Contributors
+Contributors
 
 
-Aleix Conchillo Flaque, Alejandro G. Castro, Aleksandr Slobodeniuk, Alexandru
-Băluț, Alex Ashley, Andre McCurdy, Andrew, Anton Eliasson, Antonio Ospite,
-Arnaud Vrac, Arun Raghavan, Aurélien Zanelli, Axel Menzel, Benjamin Otte,
-Branko Subasic, Brendan Shanks, Carl Karsten, Carlos Rafael Giani, ChangBok
-Chae, Chris Bass, Christian Schaller, christophecvr, Claudio Saavedra,
-Corentin Noël, Dag Gullberg, Daniel Garbanzo, Daniel Shahaf, David Evans,
-David Schleef, David Warman, Dominique Leuenberger, Dongil Park, Douglas
-Bagnall, Edgard Lima, Edward Hervey, Emeric Grange, Enrico Jorns, Enrique
-Ocaña González, Evan Nemerson, Fabian Orccon, Fabien Dessenne, Fabrice Bellet,
-Florent Thiéry, Florian Zwoch, Francisco Velazquez, Frédéric Dalleau, Garima
-Gaur, Gaurav Gupta, George Kiagiadakis, Georg Lippitsch, Göran Jönsson, Graham
-Leggett, Guillaume Desmottes, Gurkirpal Singh, Haihua Hu, Hanno Boeck, Havard
-Graff, Heekyoung Seo, hoonhee.lee, Hyunjun Ko, Imre Eörs, Iñaki García
-Etxebarria, Jagadish, Jagyum Koo, Jan Alexander Steffens (heftig), Jan
-Schmidt, Jean-Christophe Trotin, Jochen Henneberg, Jonas Holmberg, Joris
-Valette, Josep Torra, Juan Pablo Ugarte, Julien Isorce, Jürgen Sachs, Koop
-Mast, Kseniia Vasilchuk, Lars Wendler, leigh123linux@googlemail.com, Luis de
-Bethencourt, Lyon Wang, Marcin Kolny, Marinus Schraal, Mark Nauwelaerts,
-Mathieu Duponchelle, Matthew Waters, Matt Staples, Michael Dutka, Michael
-Olbrich, Michael Smith, Michael Tretter, Miguel París Díaz, namanyadav12, Neha
-Arora, Nick Kallen, Nicola Murino, Nicolas Dechesne, Nicolas Dufresne, Nicolas
-Huet, Nirbheek Chauhan, Ole André Vadla Ravnås, Olivier Crête, Patricia
-Muscalu, Peter Korsgaard, Peter Seiderer, Petr Kulhavy, Philippe Normand,
-Philippe Renon, Philipp Zabel, Rahul Bedarkar, Reynaldo H. Verdejo Pinochet,
-Ricardo Ribalda Delgado, Rico Tzschichholz, Руслан Ижбулатов, Samuel Maroy,
-Santiago Carot-Nemesio, Scott D Phillips, Sean DuBois, Sebastian Dröge, Sergey
-Borovkov, Seungha Yang, shakin chou, Song Bing, Søren Juul, Sreerenj
-Balachandran, Stefan Kost, Stefan Sauer, Stepan Salenikovich, Stian Selnes,
-Stuart Weaver, suhas2go, Thiago Santos, Thibault Saunier, Thomas Bluemel,
-Thomas Petazzoni, Tim-Philipp Müller, Ting-Wei Lan, Tobias Mueller, Todor
-Tomov, Tomasz Zajac, Ulf Olsson, Ursula Maplehurst, Víctor Manuel Jáquez Leal,
-Victor Toso, Vincent Penquerc'h, Vineeth TM, Vinod Kesti, Vitor Massaru Iha,
-Vivia Nikolaidou, WeiChungChang, William Manley, Wim Taymans, Wojciech
-Przybyl, Wonchul Lee, Xavier Claessens, Yasushi SHOJI
+-   this section will be filled in in due course
 
 ... and many others who have contributed bug reports, translations, sent
 suggestions or helped testing.
 
 
 ... and many others who have contributed bug reports, translations, sent
 suggestions or helped testing.
 
-## Bugs fixed in 1.12
 
 
-More than [635 bugs][bugs-fixed-in-1.12] have been fixed during
-the development of 1.12.
+Bugs fixed in 1.16
+
+-   this section will be filled in in due course
+
+More than XXX bugs have been fixed during the development of 1.16.
 
 This list does not include issues that have been cherry-picked into the
 
 This list does not include issues that have been cherry-picked into the
-stable 1.10 branch and fixed there as well, all fixes that ended up in the
-1.10 branch are also included in 1.12.
+stable 1.16 branch and fixed there as well, all fixes that ended up in
+the 1.16 branch are also included in 1.16.
+
+This list also does not include issues that have been fixed without a
+bug report in bugzilla, so the actual number of fixes is much higher.
 
 
-This list also does not include issues that have been fixed without a bug
-report in bugzilla, so the actual number of fixes is much higher.
 
 
-[bugs-fixed-in-1.12]: https://bugzilla.gnome.org/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&classification=Platform&limit=0&list_id=213265&order=bug_id&product=GStreamer&query_format=advanced&resolution=FIXED&target_milestone=1.10.1&target_milestone=1.10.2&target_milestone=1.10.3&target_milestone=1.10.4&target_milestone=1.11.1&target_milestone=1.11.2&target_milestone=1.11.3&target_milestone=1.11.4&target_milestone=1.11.90&target_milestone=1.11.91&target_milestone=1.12.0
+Stable 1.16 branch
 
 
-## Stable 1.12 branch
+After the 1.16.0 release there will be several 1.16.x bug-fix releases
+which will contain bug fixes which have been deemed suitable for a
+stable branch, but no new features or intrusive changes will be added to
+a bug-fix release usually. The 1.16.x bug-fix releases will be made from
+the git 1.16 branch, which is a stable branch.
 
 
-After the 1.12.0 release there will be several 1.12.x bug-fix releases which
-will contain bug fixes which have been deemed suitable for a stable branch,
-but no new features or intrusive changes will be added to a bug-fix release
-usually. The 1.12.x bug-fix releases will be made from the git 1.12 branch, which
-is a stable branch.
+1.16.0
 
 
-### 1.12.0
+1.16.0 is scheduled to be released around September 2018.
 
 
-1.12.0 was released on 4th May 2017.
 
 
-## Known Issues
+Known Issues
 
 
-- The `webrtcdsp` element is currently not shipped as part of the Windows
-  binary packages due to a [build system issue][bug-770264].
+-   The webrtcdsp element is currently not shipped as part of the
+    Windows binary packages due to a build system issue.
 
 
-[bug-770264]: https://bugzilla.gnome.org/show_bug.cgi?id=770264
 
 
-## Schedule for 1.14
+Schedule for 1.18
 
 
-Our next major feature release will be 1.14, and 1.11 will be the unstable
-development version leading up to the stable 1.12 release. The development
-of 1.13/1.14 will happen in the git master branch.
+Our next major feature release will be 1.16, and 1.15 will be the
+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.14 development cycle is yet to be confirmed, but it is
-expected that feature freeze will be around September 2017
-followed by several 1.13 pre-releases and the new 1.14 stable release
-in October.
+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
+several 1.15 pre-releases and the new 1.16 stable release in September.
 
 
-1.14 will be backwards-compatible to the stable 1.12, 1.10, 1.8, 1.6, 1.4,
-1.2 and 1.0 release series.
+1.16 will be backwards-compatible to the stable 1.14, 1.12, 1.10, 1.8,
+1.6, 1.4, 1.2 and 1.0 release series.
 
 
-- - -
+------------------------------------------------------------------------
 
 
-*These release notes have been prepared by Sebastian Dröge, Tim-Philipp Müller
-and Víctor Manuel Jáquez Leal.*
+_These release notes have been prepared by Tim-Philipp Müller._
 
 
-*License: [CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/)*
+_License: CC BY-SA 4.0_