Release 1.15.2
[platform/upstream/gstreamer.git] / NEWS
1
2
3 GSTREAMER 1.16 RELEASE NOTES
4
5
6 GStreamer 1.16 has not been released yet. It is scheduled for release in
7 January/February 2019.
8
9 1.15.x is the unstable development version that is being developed in
10 the git master branch and which will eventually result in 1.16.
11
12 1.16 will be backwards-compatible to the stable 1.14, 1.12, 1.10, 1.8,
13 1.6, 1.4, 1.2 and 1.0 release series.
14
15 See https://gstreamer.freedesktop.org/releases/1.16/ for the latest
16 version of this document.
17
18 _Last updated: Monday 25 January 2019, 15:00 UTC (log)_
19
20
21 Introduction
22
23 The GStreamer team is proud to announce a new major feature release in
24 the stable 1.x API series of your favourite cross-platform multimedia
25 framework!
26
27 As always, this release is again packed with many new features, bug
28 fixes and other improvements.
29
30
31 Highlights
32
33 -   GStreamer WebRTC stack gained support for data channels for
34     peer-to-peer communication based on SCTP, BUNDLE support, as well as
35     support for multiple TURN servers.
36
37 -   AV1 video codec support for Matroska and QuickTime/MP4 containers
38     and more configuration options and supported input formats for the
39     AOMedia AV1 encoder
40
41 -   Support for Closed Captions and other Ancillary Data in video
42
43 -   Support for planar (non-interleaved) raw audio
44
45 -   GstVideoAggregator, compositor and OpenGL mixer elements are now in
46     -base
47
48 -   New alternate fields interlace mode where each buffer carries a
49     single field
50
51 -   WebM and Matroska ContentEncryption support in the Matroska demuxer
52
53 -   new WebKit WPE-based web browser source element
54
55 -   Video4Linux: HEVC encoding and decoding, JPEG encoding, and improved
56     dmabuf import/export
57
58 -   Hardware-accelerated Nvidia video decoder gained support for VP8/VP9
59     decoding, whilst the encoder gained support for H.265/HEVC encoding.
60
61 -   Many improvements to the Intel Media SDK based hardware-accelerated
62     video decoder and encoder plugin (msdk): dmabuf import/export for
63     zero-copy integration with other components; VP9 decoding; 10-bit
64     HEVC encoding; video post-processing (vpp) support including
65     deinterlacing; and the video decoder now handles dynamic resolution
66     changes.
67
68 -   The ASS/SSA subtitle overlay renderer can now handle multiple
69     subtitles that overlap in time and will show them on screen
70     simultaneously
71
72 -   The Meson build is now feature-complete (*) and it is now the
73     recommended build system on all platforms. The Autotools build is
74     scheduled to be removed in the next cycle.
75
76 -   The GStreamer Rust bindings and Rust plugins module are now
77     officially part of upstream GStreamer.
78
79 -   Many performance improvements
80
81
82 Major new features and changes
83
84 Noteworthy new API
85
86 -   GstAggregator has a new "min-upstream-latency" property that forces
87     a minimum aggregate latency for the input branches of an aggregator.
88     This is useful for dynamic pipelines where branches with a higher
89     latency might be added later after the pipeline is already up and
90     running and where a change in the latency would be disruptive. This
91     only applies to the case where at least one of the input branches is
92     live though, it won’t force the aggregator into live mode in the
93     absence of any live inputs.
94
95 -   GstBaseSink gained a "processing-deadline" property and
96     setter/getter API to configure a processing deadline for live
97     pipelines. The processing deadline is the acceptable amount of time
98     to process the media in a live pipeline before it reaches the sink.
99     This is on top of the systemic latency that is normally reported by
100     the latency query. This defaults to 20ms and should make pipelines
101     such as v4l2src ! xvimagesink not claim that all frames are late in
102     the QoS events. Ideally, this should replace the "max-lateness"
103     property for most applications.
104
105 -   RTCP Extended Reports (XR) parsing according to RFC 3611:
106     Loss/Duplicate RLE, Packet Receipt Times, Receiver Reference Time,
107     Delay since the last Receiver (DLRR), Statistics Summary, and VoIP
108     Metrics reports. This only provides the ability to parse such
109     packets, generation of XR packets is not supported yet and XR
110     packets are not automatically parsed by rtpbin / rtpsession but must
111     be actively handled by the application.
112
113 -   a new mode for interlaced video was added where each buffer carries
114     a single field of interlaced video, with buffer flags indicating
115     whether the field is the top field or bottom field. Top and bottom
116     fields are expected to alternate in this mode. Caps for this
117     interlace mode must also carry a format:Interlaced caps feature to
118     ensure backwards compatibility.
119
120 -   The video library has gained support for three new raw pixel
121     formats:
122
123     -   Y410: packed 4:4:4 YUV, 10 bits per channel
124     -   Y210: packed 4:2:2 YUV, 10 bits per channel
125     -   NV12_10LE40: fully-packed 10-bit variant of NV12_10LE32,
126         i.e. without the padding bits
127
128 -   GstRTPSourceMeta is a new meta that can be used to transport
129     information about the origin of depayloaded or decoded RTP buffers,
130     e.g. when mixing audio from multiple sources into a single stream. A
131     new "source-info" property on the RTP depayloader base class
132     determines whether depayloaders should put this meta on outgoing
133     buffers. Similarly, the same property on RTP payloaders determines
134     whether they should use the information from this meta to construct
135     the CSRCs list on outgoing RTP buffers.
136
137 -   gst_sdp_message_from_text() is a convenience constructor to parse
138     SDPs from a string which is particularly useful for language
139     bindings.
140
141 Support for Planar (Non-Interleaved) Raw Audio
142
143 Raw audio samples are usually passed around in interleaved form in
144 GStreamer, which means that if there are multiple audio channels the
145 samples for each channel are interleaved in memory, e.g.
146 |LEFT|RIGHT|LEFT|RIGHT|LEFT|RIGHT| for stereo audio. A non-interleaved
147 or planar arrangement in memory would look like
148 |LEFT|LEFT|LEFT|RIGHT|RIGHT|RIGHT| instead, possibly with
149 |LEFT|LEFT|LEFT| and |RIGHT|RIGHT|RIGHT| residing in separate memory
150 chunks or separated by some padding.
151
152 GStreamer has always had signalling for non-interleaved audio since
153 version 1.0, but it was never actually properly implemented in any
154 elements. audioconvert would advertise support for it, but wasn’t
155 actually able to handle it correctly.
156
157 With this release we now have full support for non-interleaved audio as
158 well, which means more efficient integration with external APIs that
159 handle audio this way, but also more efficient processing of certain
160 operations like interleaving multiple 1-channel streams into a
161 multi-channel stream which can be done without memory copies now.
162
163 New API to support this has been added to the GStreamer Audio support
164 library: There is now a new GstAudioMeta which describes how data is
165 laid out inside the buffer, and buffers with non-interleaved audio must
166 always carry this meta. To access the non-interleaved audio samples you
167 must map such buffers with gst_audio_buffer_map() which works much like
168 gst_buffer_map() or gst_video_frame_map() in that it will populate a
169 little GstAudioBuffer helper structure passed to it with the number of
170 samples, the number of planes and pointers to the start of each plane in
171 memory. This function can also be used to map interleaved audio buffers
172 in which case there will be only one plane of interleaved samples.
173
174 Of course support for this has also been implemented in the various
175 audio helper and conversion APIs, base classes, and in elements such as
176 audioconvert, audioresample, audiotestsrc, audiorate.
177
178 Support for Closed Captions and Other Ancillary Data in Video
179
180 The video support library has gained support for detecting and
181 extracting Ancillary Data from videos as per the SMPTE S291M
182 specification, including:
183
184 -   a VBI (Vertical Blanking Interval) parser that can detect and
185     extract Ancillary Data from Vertical Blanking Interval lines of
186     component signals. This is currently supported for videos in v210
187     and UYVY format.
188
189 -   a new GstMeta for closed captions: GstVideoCaptionMeta. This
190     supports the two types of closed captions, CEA-608 and CEA-708,
191     along with the four different ways they can be transported (other
192     systems are a superset of those).
193
194 -   a VBI (Vertical Blanking Interval) encoder for writing ancillary
195     data to the Vertical Blanking Interval lines of component signals.
196
197 The new closedcaption plugin in gst-plugins-bad then makes use of all
198 this new infrastructure and provides the following elements:
199
200 -   cccombiner: a closed caption combiner that takes a closed captions
201     stream and another stream and adds the closed captions as
202     GstVideoCaptionMeta to the buffers of the other stream.
203
204 -   ccextractor: a closed caption extractor which will take
205     GstVideoCaptionMeta from input buffers and output them as a separate
206     closed captions stream.
207
208 -   ccconverter: a closed caption converter that can convert between
209     different formats
210
211 -   line21decoder: extract line21 closed captions from SD video streams
212
213 -   cc708overlay: decodes CEA 608/708 captions and overlays them on
214     video
215
216 Additionally, the following elements have also gained Closed Caption
217 support:
218
219 -   qtdemux and qtmux support CEA 608/708 Closed Caption tracks
220
221 -   mpegvideoparse extracts Closed Captions from MPEG-2 video streams
222
223 -   decklinkvideosink can output closed captions and decklinkvideosrc
224     can extract closed captions
225
226 -   playbin and playbin3 learned how to autoplug CEA 608/708 CC overlay
227     elements
228
229 -   the externally maintained ajavideosrc element for AJA capture cards
230     has support for extracting closed captions
231
232 The rsclosedcaption plugin in the Rust plugins collection includes a
233 MacCaption (MCC) file parser and encoder.
234
235 New Elements
236
237 -   overlaycomposition: New element that allows applications to draw
238     GstVideoOverlayCompositions on a stream. The element will emit the
239     "draw" signal for each video buffer, and the application then
240     generates an overlay for that frame (or not). This is much more
241     performant than e.g. cairooverlay for many use cases, e.g. because
242     pixel format conversions can be avoided or the blitting of the
243     overlay can be delegated to downstream elements (such as
244     gloverlaycompositor). It’s particularly useful for cases where only
245     a small section of the video frame should be drawn on.
246
247 -   gloverlaycompositor: New OpenGL-based compositor element that
248     flattens any overlays from GstVideoOverlayCompositionMetas into the
249     video stream. This element is also always part of glimagesink.
250
251 -   glalpha: New element that adds an alpha channel to a video stream.
252     The values of the alpha channel can either be set to a constant or
253     can be dynamically calculated via chroma keying. It is similar to
254     the existing alpha element but based on OpenGL. Calculations are
255     done in floating point so results may not be identical to the output
256     of the existing alpha element.
257
258 -   rtpfunnel funnels together RTP streams into a single session. Use
259     cases include multiplexing and bundle. webrtcbin uses it to
260     implement BUNDLE support.
261
262 -   testsrcbin is a source element that provides an audio and/or video
263     stream and also announces them using the recently-introduced
264     GstStream API. This is useful for testing elements such as playbin3
265     or uridecodebin3 etc.
266
267 -   New closed caption elements: cccombiner, ccextractor, ccconverter,
268     line21decoder and cc708overlay (see above)
269
270 -   wpesrc: new source element acting as a Web Browser based on WebKit
271     WPE
272
273 -   Two new OpenCV-based elements: cameracalibrate and cameraundistort
274     that can communicate to figure out distortion correction parameters
275     for a camera and correct for the distortion.
276
277 -   New sctp plugin based on usrsctp with sctpenc and sctpdec elements.
278     These elements are used inside webrtcbin for implementing data
279     channels.
280
281 New element features and additions
282
283 -   playbin3, playbin and playsink have gained a new "text-offset"
284     property to adjust the positioning of the selected subtitle stream
285     vis-a-vis the audio and video streams. This uses subtitleoverlay’s
286     new "subtitle-ts-offset" property. GstPlayer has gained matching API
287     for this, namely gst_player_get_text_video_offset().
288
289 -   playbin3 buffering improvements: in network playback scenarios there
290     may be multiple inputs to decodebin3, and buffering will be done
291     before decodebin3 using queue2 or downloadbuffer elements inside
292     urisourcebin. Since this is before any parsers or demuxers there may
293     not be any bitrate information available for the various streams, so
294     it was difficult to configure the buffering there smartly within
295     global constraints. This was improved now: The queue2 elements
296     inside urisourcebin will now use the new bitrate query to figure out
297     a bitrate estimate for the stream if no bitrate was provided by
298     upstream, and urisourcebin will use the bitrates of the individual
299     queues to distribute the globally-set "buffer-size" budget in bytes
300     to the various queues. urisourcebin also gained "low-watermark" and
301     "high-watermark" properties which will be proxied to the internal
302     queues, as well as a read-only "statistics" property which allows
303     querying of the minimum/maximum/average byte and time levels of the
304     queues inside the urisourcebin in question.
305
306 -   splitmuxsink has gained a couple of new features:
307
308     -   new "async-finalize" mode: This mode is useful for muxers or
309         outputs that can take a long time to finalize a file. Instead of
310         blocking the whole upstream pipeline while the muxer is doing
311         its stuff, we can unlink it and spawn a new muxer + sink
312         combination to continue running normally. This requires us to
313         receive the muxer and sink (if needed) as factories via the new
314         "muxer-factory" and "sink-factory" properties, optionally
315         accompanied by their respective properties structures (set via
316         the new "muxer-properties" and "sink-properties" properties).
317         There are also new "muxer-added" and "sink-added" signals in
318         case custom code has to be called for them to configure them.
319
320     -   "split-at-running-time" action signal: When called by the user,
321         this action signal ends the current file (and starts a new one)
322         as soon as the given running time is reached. If called multiple
323         times, running times are queued up and processed in the order
324         they were given.
325
326     -   "split-after" action signal to finish outputting the current GOP
327         to the current file and then start a new file as soon as the GOP
328         is finished and a new GOP is opened (unlike the existing
329         "split-now" which immediately finishes the current file and
330         writes the current GOP into the next newly-started file).
331
332     -   "reset-muxer" property: when unset, the muxer is reset using
333         flush events instead of setting its state to NULL and back. This
334         means the muxer can keep state across resets, e.g. mpegtsmux
335         will keep the continuity counter continuous across segments as
336         required by hlssink2.
337
338 -   qtdemux gained PIFF track encryption box support in addition to the
339     already-existing PIFF sample encryption support, and also allows
340     applications to select which encryption system to use via a
341     "drm-preferred-decryption-system-id" context in case there are
342     multiple options.
343
344 -   qtmux: the "start-gap-threshold" property determines now whether an
345     edit list will be created to account for small gaps or offsets at
346     the beginning of a stream in case the start timestamps of tracks
347     don’t line up perfectly. Previously the threshold was hard-coded to
348     1% of the (video) frame duration, now it is 0 by default (so edit
349     list will be created even for small differences), but fully
350     configurable.
351
352 -   rtpjitterbuffer has improved end-of-stream handling
353
354 -   rtpmp4vpay will be prefered over rtpmp4gpay for MPEG-4 video in
355     autoplugging scenarios now
356
357 -   rtspsrc now allows applications to send RTSP SET_PARAMETER and
358     GET_PARAMETER requests using action signals.
359
360 -   rtspsrc has a small (100ms) configurable teardown delay by default
361     to try and make sure an RTSP TEARDOWN request gets sent out when the
362     source element shuts down. This will block the downward PAUSED to
363     READY state change for a short time, but can be disabled where it’s
364     a problem. Some servers only allow a limited number of concurrent
365     clients, so if no proper TEARDOWN is sent new clients may have
366     problems connecting to the server for a while.
367
368 -   souphttpsrc behaves better with low bitrate streams now. Before it
369     would increase the read block size too quickly which could lead to
370     it not reading any data from the socket for a very long time with
371     low bitrate streams that are output live downstream. This could lead
372     to servers kicking off the client.
373
374 -   filesink: do internal buffering to avoid performance regression with
375     small writes since we bypass libc buffering by using writev()
376     instead of fwrite()
377
378 -   identity: add "eos-after" property and fix "error-after" property
379     when the element is reused
380
381 -   input-selector: lets context queries pass through, so that
382     e.g. upstream OpenGL elements can use contexts and displays
383     advertised by downstream elements
384
385 -   queue2: avoid ping-pong between 0% and 100% buffering messages if
386     upstream is pushing buffers larger than one of its limits, plus
387     performance optimisations
388
389 -   opusdec: new "phase-inversion" property to control phase inversion.
390     When enabled, this will slightly increase stereo quality, but
391     produces a stream that when downmixed to mono will suffer audio
392     distortions.
393
394 -   The x265enc HEVC encoder also exposes a "key-int-max" property to
395     configure the maximum allowed GOP size now.
396
397 -   decklinkvideosink has seen stability improvements for long-running
398     pipelines (potential crash due to overflow of leaked clock refcount)
399     and clock-slaving improvements when performing flushing seeks
400     (causing stalls in the output timeline), pausing and/or buffering.
401
402 -   srtpdec, srtpenc: add support for MKIs which allow multiple keys to
403     be used with a single SRTP stream
404
405 -   The srt Secure Reliable Transport plugin has integrated server and
406     client elements srt{client,server}{src,sink} into one (srtsrc and
407     srtsink), since SRT connection mode can be changed by uri
408     parameters.
409
410 -   h264parse and h265parse will handle SEI recovery point messages and
411     mark recovery points as keyframes as well (in addition to IDR
412     frames)
413
414 -   webrtcbin: "add-turn-server" action signal to pass multiple ICE
415     relays (TURN servers).
416
417 -   The removesilence element has received various new features and
418     properties, such as a "threshold" property, detecting silence only
419     after minimum silence time/buffers, a "silent" property to control
420     bus message notifications as well as a "squash" property.
421
422 -   AOMedia AV1 decoder gained support for 10/12bit decoding whilst the
423     AV1 encoder supports more image formats and subsamplings now and
424     acquired support for rate control and profile related configuration.
425
426 -   The Fraunhofer fdkaac plugin can now be built against the 2.0.0
427     version API and has improved multichannel support
428
429 -   kmssink now supports unpadded 24-bit RGB and can configure mode
430     setting from video info, which enables display of multi-planar
431     formats such as I420 or NV12 with modesetting. It has also gained a
432     number of new properties: The "restore-crtc" property does what it
433     says on the tin and is enabled by default. "plane-properties" and
434     "connector-properties" can be used to pass custom properties to the
435     DRM.
436
437 -   waylandsink has a "fullscreen" property now.
438
439 Plugin and library moves
440
441 -   The stereo element was moved from -bad into the existing audiofx
442     plugin in -good. If you get duplicate type registration warnings
443     when upgrading, check that you don’t have a stale stereoplugin lying
444     about somewhere.
445
446 GstVideoAggregator, compositor, and OpenGL mixer elements moved from -bad to -base
447
448 GstVideoAggregator is a new base class for raw video mixers and muxers
449 and is based on GstAggregator. It provides defined-latency mixing of raw
450 video inputs and ensures that the pipeline won’t stall even if one of
451 the input streams stops producing data.
452
453 As part of the move to stabilise the API there were some last-minute API
454 changes and clean-ups, but those should mostly affect internal elements.
455 Most notably, the "ignore-eos" pad property was renamed to
456 "repeat-after-eos" and the conversion code was moved to a
457 GstVideoAggregatorConvertPad subclass to avoid code duplication, make
458 things less awkward for subclasses like the OpenGL-based video mixer,
459 and make the API more consistent with the audio aggregator API.
460
461 It is used by the compositor element, which is a replacement for
462 ‘videomixer’ which did not handle live inputs very well. compositor
463 should behave much better in that respect and generally behave as one
464 would expected in most scenarios.
465
466 The compositor element has gained support for per-pad blending mode
467 operators (SOURCE, OVER, ADD) which determines what operator to use for
468 blending this pad over the previous ones. This can be used to implement
469 crossfading and the available operators can be extended in the future as
470 needed.
471
472 A number of OpenGL-based video mixer elements (glvideomixer, glmixerbin,
473 glvideomixerelement, glstereomix, glmosaic) which are built on top of
474 GstVideoAggregator have also been moved from -bad to -base now. These
475 elements have been merged into the existing OpenGL plugin, so if you get
476 duplicate type registration warnings when upgrading, check that you
477 don’t have a stale openglmixers plugin lying about somewhere.
478
479 Plugin removals
480
481 The following plugins have been removed from gst-plugins-bad:
482
483 -   The experimental daala plugin has been removed, since it’s not so
484     useful now that all effort is focused on AV1 instead, and it had to
485     be enabled explicitly with --enable-experimental anyway.
486
487 -   The spc plugin has been removed. It has been replaced by the gme
488     plugin.
489
490 -   The acmmp3dec and acmenc plugins for Windows have been removed. ACM
491     is an ancient legacy API and there was no point in keeping the
492     plugins around for a licensed MP3 decoder now that the MP3 patents
493     have expired and we have a decoder in -good. We also didn’t ship
494     these in our cerbero-built Windows packages, so it’s unlikely that
495     they’ll be missed.
496
497
498 Miscellaneous API additions
499
500 -   GstBitwriter: new generic bit writer API to complement the existing
501     bit reader
502
503 -   gst_buffer_new_wrapped_bytes() creates a wrap buffer from a GBytes
504
505 -   gst_caps_set_features_simple() sets a caps feature on all the
506     structures of a GstCaps
507
508 -   New GST_QUERY_BITRATE query: This allows determining from downstream
509     what the expected bitrate of a stream may be which is useful in
510     queue2 for setting time based limits when upstream does not provide
511     timing information. tsdemux, qtdemux and matroskademux have basic
512     support for this query on their sink pads.
513
514 -   elements: there is a new “Hardware” class specifier. Elements
515     interacting with hardware devices should specify this classifier in
516     their element factory class metadata. This is useful to advertise as
517     one might need to put such elements into READY state to test if the
518     hardware is present in the system for example.
519
520 -   protection: Add a new definition for unspecified system protection,
521     GST_PROTECTION_UNSPECIFIED_SYSTEM_ID
522
523 -   take functions for various mini objects that didn’t have them yet:
524     gst_query_take(), gst_message_take(), gst_tag_list_take(),
525     gst_buffer_list_take(). Unlike the various _replace() functions
526     _take() does not increase the reference count but takes ownership of
527     the mini object passed.
528
529 -   clear functions for various mini object types and GstObject which
530     unrefs the object or mini object (if non-NULL) and sets the variable
531     pointed to to NULL: gst_clear_structure(), gst_clear_tag_list(),
532     gst_clear_query(), gst_clear_message(), gst_clear_event(),
533     gst_clear_caps(), gst_clear_buffer_list(), gst_clear_buffer(),
534     gst_clear_mini_object(), gst_clear_object()
535
536 -   miniobject: new API gst_mini_object_add_parent() and
537     gst_mini_object_remove_parent() to set parent pointers on mini
538     objects to ensure correct writability: Every container of
539     miniobjects now needs to store itself as parent in the child object,
540     and remove itself again later. A mini object is then only writable
541     if there is at most one parent, that parent is writable itself, and
542     the reference count of the mini object is 1. GstBuffer (for
543     memories), GstBufferList (for buffers), GstSample (for caps, buffer,
544     bufferlist), and GstVideoOverlayComposition were updated
545     accordingly. Without this it was possible to have e.g. a buffer list
546     with a refcount of 2 used in two places at once that both modify the
547     same buffer with refcount 1 at the same time wrongly thinking it is
548     writable even though it’s really not.
549
550 -   poll: add API to watch for POLLPRI and stop treating POLLPRI as a
551     read. This is useful to wait for video4linux events which are
552     signalled via POLLPRI.
553
554 -   sample: new API to update the contents of a GstSample and make it
555     writable: gst_sample_set_buffer(), gst_sample_set_caps(),
556     gst_sample_set_segment(), gst_sample_set_info(), plus
557     gst_sample_is_writable() and gst_sample_make_writable(). This makes
558     it possible to reuse a sample object and avoid unnecessary memory
559     allocations, for example in appsink.
560
561 -   ClockIDs now keep a weak reference to underlying clock to avoid
562     crashes in basesink in corner cases where a clock goes away while
563     the ClockID is still in use, plus some new API
564     (gst_clock_id_get_clock(), gst_clock_id_uses_clock()) to check the
565     clock a ClockID is linked to.
566
567 -   The GstCheck unit test library gained a
568     fail_unless_equals_clocktime() convenience macro as well as some new
569     GstHarness API for for proposing meta APIs from the allocation
570     query: gst_harness_add_propose_allocation_meta(). ASSERT_CRITICAL()
571     checks in unit tests are now skipped if GStreamer was compiled with
572     GST_DISABLE_GLIB_CHECKS.
573
574 -   gst_audio_buffer_truncate() convenience function to truncate a raw
575     audio buffer
576
577
578 Miscellaneous performance and memory optimisations
579
580 As always there have been many performance and memory usage improvements
581 across all components and modules. Some of them (such as dmabuf
582 import/export) have already been mentioned elsewhere so won’t be
583 repeated here.
584
585 The following list is only a small snapshot of some of the more
586 interesting optimisations that haven’t been mentioned in other contexts
587 yet:
588
589 -   The GstVideoEncoder and GstVideoDecoder base classes now release the
590     STREAM_LOCK when pushing out buffers, which means (multi-threaded)
591     encoders and decoders can now receive and continue to process input
592     buffers whilst waiting for downstream elements in the pipeline to
593     process the buffer that was pushed out. This increases throughput
594     and reduces processing latency, also and especially for
595     hardware-accelerated encoder/decoder elements.
596
597 -   GstQueueArray has seen a few API additions
598     (gst_queue_array_peek_nth(), gst_queue_array_set_clear_func(),
599     gst_queue_array_clear()) so that it can be used in other places like
600     GstAdapter instead of a GList, which reduces allocations and
601     improves performance.
602
603 -   appsink now reuses the sample object in pull_sample() if possible
604
605 -   rtpsession only starts the RTCP thread when it’s actually needed now
606
607 -   udpsrc uses a buffer pool now and the GstUdpSrc object structure was
608     optimised for better cache performance
609
610 GstPlayer
611
612 -   API was added to fine-tune the synchronisation offset between
613     subtitles and video
614
615
616 Miscellaneous changes
617
618 -   As a result of moving to newer FFmpeg APIs, encoder and decoder
619     elements exposed by the GStreamer FFmpeg wrapper plugin (gst-libav)
620     may have seen possibly incompatible changes to property names and/or
621     types, and not all properties exposed might be functional. We are
622     still reviewing the new properties and aim to minimise breaking
623     changes at least for the most commonly-used properties, so please
624     report any issues you run into!
625
626 OpenGL integration
627
628 -   The OpenGL mixer elements have been moved from -bad to
629     gst-plugins-base (see above)
630
631 -   The Mesa GBM backend now supports headless mode
632
633 -   gloverlaycompositor: New OpenGL-based compositor element that
634     flattens any overlays from GstVideoOverlayCompositionMetas into the
635     video stream.
636
637 -   glalpha: New element that adds an alpha channel to a video stream.
638     The values of the alpha channel can either be set to a constant or
639     can be dynamically calculated via chroma keying. It is similar to
640     the existing alpha element but based on OpenGL. Calculations are
641     done in floating point so results may not be identical to the output
642     of the existing alpha element.
643
644 -   glupload: Implement direct dmabuf uploader, the idea being that some
645     GPUs (like the Vivante series) can actually perform the YUV->RGB
646     conversion internally, so no custom conversion shaders are needed.
647     To make use of this feature, we need an additional uploader that can
648     import DMABUF FDs and also directly pass the pixel format, relying
649     on the GPU to do the conversion.
650
651
652 Tracing framework and debugging improvements
653
654 -   There is now a GDB PRETTY PRINTER FOR VARIOUS GSTREAMER TYPES: For
655     GstObject pointers the type and name is added, e.g.
656     0x5555557e4110 [GstDecodeBin|decodebin0]. For GstMiniObject pointers
657     the object type is added, e.g. 0x7fffe001fc50 [GstBuffer]. For
658     GstClockTime and GstClockTimeDiff the time is also printed in human
659     readable form, e.g. 150116219955 [+0:02:30.116219955].
660
661 -   GDB EXTENSION WITH TWO CUSTOM GDB COMMANDS gst-dot AND gst-print:
662
663     -   gst-dot creates dot files that a very close to what
664         GST_DEBUG_BIN_TO_DOT_FILE() produces, but object properties and
665         buffer contents such as codec-data in caps are not available.
666
667     -   gst-print produces high-level information about a GStreamer
668         object. This is currently limited to pads for GstElements and
669         events for the pads. The output may look like this:
670
671                     (gdb) gst-print pad.object.parent
672                     GstMatroskaDemux (matroskademux0) {
673                         SinkPad (sink, pull) {
674                         }
675                         SrcPad (video_0, push) {
676                           events:
677                             stream-start:
678                               stream-id: 0463ccb080d00b8689bf569a435c4ff84f9ff753545318ae2328ea0763fd0bec/001:1274058367
679                             caps: video/x-theora
680                               width: 1920
681                               height: 800
682                               pixel-aspect-ratio: 1/1
683                               framerate: 24/1
684                               streamheader: < 0x5555557c7d30 [GstBuffer], 0x5555557c7e40 [GstBuffer], 0x7fffe00141d0 [GstBuffer] >
685                             segment: time
686                               rate: 1
687                             tag: global
688                               container-format: Matroska
689                         }
690                         SrcPad (audio_0, push) {
691                           events:
692                             stream-start:
693                               stream-id: 0463ccb080d00b8689bf569a435c4ff84f9ff753545318ae2328ea0763fd0bec/002:1551204875
694                             caps: audio/mpeg
695                               mpegversion: 4
696                               framed: true
697                               stream-format: raw
698                               codec_data: 0x7fffe0014500 [GstBuffer]
699                               level: 2
700                               base-profile: lc
701                               profile: lc
702                               channels: 2
703                               rate: 44100
704                             segment: time
705                               rate: 1
706                             tag: global
707                               container-format: Matroska
708                             tag: stream
709                               audio-codec: MPEG-4 AAC audio
710                               language-code: en
711                         }
712                     }
713
714 -   gst_structure_to_string() now serialises the actual value of
715     pointers when serialising GstStructures instead of claiming they’re
716     NULL. This makes debug logging in various places less confusing,
717     because it’s clear now that structure fields actually hold valid
718     objects. Such object pointer values will never be deserialised
719     however.
720
721
722 Tools
723
724 -   gst-inspect-1.0 has coloured output now and will automatically use a
725     pager if the output does not fit on a page. This only works in a
726     UNIX environment and if the output is not piped, and on Windows 10
727     build 16257 or newer. If you don’t like the colours you can disable
728     them by setting the GST_INSPECT_NO_COLORS=1 environment variable or
729     passing the --no-color command line option.
730
731
732 GStreamer RTSP server
733
734 -   Improved backlog handling when using TCP interleaved for data
735     transport. Before there was a fixed maximum size for backlog
736     messages, which was prone to deadlocks and made it difficult to
737     control memory usage with the watch backlog. The RTSP server now
738     limits queued TCP data messages to one per stream, moving queuing of
739     the data into the pipeline and leaving the RTSP connection
740     responsive to RTSP messages in both directions, preventing all those
741     problems.
742
743 -   Initial ULP Forward Error Correction support in rtspclientsink and
744     for RECORD mode in the server.
745
746 -   API to explicitly enable retransmission requests (RTX)
747
748 -   Lots of multicast-related fixes
749
750 -   rtsp-auth: Add support for parsing .htdigest files
751
752
753 GStreamer VAAPI
754
755 -   this section will be filled in in due course
756
757
758 GStreamer OMX
759
760 -   Add support of NV16 format to video encoders input.
761
762 -   Video decoders now handle the ALLOCATION query to tell upstream
763     about the number of buffers they require. Video encoders will also
764     use this query to adjust their number of allocated buffers
765     preventing starvation when using dynamic buffer mode.
766
767 -   The OMX_PERFORMANCE debug category has been renamed to OMX_API_TRACE
768     and can now be used to track a widder variety of interactions
769     between OMX and GStreamer.
770
771 -   Video encoders will now detect frame rate only changes and will
772     inform OMX about it rather than doing a full format reset.
773
774 -   Various Zynq UltraScale+ specific improvements:
775     -   Video encoders are now able to import dmabuf from upstream.
776     -   Support for HEVC range extension profiles and more AVC profiles.
777     -   We can now request video encoders to generate an IDR using the
778         force key unit event.
779
780
781 GStreamer Editing Services and NLE
782
783 -   this section will be filled in in due course
784
785
786 GStreamer validate
787
788 -   this section will be filled in in due course
789
790
791 GStreamer Python Bindings
792
793 -   add binding for gst_pad_set_caps()
794
795 -   pygobject dependency requirement was bumped to >= 3.8
796
797 -   new audiotestsrc, audioplot, and mixer plugin examples, and a
798     dynamic pipeline example
799
800
801 GStreamer C# Bindings
802
803 -   bindings for the GstWebRTC library
804
805
806 GStreamer Rust Bindings
807
808 The GStreamer Rust bindings are now officially part of the GStreamer
809 project and are also maintained in the GStreamer GitLab.
810
811 The releases will generally not be synchronized with the releases of
812 other GStreamer parts due to dependencies on other projects.
813
814 Also unlike the other GStreamer libraries, the bindings will not commit
815 to full API stability but instead will follow the approach that is
816 generally taken by Rust projects, e.g.:
817
818 1)  0.12.X will be completely API compatible with all other 0.12.Y
819     versions.
820 2)  0.12.X+1 will contain bugfixes and compatible new feature additions.
821 3)  0.13.0 will _not_ be backwards compatible with 0.12.X but projects
822     will be able to stay at 0.12.X without any problems as long as they
823     don’t need newer features.
824
825 The current stable release is 0.12.2 and the next release series will be
826 0.13, probably around March 2019.
827
828 At this point the bindings cover most of GStreamer core (except for most
829 notably GstAllocator and GstMemory), and most parts of the app, audio,
830 base, check, editing-services, gl, net. pbutils, player, rtsp,
831 rtsp-server, sdp, video and webrtc libraries.
832
833 Also included is support for creating subclasses of the following types
834 and writing GStreamer plugins:
835
836 -   gst::Element
837 -   gst::Bin and gst::Pipeline
838 -   gst::URIHandler and gst::ChildProxy
839 -   gst::Pad, gst::GhostPad
840 -   gst_base::Aggregator and gst_base::AggregatorPad
841 -   gst_base::BaseSrc and gst_base::BaseSink
842 -   gst_base::BaseTransform
843
844 Changes to 0.12.X since 0.12.0
845
846 Fixed
847
848 -   PTP clock constructor actually creates a PTP instead of NTP clock
849
850 Added
851
852 -   Bindings for GStreamer Editing Services
853 -   Bindings for GStreamer Check testing library
854 -   Bindings for the encoding profile API (encodebin)
855
856 -   VideoFrame, VideoInfo, AudioInfo, StructureRef implements Send and
857     Sync now
858 -   VideoFrame has a function to get the raw FFI pointer
859 -   From impls from the Error/Success enums to the combined enums like
860     FlowReturn
861 -   Bin-to-dot file functions were added to the Bin trait
862 -   gst_base::Adapter implements SendUnique now
863 -   More complete bindings for the gst_video::VideoOverlay interface,
864     especially
865     gst_video::is_video_overlay_prepare_window_handle_message()
866
867 Changed
868
869 -   All references were updated from GitHub to freedesktop.org GitLab
870 -   Fix various links in the README.md
871 -   Link to the correct location for the documentation
872 -   Remove GitLab badge as that only works with gitlab.com currently
873
874 Changes in git master for 0.13
875
876 Fixed
877
878 -   gst::tag::Album is the album tag now instead of artist sortname
879
880 Added
881
882 -   Subclassing infrastructure was moved directly into the bindings,
883     making the gst-plugin crate deprecated. This involves many API
884     changes but generally cleans up code and makes it more flexible.
885     Take a look at the gst-plugins-rs crate for various examples.
886
887 -   Bindings for CapsFeatures and Meta
888 -   Bindings for
889     ParentBufferMeta,VideoMetaandVideoOverlayCompositionMeta`
890 -   Bindings for VideoOverlayComposition and VideoOverlayRectangle
891 -   Bindings for VideoTimeCode
892
893 -   UniqueFlowCombiner and UniqueAdapter wrappers that make use of the
894     Rust compile-time mutability checks and expose more API in a safe
895     way, and as a side-effect implement Sync and Send now
896
897 -   More complete bindings for Allocation Query
898 -   pbutils functions for codec descriptions
899 -   TagList::iter() for iterating over all tags while getting a single
900     value per tag. The old ::iter_tag_list() function was renamed to
901     ::iter_generic() and still provides access to each value for a tag
902 -   Bus::iter() and Bus::iter_timed() iterators around the corresponding
903     ::pop\*() functions
904
905 -   serde serialization of Value can also handle Buffer now
906
907 -   Extensive comments to all examples with explanations
908 -   Transmuxing example showing how to use typefind, multiqueue and
909     dynamic pads
910 -   basic-tutorial-12 was ported and added
911
912 Changed
913
914 -   Rust 1.31 is the minimum supported Rust version now
915 -   Update to latest gir code generator and glib bindings
916
917 -   Functions returning e.g. gst::FlowReturn or other “combined” enums
918     were changed to return split enums like
919     Result<gst::FlowSuccess, gst::FlowError> to allow usage of the
920     standard Rust error handling.
921
922 -   MiniObject subclasses are now newtype wrappers around the underlying
923     GstRc<FooRef> wrapper. This does not change the API in any breaking
924     way for the current usages, but allows MiniObjects to also be
925     implemented in other crates and makes sure rustdoc places the
926     documentation in the right places.
927
928 -   BinExt extension trait was renamed to GstBinExt to prevent conflicts
929     with gtk::Bin if both are imported
930
931 -   Buffer::from_slice() can’t possible return None
932
933 -   Various clippy warnings
934
935
936 GStreamer Rust Plugins
937
938 Like the GStreamer Rust bindings, the Rust plugins are now officially
939 part of the GStreamer project and are also maintained in the GStreamer
940 GitLab.
941
942 In the 0.3.x versions this contained infrastructure for writing
943 GStreamer plugins in Rust, and a set of plugins.
944
945 In git master that infrastructure was moved to the GLib and GStreamer
946 bindings directly, together with many other improvements that were made
947 possible by this, so the gst-plugins-rs repository only contains
948 GStreamer elements now.
949
950 Elements included are:
951
952 -   Tutorials plugin: identity, rgb2gray and sinesrc with extensive
953     comments
954
955 -   rsaudioecho, a port of the audiofx element
956
957 -   rsfilesrc, rsfilesink
958
959 -   rsflvdemux, a FLV demuxer. Not feature-equivalent with flvdemux yet
960
961 -   threadshare plugin: ts-appsrc, ts-proxysrc/sink, ts-queue, ts-udpsrc
962     and ts-tcpclientsrc elements that use a fixed number of threads and
963     share them between instances. For more background about these
964     elements see Sebastian’s talk “When adding more threads adds more
965     problems - Thread-sharing between elements in GStreamer” at the
966     GStreamer Conference 2017.
967
968 -   rshttpsrc, a HTTP source around the hyper/reqwest Rust libraries.
969     Not feature-equivalent with souphttpsrc yet.
970
971 -   togglerecord, an element that allows to start/stop recording at any
972     time and keeps all audio/video streams in sync.
973
974 -   mccparse and mccenc, parsers and encoders for the MCC closed caption
975     file format.
976
977 Changes to 0.3.X since 0.3.0
978
979 -   All references were updated from GitHub to freedesktop.org GitLab
980 -   Fix various links in the README.md
981 -   Link to the correct location for the documentation
982
983 Changes in git master for 0.4
984
985 -   togglerecord: Switch to parking_lot crate for mutexes/condition
986     variables for lower overhead
987 -   Merge threadshare plugin here
988 -   New closedcaption plugin with mccparse and mccenc elements
989 -   New identity element for the tutorials plugin
990
991 -   Register plugins statically in tests instead of relying on the
992     plugin loader to find the shared library in a specific place
993
994 -   Update to the latest API changes in the GLib and GStreamer bindings
995 -   Update to the latest versions of all crates
996
997
998 Build and Dependencies
999
1000 -   The MESON BUILD SYSTEM BUILD IS NOW FEATURE-COMPLETE (*) and it is
1001     now the recommended build system on all platforms and also used by
1002     Cerbero to build GStreamer on all platforms. The Autotools build is
1003     scheduled to be removed in the next cycle. Developers who currently
1004     use gst-uninstalled should move to gst-build. The build option
1005     naming has been cleaned up and made consistent and there are now
1006     feature options to enable/disable plugins and various other features
1007     on a case-by-case basis. (*) with the exception of plugin docs which
1008     will be handled differently in future
1009
1010 -   Symbol export in libraries is now controlled via explicit exports
1011     using symbol visibility or export defines where supported, to ensure
1012     consistency across all platforms. This also allows libraries to have
1013     exports that vary based on detected platform features and configure
1014     options as is the case with the GStreamer OpenGL integration library
1015     for example. A few symbols that had been exported by accident in
1016     earlier versions may no longer be exported. These symbols will not
1017     have had declarations in any public header files then though and
1018     would not have been usable.
1019
1020 -   The GStreamer FFmpeg wrapper plugin (gst-libav) now depends on
1021     FFmpeg 4.x and uses the new FFmpeg 4.x API and stopped relying on
1022     ancient API that was removed with the FFmpeg 4.x release. This means
1023     that it is no longer possible to build this module against an older
1024     system-provided FFmpeg 3.x version. Use the internal FFmpeg 4.x copy
1025     instead if you build using autotools, or use gst-libav 1.14.x
1026     instead which targets the FFmpeg 3.x API and _should_ work fine in
1027     combination with a newer GStreamer. It’s difficult for us to support
1028     both old and new FFmpeg APIs at the same time, apologies for any
1029     inconvenience caused.
1030
1031 -   Hardware-accelerated Nvidia video encoder/decoder plugins nvdec and
1032     nvenc can be built against CUDA Toolkit versions 9 and 10.0 now. The
1033     dynlink interface has been dropped since it’s deprecated in 10.0.
1034
1035 -   The (optional) OpenCV requirement has been bumped to >= 3.0.0 and
1036     the plugin can also be built against OpenCV 4.x now.
1037
1038 -   New sctp plugin based on usrsctp (for WebRTC data channels)
1039
1040 Cerbero
1041
1042 Cerbero is a meta build system used to build GStreamer plus dependencies
1043 on platforms where dependencies are not readily available, such as
1044 Windows, Android, iOS and macOS.
1045
1046 Cerbero has seen a number of improvements:
1047
1048 -   Cerbero has been ported to Python 3 and requires Python 3.5 or newer
1049     now
1050
1051 -   Source tarballs are now protected by checksums in the recipes to
1052     guard against download errors and malicious takeover of projects or
1053     websites. In addition, downloads are only allowed via secure
1054     transports now and plain HTTP, FTP and git:// transports are not
1055     allowed anymore.
1056
1057 -   There is now a new fetch-bootstrap command which downloads sources
1058     required for bootstrapping, with an optional --build-tools-only
1059     argument to match the bootstrap --build-tools-only command.
1060
1061 -   The bootstrap, build, package and bundle-source commands gained a
1062     new --offline switch that ensures that only sources from the cache
1063     are used and never downloaded via the network. This is useful in
1064     combination with the fetch and fetch-bootstrap commands that acquire
1065     sources ahead of time before any build steps are executed. This
1066     allows more control over the sources used and when sources are
1067     updated, and is particularly useful for build environments that
1068     don’t have network access.
1069
1070 -   bootstrap --assume-yes will automatically say ‘yes’ to any
1071     interactive prompts during the bootstrap stage, such as those from
1072     apt-get or yum.
1073
1074 -   bootstrap --system-only will only bootstrap the system without build
1075     tools.
1076
1077 -   Manifest support: The build manifest can be used in continuous
1078     integration (CI) systems to fixate the Git revision of certain
1079     projects so that all builds of a pipeline are on the same reference.
1080     This is used in GStreamer’s gitlab CI for example. It can also be
1081     used in order to re-produce a specific build. To set a manifest, you
1082     can set manifest = 'my_manifest.xml' in your configuration file, or
1083     use the --manifest command line option. The command line option will
1084     take precendence over anything specific in the configuration file.
1085
1086 -   The new build-deps command can be used to build only the
1087     dependencies of a recipe, without the recipe itself.
1088
1089 -   new --list-variants command to list available variants
1090
1091 -   variants can now be set on the command line via the -v option as a
1092     comma-separated list. This overrides any variants set in any
1093     configuration files.
1094
1095 -   new qt5, intelmsdk and nvidia variants for enabling Qt5 and hardware
1096     codec support. See the Enabling Optional Features with Variants
1097     section in the Cerbero documentation for more details how to enable
1098     and use these variants.
1099
1100 -   A new -t / --timestamp command line switch makes commands print
1101     timestamps
1102
1103
1104 Platform-specific changes and improvements
1105
1106 Android
1107
1108 -   toolchain: update compiler to clang and NDKr18. NDK r18 removed the
1109     armv5 target and only has Android platforms that target at least
1110     armv7 so the armv5 target is not useful anymore.
1111
1112 -   The way that GIO modules are named has changed due to upstream GLib
1113     natively adding support for loading static GIO modules. This means
1114     that any GStreamer application using gnutls for SSL/TLS on the
1115     Android or iOS platforms (or any other setup using static libraries)
1116     will fail to link looking for the g_io_module_gnutls_load_static()
1117     function. The new function name is now
1118     g_io_gnutls_load(gpointer data). data can be NULL for a static
1119     library. Look at this commit for the necessary change in the
1120     examples.
1121
1122 -   various build issues on Android have been fixed.
1123
1124 macOS and iOS
1125
1126 -   various build issues on iOS have been fixed.
1127
1128 -   the minimum required iOS version is now 9.0. The difference in
1129     adoption between 8.0 and 9.0 is 0.1% and the bump to 9.0 fixes some
1130     build issues.
1131
1132 -   The way that GIO modules are named has changed due to upstream GLib
1133     natively adding support for loading static GIO modules. This means
1134     that any GStreamer application using gnutls for SSL/TLS on the
1135     Android or iOS platforms (or any other setup using static libraries)
1136     will fail to link looking for the g_io_module_gnutls_load_static()
1137     function. The new function name is now
1138     g_io_gnutls_load(gpointer data). data can be NULL for a static
1139     library. Look at this commit for the necessary change in the
1140     examples.
1141
1142 Windows
1143
1144 -   The webrtcdsp element is shipped again as part of the Windows binary
1145     packages, the build system issue has been resolved.
1146
1147 -   ‘Inconsistent DLL linkage’ warnings when building with MSVC have
1148     been fixed
1149
1150 -   Hardware-accelerated Nvidia video encoder/decoder plugins nvdec and
1151     nvenc build on Windows now, also with MSVC and using Meson.
1152
1153 -   The ksvideosrc camera capture plugin supports 16-bit grayscale video
1154     now
1155
1156 -   The wasapisrc audio capture element implements loopback recording
1157     from another output device or sink
1158
1159 -   wasapisink recover from low buffer levels in shared mode and some
1160     exclusive mode fixes
1161
1162 -   dshowsrc now implements the GstDeviceMonitor interface
1163
1164
1165 Contributors
1166
1167 Aleix Conchillo Flaqué, Alessandro Decina, Alexandru Băluț, Alex Ashley,
1168 Alexey Chernov, Alicia Boya García, Amit Pandya, Andoni Morales
1169 Alastruey, Andreas Frisch, Andre McCurdy, Andy Green, Anthony Violo,
1170 Antoine Jacoutot, Antonio Ospite, Arun Raghavan, Aurelien Jarno,
1171 Aurélien Zanelli, ayaka, Bananahemic, Bastian Köcher, Branko Subasic,
1172 Brendan Shanks, Carlos Rafael Giani, Christoph Reiter, Corentin Noël,
1173 Daeseok Youn, Daniel Drake, Daniel Klamt, Dardo D Kleiner, David Ing,
1174 David Svensson Fors, Devarsh Thakkar, Dimitrios Katsaros, Edward Hervey,
1175 Emilio Pozuelo Monfort, Enrique Ocaña González, Ezequiel Garcia, Fabien
1176 Dessenne, Fabrizio Gennari, Florent Thiéry, Francisco Velazquez,
1177 Freyr666, Garima Gaur, Gary Bisson, George Kiagiadakis, Georg Lippitsch,
1178 Georg Ottinger, Geunsik Lim, Göran Jönsson, Guillaume Desmottes, H1Gdev,
1179 Haihao Xiang, Haihua Hu, Harshad Khedkar, Havard Graff, He Junyan,
1180 Hoonhee Lee, Hosang Lee, Hyunjun Ko, Ingo Randolf, Iñigo Huguet, James
1181 Stevenson, Jan Alexander Steffens, Jan Schmidt, Jerome Laheurte, Jimmy
1182 Ohn, Joakim Johansson, Jochen Henneberg, Johan Bjäreholt, John-Mark
1183 Bell, John Nikolaides, Jonathan Karlsson, Jonny Lamb, Jordan Petridis,
1184 Josep Torra, Joshua M. Doe, Jos van Egmond, Juan Navarro, Jun Xie,
1185 Junyan He, Justin Kim, Kai Kang, Kim Tae Soo, Kirill Marinushkin, Kyrylo
1186 Polezhaiev, Lars Petter Endresen, Linus Svensson, Louis-Francis
1187 Ratté-Boulianne, Luis de Bethencourt, Luz Paz, Lyon Wang, Maciej Wolny,
1188 Marc-André Lureau, Marc Leeman, Marcos Kintschner, Marian Mihailescu,
1189 Marinus Schraal, Mark Nauwelaerts, Marouen Ghodhbane, Martin Kelly,
1190 Matej Knopp, Mathieu Duponchelle, Matteo Valdina, Matthew Waters,
1191 Matthias Fend, memeka, Michael Drake, Michael Gruner, Michael Olbrich,
1192 Michael Tretter, Miguel Paris, Mike Wey, Mikhail Fludkov, Naveen
1193 Cherukuri, Nicola Murino, Nicolas Dufresne, Niels De Graef, Nirbheek
1194 Chauhan, Norbert Wesp, Ognyan Tonchev, Olivier Crête, Omar Akkila,
1195 Patricia Muscalu, Patrick Radizi, Patrik Nilsson, Paul Kocialkowski, Per
1196 Forlin, Peter Körner, Peter Seiderer, Petr Kulhavy, Philippe Normand,
1197 Philippe Renon, Philipp Zabel, Pierre Labastie, Roland Jon, Roman
1198 Sivriver, Rosen Penev, Russel Winder, Sam Gigliotti, Sean-Der, Sebastian
1199 Dröge, Seungha Yang, Sjoerd Simons, Snir Sheriber, Song Bing, Soon,
1200 Thean Siew, Sreerenj Balachandran, Stefan Ringel, Stephane Cerveau,
1201 Stian Selnes, Suhas Nayak, Takeshi Sato, Thiago Santos, Thibault
1202 Saunier, Thomas Bluemel, Tianhao Liu, Tim-Philipp Müller, Tomasz
1203 Andrzejak, Tomislav Tustonić, U. Artie Eoff, Ulf Olsson, Varunkumar
1204 Allagadapa, Víctor Guzmán, Víctor Manuel Jáquez Leal, Vincenzo Bono,
1205 Vineeth T M, Vivia Nikolaidou, Wang Fei, wangzq, Whoopie, Wim Taymans,
1206 Wind Yuan, Wonchul Lee, Xabier Rodriguez Calvar, Xavier Claessens,
1207 Haihao Xiang, Yacine Bandou, Yeongjin Jeong, Yuji Kuwabara, Zeeshan Ali,
1208
1209 … and many others who have contributed bug reports, translations, sent
1210 suggestions or helped testing.
1211
1212
1213 Bugs fixed in 1.16
1214
1215 -   this section will be filled in in due course
1216
1217 More than XXX bugs have been fixed during the development of 1.16.
1218
1219 This list does not include issues that have been cherry-picked into the
1220 stable 1.16 branch and fixed there as well, all fixes that ended up in
1221 the 1.16 branch are also included in 1.16.
1222
1223 This list also does not include issues that have been fixed without a
1224 bug report in bugzilla, so the actual number of fixes is much higher.
1225
1226
1227 Stable 1.16 branch
1228
1229 After the 1.16.0 release there will be several 1.16.x bug-fix releases
1230 which will contain bug fixes which have been deemed suitable for a
1231 stable branch, but no new features or intrusive changes will be added to
1232 a bug-fix release usually. The 1.16.x bug-fix releases will be made from
1233 the git 1.16 branch, which is a stable branch.
1234
1235 1.16.0
1236
1237 1.16.0 is scheduled to be released around January/February 2019.
1238
1239
1240 Known Issues
1241
1242 -   possibly breaking/incompatible changes to properties of wrapped
1243     FFmpeg decoders and encoders (see above).
1244
1245 -   The way that GIO modules are named has changed due to upstream GLib
1246     natively adding support for loading static GIO modules. This means
1247     that any GStreamer application using gnutls for SSL/TLS on the
1248     Android or iOS platforms (or any other setup using static libraries)
1249     will fail to link looking for the g_io_module_gnutls_load_static()
1250     function. The new function name is now
1251     g_io_gnutls_load(gpointer data). See Android/iOS sections above for
1252     further details.
1253
1254
1255 Schedule for 1.18
1256
1257 Our next major feature release will be 1.18, and 1.17 will be the
1258 unstable development version leading up to the stable 1.18 release. The
1259 development of 1.17/1.18 will happen in the git master branch.
1260
1261 The plan for the 1.18 development cycle is yet to be confirmed, but it
1262 is expected that feature freeze will be around July 2019 followed by
1263 several 1.17 pre-releases and the new 1.18 stable release in
1264 August/September.
1265
1266 1.18 will be backwards-compatible to the stable 1.16, 1.14, 1.12, 1.10,
1267 1.8, 1.6, 1.4, 1.2 and 1.0 release series.
1268
1269 ------------------------------------------------------------------------
1270
1271 _These release notes have been prepared by Tim-Philipp Müller with_
1272 _contributions from Sebastian Dröge._
1273
1274 _License: CC BY-SA 4.0_