blob: 74fb1eaeb8e6e2bbfa050e7aac1495f4954e77f4 [file] [log] [blame]
Sebastian Drögeda5b0d72017-05-04 15:39:05 +03001# GStreamer 1.12 Release Notes
2
3GStreamer 1.12.0 was originally released on 4th May 2017.
4
5The GStreamer team is proud to announce a new major feature release in the
6stable 1.x API series of your favourite cross-platform multimedia framework!
7
8As always, this release is again packed with new features, bug fixes and other
9improvements.
10
11See [https://gstreamer.freedesktop.org/releases/1.12/][latest] for the latest
12version of this document.
13
14*Last updated: Thursday 4 May 2017, 11:00 UTC [(log)][gitlog]*
15
16[latest]: https://gstreamer.freedesktop.org/releases/1.12/
17[gitlog]: https://cgit.freedesktop.org/gstreamer/www/log/src/htdocs/releases/1.12/release-notes-1.12.md
18
19## Introduction
20
21The GStreamer team is proud to announce a new major feature release in the
22stable 1.x API series of your favourite cross-platform multimedia framework!
23
24As always, this release is again packed with new features, bug fixes and other
25improvements.
26
27## Highlights
28
29- new `msdk` plugin for Intel's Media SDK for hardware-accelerated video
30 encoding and decoding on Intel graphics hardware on Windows or Linux.
31
32- `x264enc` can now use multiple x264 library versions compiled for different
33 bit depths at runtime, to transparently provide support for multiple bit
34 depths.
35
36- `videoscale` and `videoconvert` now support multi-threaded scaling and
37 conversion, which is particularly useful with higher resolution video.
38
39- `h264parse` will now automatically insert AU delimiters if needed when
40 outputting byte-stream format, which improves standard compliance and
41 is needed in particular for HLS playback on iOS/macOS.
42
43- `rtpbin` has acquired bundle support for incoming streams
44
45## Major new features and changes
46
47### Noteworthy new API
48
49- The video library gained support for a number of new video formats:
50
51 - `GBR_12LE`, `GBR_12BE`, `GBRA_12LE`, `GBRA_12BE` (planar 4:4:4 RGB/RGBA, 12 bits per channel)
52 - `GBRA_10LE`, `GBRA_10BE` (planar 4:4:4:4 RGBA, 10 bits per channel)
53 - `GBRA` (planar 4:4:4:4 ARGB, 8 bits per channel)
54 - `I420_12BE`, `I420_12LE` (planar 4:2:0 YUV, 12 bits per channel)
55 - `I422_12BE`,`I422_12LE` (planar 4:2:2 YUV, 12 bits per channel)
56 - `Y444_12BE`, `Y444_12LE` (planar 4:4:4 YUV, 12 bits per channel)
57 - `VYUY` (another packed 4:2:2 YUV format)
58
59- The high-level `GstPlayer` API was extended with functions for taking video
60 snapshots and enabling accurate seeking. It can optionally also use the
61 still-experimental `playbin3` element now.
62
63### New Elements
64
65- msdk: new plugin for Intel's Media SDK for hardware-accelerated video encoding
66 and decoding on Intel graphics hardware on Windows or Linux. This includes
67 an H.264 encoder/decoder (`msdkh264dec`, `msdkh264enc`),
68 an H.265 encoder/decoder (`msdkh265dec`, `msdkh265enc`),
69 an MJPEG encoder/encoder (`msdkmjpegdec`, `msdkmjpegenc`),
70 an MPEG-2 video encoder (`msdkmpeg2enc`) and a VP8 encoder (`msdkvp8enc`).
71
72- `iqa` is a new Image Quality Assessment plugin based on [DSSIM][dssim],
73 similar to the old (unported) videomeasure element.
74
75- The `faceoverlay` element, which allows you to overlay SVG graphics over
76 a detected face in a video stream, has been ported from 0.10.
77
78- our `ffmpeg` wrapper plugin now exposes/maps the ffmpeg Opus audio decoder
79 (`avdec_opus`) as well as the GoPro CineForm HD / CFHD decoder (`avdec_cfhd`),
80 and also a parser/writer for the IVF format (`avdemux_ivf` and `avmux_ivf`).
81
82- `audiobuffersplit` is a new element that splits raw audio buffers into
83 equal-sized buffers
84
85- `audiomixmatrix` is a new element that mixes N:M audio channels according to
86 a configured mix matrix.
87
88- The `timecodewait` element got renamed to `avwait` and can operate in
89 different modes now.
90
91- The `opencv` video processing plugin has gained a new `dewarp` element that
92 dewarps fisheye images.
93
94- `ttml` is a new plugin for parsing and rendering subtitles in Timed Text
95 Markup Language (TTML) format. For the time being these elements will not
96 be autoplugged during media playback however, unless the `GST_TTML_AUTOPLUG=1`
97 environment variable is set. Only the EBU-TT-D profile is supported at this
98 point.
99
100[dssim]: https://github.com/pornel/dssim
101
102### New element features and additions
103
104- `x264enc` can now use multiple x264 library versions compiled for different
105 bit depths at runtime, to transparently provide support for multiple bit
106 depths. A new configure parameter `--with-x264-libraries` has been added to
107 specify additional paths to look for additional x264 libraries to load.
108 Background is that the libx264 library is always compile for one specific
109 bit depth and the `x264enc` element would simply support the depth supported
110 by the underlying library. Now we can support multiple depths.
111
112- `x264enc` also picks up the interlacing mode automatically from the input
113 caps now and passed interlacing/TFF information correctly to the library.
114
115- `videoscale` and `videoconvert` now support multi-threaded scaling and
116 conversion, which is particularly useful with higher resolution video.
117 This has to be enabled explicitly via the `"n-threads"` property.
118
119- `videorate`'s new `"rate"` property lets you set a speed factor
120 on the output stream
121
122- `splitmuxsink`'s buffer collection and scheduling was rewritten to make
123 processing and splitting deterministic; before it was possible for a buffer
124 to end up in a different file chunk in different runs. `splitmuxsink` also
125 gained a new `"format-location-full"` signal that works just like the existing
126 `"format-location"` signal only that it is also passed the primary stream's
127 first buffer as argument, so that it is possible to construct the file name
128 based on metadata such as the buffer timestamp or any GstMeta attached to
129 the buffer. The new `"max-size-timecode"` property allows for timecode-based
130 splitting. `splitmuxsink` will now also automatically start a new file if the
131 input caps change in an incompatible way.
132
133- `fakesink` has a new `"drop-out-of-segment"` property to not drop
134 out-of-segment buffers, which is useful for debugging purposes.
135
136- `identity` gained a `"ts-offset"` property.
137
138- both `fakesink` and `identity` now also print what kind of metas are attached
139 to buffers when printing buffer details via the `"last-message"` property
140 used by `gst-launch-1.0 -v`.
141
142- multiqueue: made `"min-interleave-time"` a configurable property.
143
144- video nerds will be thrilled to know that `videotestsrc`'s snow is now
145 deterministic. `videotestsrc` also gained some new properties to make the
146 ball pattern based on system time, and invert colours each second
147 (`"animation-mode"`, `"motion"`, and `"flip"` properties).
148
149- `oggdemux` reverse playback should work again now. You're welcome.
150
151- `playbin3` and `urisourcebin` now have buffering enabled by default, and
152 buffering message aggregation was fixed.
153
154- `tcpclientsrc` now has a `"timeout"` property
155
156- `appsink` has gained support for buffer lists. For backwards compatibility
157 reasons users need to enable this explicitly with `gst_app_sink_set_buffer_list_support()`,
158 however. Once activated, a pulled `GstSample` can contain either a buffer
159 list or a single buffer.
160
161- `splitmuxsrc` reverse playback was fixed and handling of sparse streams, such
162 as subtitle tracks or metadata tracks, was improved.
163
164- `matroskamux` has acquired support for muxing G722 audio; it also marks all
165 buffers as keyframes now when streaming only audio, so that `tcpserversink`
166 will behave properly with audio-only streams.
167
168- `qtmux` gained support for ProRes 4444 XQ, HEVC/H.265 and CineForm (GoPro) formats,
169 and generally writes more video stream-related metadata into the track headers.
170 It is also allows configuration of the maximum interleave size in bytes and
171 time now. For fragmented mp4 we always write the `tfdt` atom now as required
172 by the DASH spec.
173
174- `qtdemux` supports FLAC, xvid, mp2, S16L and CineForm (GoPro) tracks now, and
175 generally tries harder to extract more video-related information from track
176 headers, such as colorimetry or interlacing details. It also received a
177 couple of fixes for the scenario where upstream operates in TIME format and
178 feeds chunks to qtdemux (e.g. DASH or MSE).
179
180- `audioecho` has two new properties to apply a delay only to certain channels
181 to create a surround effect, rather than an echo on all channels. This is
182 useful when upmixing from stereo, for example. The `"surround-delay"` property
183 enables this, and the `"surround-mask"` property controls which channels
184 are considered surround sound channels in this case.
185
186- `webrtcdsp` gained various new properties for gain control and also exposes
187 voice activity detection now, in which case it will post `"voice-activity"`
188 messages on the bus whenever the voice detection status changes.
189
190- The `decklink` capture elements for Blackmagic Decklink cards have seen a
191 number of improvements:
192
193 - `decklinkvideosrc` will post a warning message on "no signal" and an info
194 message when the signal lock has been (re)acquired. There is also a new
195 read-only `"signal"` property that can be used to query the signal lock
196 status. The `GAP` flag will be set on buffers that are captured without
197 a signal lock. The new `drop-no-signal-frames` will make `decklinkvideosrc`
198 drop all buffers that have been captured without an input signal. The
199 `"skip-first-time"` property will make the source drop the first few
200 buffers, which is handy since some devices will at first output buffers
201 with the wrong resolution before they manage to figure out the right input
202 format and decide on the actual output caps.
203
204 - `decklinkaudiosrc` supports more than just 2 audio channels now.
205
206 - The capture sources no longer use the "hardware" timestamps which turn
207 out to be useless and instead just use the pipeline clock directly.
208
209- `srtpdec` now also has a readonly `"stats"` property, just like `srtpenc`.
210
211- `rtpbin` gained RTP bundle support, as used by e.g. WebRTC. The first
212 rtpsession will have a `rtpssrcdemux` element inside splitting the streams
213 based on their SSRC and potentially dispatch to a different rtpsession.
214 Because retransmission SSRCs need to be merged with the corresponding media
215 stream the `::on-bundled-ssrc` signal is emitted on `rtpbin` so that the
216 application can find out to which session the SSRC belongs.
217
218- `rtprtxqueue` gained two new properties exposing retransmission
219 statistics (`"requests"` and `"fulfilled-requests"`)
220
221- `kmssink` will now use the preferred mode for the monitor and render to the
222 base plane if nothing else has set a mode yet. This can also be done forcibly
223 in any case via the new `"force-modesetting"` property. Furthermore, `kmssink`
224 now allows only the supported connector resolutions as input caps in order to
225 avoid scaling or positioning of the input stream, as `kmssink` can't know
226 whether scaling or positioning would be more appropriate for the use case at
227 hand.
228
229- `waylandsink` can now take DMAbuf buffers as input in the presence
230 of a compatible Wayland compositor. This enables zero-copy transfer
231 from a decoder or source that outputs DMAbuf.
232
233- `udpsrc` can be bound to more than one interface when joining a
234 multicast group, this is done by giving a comma separate list of
235 interfaces such as multicast-iface="eth0,eth1".
236
237### Plugin moves
238
239- `dataurisrc` moved from gst-plugins-bad to core
240
241- The `rawparse` plugin containing the `rawaudioparse` and `rawvideoparse`
242 elements moved from gst-plugins-bad to gst-plugins-base. These elements
243 supersede the old `videoparse` and `audioparse` elements. They work the
244 same, with just some minor API changes. The old legacy elements still
245 exist in gst-plugins-bad, but may be removed at some point in the future.
246
247- `timecodestamper` is an element that attaches time codes to video buffers
248 in form of `GstVideoTimeCodeMeta`s. It had a `"clock-source"` property
249 which has now been removed because it was fairly useless in practice. It
250 gained some new properties however: the `"first-timecode"` property can
251 be used to set the inital timecode; alternatively `"first-timecode-to-now"`
252 can be set, and then the current system time at the time the first buffer
253 arrives is used as base time for the time codes.
254
255
256### Plugin removals
257
258- The `mad` mp1/mp2/mp3 decoder plugin was removed from gst-plugins-ugly,
259 as libmad is GPL licensed, has been unmaintained for a very long time, and
260 there are better alternatives available. Use the `mpg123audiodec` element
261 from the `mpg123` plugin in gst-plugins-ugly instead, or `avdec_mp3` from
262 the `gst-libav` module which wraps the ffmpeg library. We expect that we
263 will be able to move mp3 decoding to gst-plugins-good in the next cycle
264 seeing that most patents around mp3 have expired recently or are about to
265 expire.
266
267- The `mimic` plugin was removed from gst-plugins-bad. It contained a decoder
268 and encoder for a video codec used by MSN messenger many many years ago (in
269 a galaxy far far away). The underlying library is unmaintained and no one
270 really needs to use this codec any more. Recorded videos can still be played
271 back with the MIMIC decoder in gst-libav.
272
273## Miscellaneous API additions
274
275- Request pad name templates passed to `gst_element_request_pad()` may now
276 contain multiple specifiers, such as e.g. `src_%u_%u`.
277
278- [`gst_buffer_iterate_meta_filtered()`][buffer-iterate-meta-filtered] is a
279 variant of `gst_buffer_iterate_meta()` that only returns metas of the
280 requested type and skips all other metas.
281
282- [`gst_pad_task_get_state()`][pad-task-get-state] gets the current state of
283 a task in a thread-safe way.
284
285- [`gst_uri_get_media_fragment_table()`][uri-get-fragment-table] provides the
286 media fragments of an URI as a table of key=value pairs.
287
288- [`gst_print()`][print], [`gst_println()`][println], [`gst_printerr()`][printerr],
289 and [`gst_printerrln()`][printerrln] can be used to print to stdout or stderr.
290 These functions are similar to `g_print()` and `g_printerr()` but they also
291 support all the additional format specifiers provided by the GStreamer
292 logging system, such as e.g. `GST_PTR_FORMAT`.
293
294- a `GstParamSpecArray` has been added, for elements who want to have array
295 type properties, such as the `audiomixmatrix` element for example. There are
296 also two new functions to set and get properties of this type from bindings:
297 - gst_util_set_object_array()
298 - gst_util_get_object_array()
299
300- various helper functions have been added to make it easier to set or get
301 GstStructure fields containing caps-style array or list fields from language
302 bindings (which usually support GValueArray but don't know about the GStreamer
303 specific fundamental types):
304 - [`gst_structure_get_array()`][get-array]
305 - [`gst_structure_set_array()`][set-array]
306 - [`gst_structure_get_list()`][get-list]
307 - [`gst_structure_set_list()`][set-list]
308
309- a new ['dynamic type' registry factory type][dynamic-type] was added to
310 register dynamically loadable GType types. This is useful for automatically
311 loading enum/flags types that are used in caps, such as for example the
312 `GstVideoMultiviewFlagsSet` type used in multiview video caps.
313
314- there is a new [`GstProxyControlBinding`][proxy-control-binding] for use
315 with GstController. This allows proxying the control interface from one
316 property on one GstObject to another property (of the same type) in another
317 GstObject. So e.g. in parent-child relationship, one may need to call
318 `gst_object_sync_values()` on the child and have a binding (set elsewhere)
319 on the parent update the value. This is used in `glvideomixer` and `glsinkbin`
320 for example, where `sync_values()` on the child pad or element will call
321 `sync_values()` on the exposed bin pad or element.
322
323 Note that this doesn't solve GObject property forwarding, that must
324 be taken care of by the implementation manually or using GBinding.
325
326- `gst_base_parse_drain()` has been made public for subclasses to use.
327
328- `gst_base_sink_set_drop_out_of_segment()' can be used by subclasses to
329 prevent GstBaseSink from dropping buffers that fall outside of the segment.
330
331- [`gst_calculate_linear_regression()`][calc-lin-regression] is a new utility
332 function to calculate a linear regression.
333
334- [`gst_debug_get_stack_trace`][get-stack-trace] is an easy way to retrieve a
335 stack trace, which can be useful in tracer plugins.
336
337- allocators: the dmabuf allocator is now sub-classable, and there is a new
338 `GST_CAPS_FEATURE_MEMORY_DMABUF` define.
339
340- video decoder subclasses can use the newly-added function
341 `gst_video_decoder_allocate_output_frame_with_params()` to
342 pass a `GstBufferPoolAcquireParams` to the buffer pool for
343 each buffer allocation.
344
345- the video time code API has gained a dedicated [`GstVideoTimeCodeInterval`][timecode-interval]
346 type plus related API, including functions to add intervals to timecodes.
347
348- There is a new `libgstbadallocators-1.0` library in gst-plugins-bad, which
349 may go away again in future releases once the `GstPhysMemoryAllocator`
350 interface API has been validated by more users and was moved to
351 `libgstallocators-1.0` from gst-plugins-base.
352
353[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
354[buffer-iterate-meta-filtered]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstBuffer.html#gst-buffer-iterate-meta-filtered
355[pad-task-get-state]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#gst-pad-task-get-state
356[uri-get-fragment-table]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstUri.html#gst-uri-get-media-fragment-table
357[print]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-print
358[println]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-println
359[printerr]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-printerr
360[printerrln]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstInfo.html#gst-printerrln
361[get-array]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-get-array
362[set-array]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-set-array
363[get-list]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-get-list
364[set-list]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstStructure.html#gst-structure-set-list
365[dynamic-type]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstDynamicTypeFactory.html
366[proxy-control-binding]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer-libs/html/gstreamer-libs-GstProxyControlBinding.html
367[calc-lin-regression]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstUtils.html#gst-calculate-linear-regression
368[get-stack-trace]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstUtils.html#gst-debug-get-stack-trace
369
370### GstPlayer
371
372New API has been added to:
373
374 - get the number of audio/video/subtitle streams:
375 - `gst_player_media_info_get_number_of_streams()`
376 - `gst_player_media_info_get_number_of_video_streams()`
377 - `gst_player_media_info_get_number_of_audio_streams()`
378 - `gst_player_media_info_get_number_of_subtitle_streams()`
379
380 - enable accurate seeking: `gst_player_config_set_seek_accurate()`
381 and `gst_player_config_get_seek_accurate()`
382
383 - get a snapshot image of the video in RGBx, BGRx, JPEG, PNG or
384 native format: [`gst_player_get_video_snapshot()`][snapshot]
385
386 - selecting use of a specific video sink element
387 ([`gst_player_video_overlay_video_renderer_new_with_sink()`][renderer-with-vsink])
388
389 - If the environment variable `GST_PLAYER_USE_PLAYBIN3` is set, GstPlayer will
390 use the still-experimental `playbin3` element and the `GstStreams` API for
391 playback.
392
393[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
394[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
395
396## Miscellaneous changes
397
398- video caps for interlaced video may contain an optional `"field-order"` field
399 now in the case of `interlaced-mode=interleaved` to signal that the field
400 order is always the same throughout the stream. This is useful to signal to
401 muxers such as mp4mux. The new field is parsed from/to `GstVideoInfo` of course.
402
403- video decoder and video encoder base classes try harder to proxy
404 interlacing, colorimetry and chroma-site related fields in caps properly.
405
406- The buffer stored in the `PROTECTION` events is now left unchanged. This is a
407 change of behaviour since 1.8, especially for the mssdemux element which used to
408 decode the base64 parsed data wrapped in the protection events emitted by the
409 demuxer.
410
411- `PROTECTION` events can now be injected into the pipeline from the application;
412 source elements deriving from GstBaseSrc will forward those downstream now.
413
414- The DASH demuxer is now correctly parsing the MSPR-2.0 ContentProtection nodes
415 and emits Protection events accordingly. Applications relying on those events
416 might need to decode the base64 data stored in the event buffer before using it.
417
418- The registry can now also be disabled by setting the environment variable
419 `GST_REGISTRY_DISABLE=yes`, with similar effect as the `GST_DISABLE_REGISTRY`
420 compile time switch.
421
422- Seeking performance with gstreamer-vaapi based decoders was improved. It would
423 recreate the decoder and surfaces on every seek which can be quite slow.
424
425- more robust handling of input caps changes in videoaggregator-based elements
426 such as `compositor`.
427
428- Lots of adaptive streaming-related fixes across the board (DASH, MSS, HLS). Also:
429
430 - `mssdemux`, the Microsoft Smooth Streaming demuxer, has seen various
431 fixes for live streams, duration reporting and seeking.
432
433 - The DASH manifest parser now extracts MS PlayReady ContentProtection objects
434 from manifests and sends them downstream as `PROTECTION` events. It also
435 supports multiple Period elements in external xml now.
436
437- gst-libav was updated to ffmpeg 3.3 but should still work with any 3.x
438 version.
439
440- GstEncodingProfile has been generally enhanced so it can, for
441 example, be used to get possible profiles for a given file
442 extension. It is now possible to define profiles based on element
443 factory names or using a path to a `.gep` file containing a
444 serialized profile.
445
446- `audioconvert` can now do endianness conversion in-place. All other
447 conversions still require a copy, but e.g. sign conversion and a few others
448 could also be implemented in-place now.
449
450- The new, experimental `playbin3` and `urisourcebin` elements got many
451 bugfixes and improvements and should generally be closer to a full
452 replacement of the old elements.
453
454- `interleave` now supports > 64 channels.
455
456### OpenGL integration
457
458- As usual the GStreamer OpenGL integration library has seen numerous
459 fixes and performance improvements all over the place, and is hopefully
460 ready now to become API stable and be moved to gst-plugins-base during the
461 1.14 release cycle.
462
463- The GStreamer OpenGL integration layer has also gained support for the
464 Vivante EGL FB windowing system, which improves performance on platforms
465 such as Freescale iMX.6 for those who are stuck with the proprietary driver.
466 The `qmlglsink` element also supports this now if Qt is used with eglfs or
467 wayland backend, and it works in conjunction with [gstreamer-imx][gstreamer-imx]
468 of course.
469
470- various `qmlglsrc` improvements
471
472[gstreamer-imx]: https://github.com/Freescale/gstreamer-imx
473
474## Tracing framework and debugging improvements
475
476- New tracing hooks have been added to track GstMiniObject and GstObject
477 ref/unref operations.
478
479- The memory leaks tracer can optionally use this to retrieve stack traces if
480 enabled with e.g. `GST_TRACERS=leaks(filters="GstEvent,GstMessage",stack-traces-flags=full)`
481
482- The `GST_DEBUG_FILE` environment variable, which can be used to write the
483 debug log output to a file instead of printing it to stderr, can now contain
484 a name pattern, which is useful for automated testing and continuous
485 integration systems. The following format specifiers are supported:
486
487 - `%p`: will be replaced with the PID
488 - `%r`: will be replaced with a random number, which is useful for instance
489 when running two processes with the same PID but in different containers.
490
491## Tools
492
493- `gst-inspect-1.0` can now list elements by type with the new `--types`
494 command-line option, e.g. `gst-inspect-1.0 --types=Audio/Encoder` will
495 show a list of audio encoders.
496
497- `gst-launch-1.0` and `gst_parse_launch()` have gained a new operator (`:`)
498 that allows linking all pads between two elements. This is useful in cases
499 where the exact number of pads or type of pads is not known beforehand, such
500 as in the `uridecodebin : encodebin` scenario, for example. In this case,
501 multiple links will be created if the encodebin has multiple profiles
502 compatible with the output of uridecodebin.
503
504- `gst-device-monitor-1.0` now shows a `gst-launch-1.0` snippet for each
505 device that shows how to make use of it in a `gst-launch-1.0` pipeline string.
506
507## GStreamer RTSP server
508
509- The RTSP server now also supports Digest authentication in addition to Basic
510 authentication.
511
512- The `GstRTSPClient` class has gained a `pre-*-request` signal and virtual
513 method for each client request type, emitted in the beginning of each rtsp
514 request. These signals or virtual methods let the application validate the
515 requests, configure the media/stream in a certain way and also generate error
516 status codes in case of an error or a bad request.
517
518## GStreamer VAAPI
519
520- GstVaapiDisplay now inherits from GstObject, thus the VA display logging
521 messages are better and tracing the context sharing is more readable.
522
523- When uploading raw images into a VA surfaces now VADeriveImages are tried
524 fist, improving the upload performance, if it is possible.
525
526- The decoders and the post-processor now can push dmabuf-based buffers to
527 downstream under certain conditions. For example:
528
529 `GST_GL_PLATFORM=egl gst-play-1.0 video-sample.mkv --videosink=glimagesink`
530
531- Refactored the wrapping of VA surface into gstreamer memory, adding lock
532 when mapping and unmapping, and many other fixes.
533
534- Now `vaapidecodebin` loads `vaapipostproc` dynamically. It is possible to
535 avoid it usage with the environment variable `GST_VAAPI_DISABLE_VPP=1`.
536
537- Regarding encoders: they have primary rank again, since they can discover,
538 in run-time, the color formats they can use for upstream raw buffers and
539 caps renegotiation is now possible. Also the encoders push encoding info
540 downstream via tags.
541
542- About specific encoders: added constant bit-rate encoding mode for VP8 and
543 H265 encoder handles P010_10LE color format.
544
545- Regarding decoders, flush operation has been improved, now the internal VA
546 encoder is not recreated at each flush. Also there are several improvements
547 in the handling of H264 and H265 streams.
548
549- VAAPI plugins try to create their on GstGL context (when available) if they
550 cannot find it in the pipeline, to figure out what type of VA Display they
551 should create.
552
553- Regarding `vaapisink` for X11, if the backend reports that it is unable to
554 render correctly the current color format, an internal VA post-processor, is
555 instantiated (if available) and converts the color format.
556
557## GStreamer Editing Services and NLE
558
559- Enhanced auto transition behaviour
560
561- Fix some races in `nlecomposition`
562
563- Allow building with msvc
564
565- Added a UNIX manpage for `ges-launch`
566
567- API changes:
568 - Added ges_deinit (allowing the leak tracer to work properly)
569 - Added ges_layer_get_clips_in_interval
570 - Finally hide internal symbols that should never have been exposed
571
572## GStreamer validate
573
574- Port `gst-validate-launcher` to python 3
575
576- `gst-validate-launcher` now checks if blacklisted bugs have been fixed on
577 bugzilla and errors out if it is the case
578
579- Allow building with msvc
580
581- Add ability for the launcher to run GStreamer unit tests
582
583- Added a way to activate the leaks tracer on our tests and fix leaks
584
585- Make the http server multithreaded
586
587- New testsuite for running various test scenarios on the DASH-IF test vectors
588
589## Build and Dependencies
590
591- Meson build files are now disted in tarballs, for jhbuild and so distro
592 packagers can start using it. Note that the Meson-based build system is not
593 100% feature-equivalent with the autotools-based one yet.
594
595- Some plugin filenames have been changed to match the plugin names: for example
596 the file name of the `encoding` plugin in gst-plugins-base containing the
597 `encodebin` element was `libgstencodebin.so` and has been changed to
598 `libgstencodebin.so`. This affects only a handful of plugins across modules.
599
600 **Developers who install GStreamer from source and just do `make install`**
601 **after updating the source code, without doing `make uninstall` first, will**
602 **have to manually remove the old installed plugin files from the installation**
603 **prefix, or they will get 'Cannot register existing type' critical warnings.**
604
605- Most of the docbook-based documentation (FAQ, Application Development Manual,
606 Plugin Writer's Guide, design documents) has been converted to markdown and
607 moved into a new gst-docs module. The gtk-doc library API references and
608 the plugins documentation are still built as part of the source modules though.
609
610- GStreamer core now optionally uses libunwind and libdw to generate backtraces.
611 This is useful for tracer plugins used during debugging and development.
612
613- There is a new `libgstbadallocators-1.0` library in gst-plugins-bad (which
614 may go away again in future releases once the `GstPhysMemoryAllocator`
615 interface API has been validated by more users).
616
617- `gst-omx` and `gstreamer-vaapi` modules can now also be built using the
618 Meson build system.
619
620- The `qtkitvideosrc` element for macOS was removed. The API is deprecated
621 since 10.9 and it wasn't shipped in the binaries since a few releases.
622
623## Platform-specific improvements
624
625### Android
626
627- androidmedia: add support for VP9 video decoding/encoding and Opus audio
628 decoding (where supported)
629
630### OS/X and iOS
631
632- `avfvideosrc`, which represents an iPhone camera or, on a Mac, a screencapture
633 session, so far allowed you to select an input device by device index only.
634 New API adds the ability to select the position (front or back facing) and
635 device-type (wide angle, telephoto, etc.). Furthermore, you can now also
636 specify the orientation (portrait, landscape, etc.) of the videostream.
637
638### Windows
639
640- `dx9screencapsrc` can now optionally also capture the cursor.
641
642## Contributors
643
644Aleix Conchillo Flaque, Alejandro G. Castro, Aleksandr Slobodeniuk, Alexandru
645Băluț, Alex Ashley, Andre McCurdy, Andrew, Anton Eliasson, Antonio Ospite,
646Arnaud Vrac, Arun Raghavan, Aurélien Zanelli, Axel Menzel, Benjamin Otte,
647Branko Subasic, Brendan Shanks, Carl Karsten, Carlos Rafael Giani, ChangBok
648Chae, Chris Bass, Christian Schaller, christophecvr, Claudio Saavedra,
649Corentin Noël, Dag Gullberg, Daniel Garbanzo, Daniel Shahaf, David Evans,
650David Schleef, David Warman, Dominique Leuenberger, Dongil Park, Douglas
651Bagnall, Edgard Lima, Edward Hervey, Emeric Grange, Enrico Jorns, Enrique
652Ocaña González, Evan Nemerson, Fabian Orccon, Fabien Dessenne, Fabrice Bellet,
653Florent Thiéry, Florian Zwoch, Francisco Velazquez, Frédéric Dalleau, Garima
654Gaur, Gaurav Gupta, George Kiagiadakis, Georg Lippitsch, Göran Jönsson, Graham
655Leggett, Guillaume Desmottes, Gurkirpal Singh, Haihua Hu, Hanno Boeck, Havard
656Graff, Heekyoung Seo, hoonhee.lee, Hyunjun Ko, Imre Eörs, Iñaki García
657Etxebarria, Jagadish, Jagyum Koo, Jan Alexander Steffens (heftig), Jan
658Schmidt, Jean-Christophe Trotin, Jochen Henneberg, Jonas Holmberg, Joris
659Valette, Josep Torra, Juan Pablo Ugarte, Julien Isorce, Jürgen Sachs, Koop
660Mast, Kseniia Vasilchuk, Lars Wendler, leigh123linux@googlemail.com, Luis de
661Bethencourt, Lyon Wang, Marcin Kolny, Marinus Schraal, Mark Nauwelaerts,
662Mathieu Duponchelle, Matthew Waters, Matt Staples, Michael Dutka, Michael
663Olbrich, Michael Smith, Michael Tretter, Miguel París Díaz, namanyadav12, Neha
664Arora, Nick Kallen, Nicola Murino, Nicolas Dechesne, Nicolas Dufresne, Nicolas
665Huet, Nirbheek Chauhan, Ole André Vadla Ravnås, Olivier Crête, Patricia
666Muscalu, Peter Korsgaard, Peter Seiderer, Petr Kulhavy, Philippe Normand,
667Philippe Renon, Philipp Zabel, Rahul Bedarkar, Reynaldo H. Verdejo Pinochet,
668Ricardo Ribalda Delgado, Rico Tzschichholz, Руслан Ижбулатов, Samuel Maroy,
669Santiago Carot-Nemesio, Scott D Phillips, Sean DuBois, Sebastian Dröge, Sergey
670Borovkov, Seungha Yang, shakin chou, Song Bing, Søren Juul, Sreerenj
671Balachandran, Stefan Kost, Stefan Sauer, Stepan Salenikovich, Stian Selnes,
672Stuart Weaver, suhas2go, Thiago Santos, Thibault Saunier, Thomas Bluemel,
673Thomas Petazzoni, Tim-Philipp Müller, Ting-Wei Lan, Tobias Mueller, Todor
674Tomov, Tomasz Zajac, Ulf Olsson, Ursula Maplehurst, Víctor Manuel Jáquez Leal,
675Victor Toso, Vincent Penquerc'h, Vineeth TM, Vinod Kesti, Vitor Massaru Iha,
676Vivia Nikolaidou, WeiChungChang, William Manley, Wim Taymans, Wojciech
677Przybyl, Wonchul Lee, Xavier Claessens, Yasushi SHOJI
678
679... and many others who have contributed bug reports, translations, sent
680suggestions or helped testing.
681
682## Bugs fixed in 1.12
683
684More than [635 bugs][bugs-fixed-in-1.12] have been fixed during
685the development of 1.12.
686
687This list does not include issues that have been cherry-picked into the
688stable 1.10 branch and fixed there as well, all fixes that ended up in the
6891.10 branch are also included in 1.12.
690
691This list also does not include issues that have been fixed without a bug
692report in bugzilla, so the actual number of fixes is much higher.
693
694[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
695
696## Stable 1.12 branch
697
698After the 1.12.0 release there will be several 1.12.x bug-fix releases which
699will contain bug fixes which have been deemed suitable for a stable branch,
700but no new features or intrusive changes will be added to a bug-fix release
701usually. The 1.12.x bug-fix releases will be made from the git 1.12 branch, which
702is a stable branch.
703
704### 1.12.0
705
7061.12.0 was released on 4th May 2017.
707
708## Known Issues
709
710- The `webrtcdsp` element is currently not shipped as part of the Windows
711 binary packages due to a [build system issue][bug-770264].
712
713[bug-770264]: https://bugzilla.gnome.org/show_bug.cgi?id=770264
714
715## Schedule for 1.14
716
717Our next major feature release will be 1.14, and 1.11 will be the unstable
718development version leading up to the stable 1.12 release. The development
719of 1.13/1.14 will happen in the git master branch.
720
721The plan for the 1.14 development cycle is yet to be confirmed, but it is
722expected that feature freeze will be around September 2017
723followed by several 1.13 pre-releases and the new 1.14 stable release
724in October.
725
7261.14 will be backwards-compatible to the stable 1.12, 1.10, 1.8, 1.6, 1.4,
7271.2 and 1.0 release series.
728
729- - -
730
731*These release notes have been prepared by Sebastian Dröge, Tim-Philipp Müller
732and Víctor Manuel Jáquez Leal.*
733
734*License: [CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/)*