+GStreamer 1.20 Release Notes
+GStreamer 1.20 has not been released yet. It is scheduled for release
+around October/November 2021.
-GSTREAMER 1.16 RELEASE NOTES
+1.19.x is the unstable development version that is being developed in
+the git main branch and which will eventually result in 1.20, and 1.19.2
+is the current development release in that series
+It is expected that feature freeze will be in early October 2021,
+followed by one or two 1.19.9x pre-releases and the new 1.20 stable
+release around October/November 2021.
-GStreamer 1.16.0 was originally released on 19 April 2019.
+1.20 will be backwards-compatible to the stable 1.18, 1.16, 1.14, 1.12,
+1.10, 1.8, 1.6,, 1.4, 1.2 and 1.0 release series.
-The latest bug-fix release in the 1.16 series is 1.16.2 and was released
-on 3 December 2019.
-
-See https://gstreamer.freedesktop.org/releases/1.16/ for the latest
+See https://gstreamer.freedesktop.org/releases/1.20/ for the latest
version of this document.
-_Last updated: Tuesday 03 December 2019, 08:00 UTC (log)_
-
+Last updated: Wednesday 22 September 2021, 18:00 UTC (log)
Introduction
As always, this release is again packed with many new features, bug
fixes and other improvements.
-
Highlights
-- GStreamer WebRTC stack gained support for data channels for
- peer-to-peer communication based on SCTP, BUNDLE support, as well as
- support for multiple TURN servers.
-
-- AV1 video codec support for Matroska and QuickTime/MP4 containers
- and more configuration options and supported input formats for the
- AOMedia AV1 encoder
-
-- Support for Closed Captions and other Ancillary Data in video
-
-- Support for planar (non-interleaved) raw audio
-
-- GstVideoAggregator, compositor and OpenGL mixer elements are now in
- -base
-
-- New alternate fields interlace mode where each buffer carries a
- single field
-
-- WebM and Matroska ContentEncryption support in the Matroska demuxer
-
-- new WebKit WPE-based web browser source element
-
-- Video4Linux: HEVC encoding and decoding, JPEG encoding, and improved
- dmabuf import/export
-
-- Hardware-accelerated Nvidia video decoder gained support for VP8/VP9
- decoding, whilst the encoder gained support for H.265/HEVC encoding.
-
-- Many improvements to the Intel Media SDK based hardware-accelerated
- video decoder and encoder plugin (msdk): dmabuf import/export for
- zero-copy integration with other components; VP9 decoding; 10-bit
- HEVC encoding; video post-processing (vpp) support including
- deinterlacing; and the video decoder now handles dynamic resolution
- changes.
-
-- The ASS/SSA subtitle overlay renderer can now handle multiple
- subtitles that overlap in time and will show them on screen
- simultaneously
-
-- The Meson build is now feature-complete (*) and it is now the
- recommended build system on all platforms. The Autotools build is
- scheduled to be removed in the next cycle.
-
-- The GStreamer Rust bindings and Rust plugins module are now
- officially part of upstream GStreamer.
-
-- The GStreamer Editing Services gained a gesdemux element that allows
- directly playing back serialized edit list with playbin or
- (uri)decodebin
-
-- Many performance improvements
-
+- this section will be completed in due course
Major new features and changes
-Noteworthy new API
-
-- GstAggregator has a new "min-upstream-latency" property that forces
- a minimum aggregate latency for the input branches of an aggregator.
- This is useful for dynamic pipelines where branches with a higher
- latency might be added later after the pipeline is already up and
- running and where a change in the latency would be disruptive. This
- only applies to the case where at least one of the input branches is
- live though, it won’t force the aggregator into live mode in the
- absence of any live inputs.
-
-- GstBaseSink gained a "processing-deadline" property and
- setter/getter API to configure a processing deadline for live
- pipelines. The processing deadline is the acceptable amount of time
- to process the media in a live pipeline before it reaches the sink.
- This is on top of the systemic latency that is normally reported by
- the latency query. This defaults to 20ms and should make pipelines
- such as v4l2src ! xvimagesink not claim that all frames are late in
- the QoS events. Ideally, this should replace the "max-lateness"
- property for most applications.
-
-- RTCP Extended Reports (XR) parsing according to RFC 3611:
- Loss/Duplicate RLE, Packet Receipt Times, Receiver Reference Time,
- Delay since the last Receiver (DLRR), Statistics Summary, and VoIP
- Metrics reports. This only provides the ability to parse such
- packets, generation of XR packets is not supported yet and XR
- packets are not automatically parsed by rtpbin / rtpsession but must
- be actively handled by the application.
-
-- a new mode for interlaced video was added where each buffer carries
- a single field of interlaced video, with buffer flags indicating
- whether the field is the top field or bottom field. Top and bottom
- fields are expected to alternate in this mode. Caps for this
- interlace mode must also carry a format:Interlaced caps feature to
- ensure backwards compatibility.
-
-- The video library has gained support for three new raw pixel
- formats:
-
- - Y410: packed 4:4:4 YUV, 10 bits per channel
- - Y210: packed 4:2:2 YUV, 10 bits per channel
- - NV12_10LE40: fully-packed 10-bit variant of NV12_10LE32,
- i.e. without the padding bits
-
-- GstRTPSourceMeta is a new meta that can be used to transport
- information about the origin of depayloaded or decoded RTP buffers,
- e.g. when mixing audio from multiple sources into a single stream. A
- new "source-info" property on the RTP depayloader base class
- determines whether depayloaders should put this meta on outgoing
- buffers. Similarly, the same property on RTP payloaders determines
- whether they should use the information from this meta to construct
- the CSRCs list on outgoing RTP buffers.
-
-- gst_sdp_message_from_text() is a convenience constructor to parse
- SDPs from a string which is particularly useful for language
- bindings.
-
-Support for Planar (Non-Interleaved) Raw Audio
-
-Raw audio samples are usually passed around in interleaved form in
-GStreamer, which means that if there are multiple audio channels the
-samples for each channel are interleaved in memory,
-e.g. |LEFT|RIGHT|LEFT|RIGHT|LEFT|RIGHT| for stereo audio. A
-non-interleaved or planar arrangement in memory would look like
-|LEFT|LEFT|LEFT|RIGHT|RIGHT|RIGHT| instead, possibly with
-|LEFT|LEFT|LEFT| and |RIGHT|RIGHT|RIGHT| residing in separate memory
-chunks or separated by some padding.
-
-GStreamer has always had signalling for non-interleaved audio since
-version 1.0, but it was never actually properly implemented in any
-elements. audioconvert would advertise support for it, but wasn’t
-actually able to handle it correctly.
-
-With this release we now have full support for non-interleaved audio as
-well, which means more efficient integration with external APIs that
-handle audio this way, but also more efficient processing of certain
-operations like interleaving multiple 1-channel streams into a
-multi-channel stream which can be done without memory copies now.
-
-New API to support this has been added to the GStreamer Audio support
-library: There is now a new GstAudioMeta which describes how data is
-laid out inside the buffer, and buffers with non-interleaved audio must
-always carry this meta. To access the non-interleaved audio samples you
-must map such buffers with gst_audio_buffer_map() which works much like
-gst_buffer_map() or gst_video_frame_map() in that it will populate a
-little GstAudioBuffer helper structure passed to it with the number of
-samples, the number of planes and pointers to the start of each plane in
-memory. This function can also be used to map interleaved audio buffers
-in which case there will be only one plane of interleaved samples.
-
-Of course support for this has also been implemented in the various
-audio helper and conversion APIs, base classes, and in elements such as
-audioconvert, audioresample, audiotestsrc, audiorate.
-
-Support for Closed Captions and Other Ancillary Data in Video
-
-The video support library has gained support for detecting and
-extracting Ancillary Data from videos as per the SMPTE S291M
-specification, including:
-
-- a VBI (Vertical Blanking Interval) parser that can detect and
- extract Ancillary Data from Vertical Blanking Interval lines of
- component signals. This is currently supported for videos in v210
- and UYVY format.
-
-- a new GstMeta for closed captions: GstVideoCaptionMeta. This
- supports the two types of closed captions, CEA-608 and CEA-708,
- along with the four different ways they can be transported (other
- systems are a superset of those).
-
-- a VBI (Vertical Blanking Interval) encoder for writing ancillary
- data to the Vertical Blanking Interval lines of component signals.
-
-The new closedcaption plugin in gst-plugins-bad then makes use of all
-this new infrastructure and provides the following elements:
-
-- cccombiner: a closed caption combiner that takes a closed captions
- stream and another stream and adds the closed captions as
- GstVideoCaptionMeta to the buffers of the other stream.
-
-- ccextractor: a closed caption extractor which will take
- GstVideoCaptionMeta from input buffers and output them as a separate
- closed captions stream.
-
-- ccconverter: a closed caption converter that can convert between
- different formats
-
-- line21encoder, line21decoder: inject/extract line21 closed captions
- to/from SD video streams
-
-- cc708overlay: decodes CEA 608/708 captions and overlays them on
- video
-
-Additionally, the following elements have also gained Closed Caption
-support:
-
-- qtdemux and qtmux support CEA 608/708 Closed Caption tracks
-
-- mpegvideoparse, h264parse extracts Closed Captions from MPEG-2/H.264
- video streams
-
-- avviddec, avvidenc, x264enc got support for extracting/injecting
- Closed Captions
-
-- decklinkvideosink can output closed captions and decklinkvideosrc
- can extract closed captions
-
-- playbin and playbin3 learned how to autoplug CEA 608/708 CC overlay
- elements
-
-- the externally maintained ajavideosrc element for AJA capture cards
- has support for extracting closed captions
-
-The rsclosedcaption plugin in the Rust plugins collection includes a
-MacCaption (MCC) file parser and encoder.
-
-New Elements
-
-- overlaycomposition: New element that allows applications to draw
- GstVideoOverlayCompositions on a stream. The element will emit the
- "draw" signal for each video buffer, and the application then
- generates an overlay for that frame (or not). This is much more
- performant than e.g. cairooverlay for many use cases, e.g. because
- pixel format conversions can be avoided or the blitting of the
- overlay can be delegated to downstream elements (such as
- gloverlaycompositor). It’s particularly useful for cases where only
- a small section of the video frame should be drawn on.
-
-- gloverlaycompositor: New OpenGL-based compositor element that
- flattens any overlays from GstVideoOverlayCompositionMetas into the
- video stream. This element is also always part of glimagesink.
-
-- glalpha: New element that adds an alpha channel to a video stream.
- The values of the alpha channel can either be set to a constant or
- can be dynamically calculated via chroma keying. It is similar to
- the existing alpha element but based on OpenGL. Calculations are
- done in floating point so results may not be identical to the output
- of the existing alpha element.
-
-- rtpfunnel funnels together RTP streams into a single session. Use
- cases include multiplexing and bundle. webrtcbin uses it to
- implement BUNDLE support.
-
-- testsrcbin is a source element that provides an audio and/or video
- stream and also announces them using the recently-introduced
- GstStream API. This is useful for testing elements such as playbin3
- or uridecodebin3 etc.
+Noteworthy new features and API
-- New closed caption elements: cccombiner, ccextractor, ccconverter,
- line21encoder, line21decoder and cc708overlay (see above)
+- this section will be filled in in due course
-- wpesrc: new source element acting as a Web Browser based on WebKit
- WPE
+New elements
-- Two new OpenCV-based elements: cameracalibrate and cameraundistort
- that can communicate to figure out distortion correction parameters
- for a camera and correct for the distortion.
-
-- New sctp plugin based on usrsctp with sctpenc and sctpdec elements.
- These elements are used inside webrtcbin for implementing data
- channels.
+- this section will be filled in in due course
New element features and additions
-- playbin3, playbin and playsink have gained a new "text-offset"
- property to adjust the positioning of the selected subtitle stream
- vis-a-vis the audio and video streams. This uses subtitleoverlay’s
- new "subtitle-ts-offset" property. GstPlayer has gained matching API
- for this, namely gst_player_get_text_video_offset().
-
-- playbin3 buffering improvements: in network playback scenarios there
- may be multiple inputs to decodebin3, and buffering will be done
- before decodebin3 using queue2 or downloadbuffer elements inside
- urisourcebin. Since this is before any parsers or demuxers there may
- not be any bitrate information available for the various streams, so
- it was difficult to configure the buffering there smartly within
- global constraints. This was improved now: The queue2 elements
- inside urisourcebin will now use the new bitrate query to figure out
- a bitrate estimate for the stream if no bitrate was provided by
- upstream, and urisourcebin will use the bitrates of the individual
- queues to distribute the globally-set "buffer-size" budget in bytes
- to the various queues. urisourcebin also gained "low-watermark" and
- "high-watermark" properties which will be proxied to the internal
- queues, as well as a read-only "statistics" property which allows
- querying of the minimum/maximum/average byte and time levels of the
- queues inside the urisourcebin in question.
-
-- splitmuxsink has gained a couple of new features:
-
- - new "async-finalize" mode: This mode is useful for muxers or
- outputs that can take a long time to finalize a file. Instead of
- blocking the whole upstream pipeline while the muxer is doing
- its stuff, we can unlink it and spawn a new muxer + sink
- combination to continue running normally. This requires us to
- receive the muxer and sink (if needed) as factories via the new
- "muxer-factory" and "sink-factory" properties, optionally
- accompanied by their respective properties structures (set via
- the new "muxer-properties" and "sink-properties" properties).
- There are also new "muxer-added" and "sink-added" signals in
- case custom code has to be called for them to configure them.
-
- - "split-at-running-time" action signal: When called by the user,
- this action signal ends the current file (and starts a new one)
- as soon as the given running time is reached. If called multiple
- times, running times are queued up and processed in the order
- they were given.
-
- - "split-after" action signal to finish outputting the current GOP
- to the current file and then start a new file as soon as the GOP
- is finished and a new GOP is opened (unlike the existing
- "split-now" which immediately finishes the current file and
- writes the current GOP into the next newly-started file).
-
- - "reset-muxer" property: when unset, the muxer is reset using
- flush events instead of setting its state to NULL and back. This
- means the muxer can keep state across resets, e.g. mpegtsmux
- will keep the continuity counter continuous across segments as
- required by hlssink2.
-
-- qtdemux gained PIFF track encryption box support in addition to the
- already-existing PIFF sample encryption support, and also allows
- applications to select which encryption system to use via a
- "drm-preferred-decryption-system-id" context in case there are
- multiple options.
-
-- qtmux: the "start-gap-threshold" property determines now whether an
- edit list will be created to account for small gaps or offsets at
- the beginning of a stream in case the start timestamps of tracks
- don’t line up perfectly. Previously the threshold was hard-coded to
- 1% of the (video) frame duration, now it is 0 by default (so edit
- list will be created even for small differences), but fully
- configurable.
-
-- rtpjitterbuffer has improved end-of-stream handling
-
-- rtpmp4vpay will be preferred over rtpmp4gpay for MPEG-4 video in
- autoplugging scenarios now
-
-- rtspsrc now allows applications to send RTSP SET_PARAMETER and
- GET_PARAMETER requests using action signals.
-
-- rtspsrc has a small (100ms) configurable teardown delay by default
- to try and make sure an RTSP TEARDOWN request gets sent out when the
- source element shuts down. This will block the downward PAUSED to
- READY state change for a short time, but can be disabled where it’s
- a problem. Some servers only allow a limited number of concurrent
- clients, so if no proper TEARDOWN is sent new clients may have
- problems connecting to the server for a while.
-
-- souphttpsrc behaves better with low bitrate streams now. Before it
- would increase the read block size too quickly which could lead to
- it not reading any data from the socket for a very long time with
- low bitrate streams that are output live downstream. This could lead
- to servers kicking off the client.
-
-- filesink: do internal buffering to avoid performance regression with
- small writes since we bypass libc buffering by using writev()
- instead of fwrite()
-
-- identity: add "eos-after" property and fix "error-after" property
- when the element is reused
-
-- input-selector: lets context queries pass through, so that
- e.g. upstream OpenGL elements can use contexts and displays
- advertised by downstream elements
-
-- queue2: avoid ping-pong between 0% and 100% buffering messages if
- upstream is pushing buffers larger than one of its limits, plus
- performance optimisations
-
-- opusdec: new "phase-inversion" property to control phase inversion.
- When enabled, this will slightly increase stereo quality, but
- produces a stream that when downmixed to mono will suffer audio
- distortions.
-
-- The x265enc HEVC encoder also exposes a "key-int-max" property to
- configure the maximum allowed GOP size now.
-
-- decklinkvideosink has seen stability improvements for long-running
- pipelines (potential crash due to overflow of leaked clock refcount)
- and clock-slaving improvements when performing flushing seeks
- (causing stalls in the output timeline), pausing and/or buffering.
-
-- srtpdec, srtpenc: add support for MKIs which allow multiple keys to
- be used with a single SRTP stream
-
-- srtpdec, srtpenc: add support for AES-GCM and also add support for
- it in gst-rtsp-server and rtspsrc.
-
-- The srt Secure Reliable Transport plugin has integrated server and
- client elements srt{client,server}{src,sink} into one (srtsrc and
- srtsink), since SRT connection mode can be changed by uri
- parameters.
-
-- h264parse and h265parse will handle SEI recovery point messages and
- mark recovery points as keyframes as well (in addition to IDR
- frames)
-
-- webrtcbin: "add-turn-server" action signal to pass multiple ICE
- relays (TURN servers).
-
-- The removesilence element has received various new features and
- properties, such as a "threshold" property, detecting silence only
- after minimum silence time/buffers, a "silent" property to control
- bus message notifications as well as a "squash" property.
-
-- AOMedia AV1 decoder gained support for 10/12bit decoding whilst the
- AV1 encoder supports more image formats and subsamplings now and
- acquired support for rate control and profile related configuration.
-
-- The Fraunhofer fdkaac plugin can now be built against the 2.0.0
- version API and has improved multichannel support
-
-- kmssink now supports unpadded 24-bit RGB and can configure mode
- setting from video info, which enables display of multi-planar
- formats such as I420 or NV12 with modesetting. It has also gained a
- number of new properties: The "restore-crtc" property does what it
- says on the tin and is enabled by default. "plane-properties" and
- "connector-properties" can be used to pass custom properties to the
- DRM.
-
-- waylandsink has a "fullscreen" property now and supports the
- XDG-Shell protocol.
-
-- decklinkvideosink, decklinkvideosrc support selecting between
- half/full duplex
-
-- The vulkan plugin gained support for macOS and iOS via MoltenVK in
- addition to the existing support for X11 and Wayland
-
-- imagefreeze has a new num-buffers property to limit the number of
- buffers that are produced and to send an EOS event afterwards
-
-- webrtcbin has a new, introspectable get-transceiver signal in
- addition to the old get-transceivers signal that couldn’t be used
- from bindings
-
-- Support for per-element latency information was added to the latency
- tracer
+- this section will be filled in in due course
Plugin and library moves
-- The stereo element was moved from -bad into the existing audiofx
- plugin in -good. If you get duplicate type registration warnings
- when upgrading, check that you don’t have a stale stereoplugin lying
- about somewhere.
-
-GstVideoAggregator, compositor, and OpenGL mixer elements moved from -bad to -base
-
-GstVideoAggregator is a new base class for raw video mixers and muxers
-and is based on GstAggregator. It provides defined-latency mixing of raw
-video inputs and ensures that the pipeline won’t stall even if one of
-the input streams stops producing data.
-
-As part of the move to stabilise the API there were some last-minute API
-changes and clean-ups, but those should mostly affect internal elements.
-Most notably, the "ignore-eos" pad property was renamed to
-"repeat-after-eos" and the conversion code was moved to a
-GstVideoAggregatorConvertPad subclass to avoid code duplication, make
-things less awkward for subclasses like the OpenGL-based video mixer,
-and make the API more consistent with the audio aggregator API.
-
-It is used by the compositor element, which is a replacement for
-‘videomixer’ which did not handle live inputs very well. compositor
-should behave much better in that respect and generally behave as one
-would expected in most scenarios.
-
-The compositor element has gained support for per-pad blending mode
-operators (SOURCE, OVER, ADD) which determines what operator to use for
-blending this pad over the previous ones. This can be used to implement
-crossfading and the available operators can be extended in the future as
-needed.
-
-A number of OpenGL-based video mixer elements (glvideomixer, glmixerbin,
-glvideomixerelement, glstereomix, glmosaic) which are built on top of
-GstVideoAggregator have also been moved from -bad to -base now. These
-elements have been merged into the existing OpenGL plugin, so if you get
-duplicate type registration warnings when upgrading, check that you
-don’t have a stale openglmixers plugin lying about somewhere.
+- this section will be filled in in due course
-Plugin removals
+- There were no plugin moves or library moves in this cycle.
-The following plugins have been removed from gst-plugins-bad:
-
-- The experimental daala plugin has been removed, since it’s not so
- useful now that all effort is focused on AV1 instead, and it had to
- be enabled explicitly with --enable-experimental anyway.
-
-- The spc plugin has been removed. It has been replaced by the gme
- plugin.
+Plugin removals
-- The acmmp3dec and acmenc plugins for Windows have been removed. ACM
- is an ancient legacy API and there was no point in keeping the
- plugins around for a licensed MP3 decoder now that the MP3 patents
- have expired and we have a decoder in -good. We also didn’t ship
- these in our cerbero-built Windows packages, so it’s unlikely that
- they’ll be missed.
+The following elements or plugins have been removed:
+- this section will be filled in in due course
Miscellaneous API additions
-- GstBitwriter: new generic bit writer API to complement the existing
- bit reader
-
-- gst_buffer_new_wrapped_bytes() creates a wrap buffer from a GBytes
-
-- gst_caps_set_features_simple() sets a caps feature on all the
- structures of a GstCaps
-
-- New GST_QUERY_BITRATE query: This allows determining from downstream
- what the expected bitrate of a stream may be which is useful in
- queue2 for setting time based limits when upstream does not provide
- timing information. tsdemux, qtdemux and matroskademux have basic
- support for this query on their sink pads.
-
-- elements: there is a new “Hardware” class specifier. Elements
- interacting with hardware devices should specify this classifier in
- their element factory class metadata. This is useful to advertise as
- one might need to put such elements into READY state to test if the
- hardware is present in the system for example.
-
-- protection: Add a new definition for unspecified system protection,
- GST_PROTECTION_UNSPECIFIED_SYSTEM_ID
-
-- take functions for various mini objects that didn’t have them yet:
- gst_query_take(), gst_message_take(), gst_tag_list_take(),
- gst_buffer_list_take(). Unlike the various _replace() functions
- _take() does not increase the reference count but takes ownership of
- the mini object passed.
-
-- clear functions for various mini object types and GstObject which
- unrefs the object or mini object (if non-NULL) and sets the variable
- pointed to to NULL: gst_clear_structure(), gst_clear_tag_list(),
- gst_clear_query(), gst_clear_message(), gst_clear_event(),
- gst_clear_caps(), gst_clear_buffer_list(), gst_clear_buffer(),
- gst_clear_mini_object(), gst_clear_object()
-
-- miniobject: new API gst_mini_object_add_parent() and
- gst_mini_object_remove_parent() to set parent pointers on mini
- objects to ensure correct writability: Every container of
- miniobjects now needs to store itself as parent in the child object,
- and remove itself again later. A mini object is then only writable
- if there is at most one parent, that parent is writable itself, and
- the reference count of the mini object is 1. GstBuffer (for
- memories), GstBufferList (for buffers), GstSample (for caps, buffer,
- bufferlist), and GstVideoOverlayComposition were updated
- accordingly. Without this it was possible to have e.g. a buffer list
- with a refcount of 2 used in two places at once that both modify the
- same buffer with refcount 1 at the same time wrongly thinking it is
- writable even though it’s really not.
-
-- poll: add API to watch for POLLPRI and stop treating POLLPRI as a
- read. This is useful to wait for video4linux events which are
- signalled via POLLPRI.
-
-- sample: new API to update the contents of a GstSample and make it
- writable: gst_sample_set_buffer(), gst_sample_set_caps(),
- gst_sample_set_segment(), gst_sample_set_info(), plus
- gst_sample_is_writable() and gst_sample_make_writable(). This makes
- it possible to reuse a sample object and avoid unnecessary memory
- allocations, for example in appsink.
-
-- ClockIDs now keep a weak reference to underlying clock to avoid
- crashes in basesink in corner cases where a clock goes away while
- the ClockID is still in use, plus some new API
- (gst_clock_id_get_clock(), gst_clock_id_uses_clock()) to check the
- clock a ClockID is linked to.
-
-- The GstCheck unit test library gained a
- fail_unless_equals_clocktime() convenience macro as well as some new
- GstHarness API for for proposing meta APIs from the allocation
- query: gst_harness_add_propose_allocation_meta(). ASSERT_CRITICAL()
- checks in unit tests are now skipped if GStreamer was compiled with
- GST_DISABLE_GLIB_CHECKS.
-
-- gst_audio_buffer_truncate() convenience function to truncate a raw
- audio buffer
-
-- GstDiscoverer has support for caching the results of discovery in
- the default cache directory. This can be enabled with the use-cache
- property and is disabled by default.
-
-- GstMeta that are attached to GstBuffers are now always stored in the
- order in which they were added.
-
-- Additional support for signalling ONVIF specific features were
- added: the SEEK event can store a trickmode-interval now and support
- for the Rate-Control and Frames RTSP headers was added to the RTSP
- library.
-
-
-Miscellaneous performance and memory optimisations
-
-As always there have been many performance and memory usage improvements
-across all components and modules. Some of them (such as dmabuf
-import/export) have already been mentioned elsewhere so won’t be
-repeated here.
-
-The following list is only a small snapshot of some of the more
-interesting optimisations that haven’t been mentioned in other contexts
-yet:
-
-- The GstVideoEncoder and GstVideoDecoder base classes now release the
- STREAM_LOCK when pushing out buffers, which means (multi-threaded)
- encoders and decoders can now receive and continue to process input
- buffers whilst waiting for downstream elements in the pipeline to
- process the buffer that was pushed out. This increases throughput
- and reduces processing latency, also and especially for
- hardware-accelerated encoder/decoder elements.
-
-- GstQueueArray has seen a few API additions
- (gst_queue_array_peek_nth(), gst_queue_array_set_clear_func(),
- gst_queue_array_clear()) so that it can be used in other places like
- GstAdapter instead of a GList, which reduces allocations and
- improves performance.
-
-- appsink now reuses the sample object in pull_sample() if possible
-
-- rtpsession only starts the RTCP thread when it’s actually needed now
-
-- udpsrc uses a buffer pool now and the GstUdpSrc object structure was
- optimised for better cache performance
-
-GstPlayer
-
-- API was added to fine-tune the synchronisation offset between
- subtitles and video
-
-
-Miscellaneous changes
-
-- As a result of moving to newer FFmpeg APIs, encoder and decoder
- elements exposed by the GStreamer FFmpeg wrapper plugin (gst-libav)
- may have seen possibly incompatible changes to property names and/or
- types, and not all properties exposed might be functional. We are
- still reviewing the new properties and aim to minimise breaking
- changes at least for the most commonly-used properties, so please
- report any issues you run into!
-
-OpenGL integration
-
-- The OpenGL mixer elements have been moved from -bad to
- gst-plugins-base (see above)
-
-- The Mesa GBM backend now supports headless mode
-
-- gloverlaycompositor: New OpenGL-based compositor element that
- flattens any overlays from GstVideoOverlayCompositionMetas into the
- video stream.
+- this section will be filled in in due course
-- glalpha: New element that adds an alpha channel to a video stream.
- The values of the alpha channel can either be set to a constant or
- can be dynamically calculated via chroma keying. It is similar to
- the existing alpha element but based on OpenGL. Calculations are
- done in floating point so results may not be identical to the output
- of the existing alpha element.
+Miscellaneous performance, latency and memory optimisations
-- glupload: Implement direct dmabuf uploader, the idea being that some
- GPUs (like the Vivante series) can actually perform the YUV->RGB
- conversion internally, so no custom conversion shaders are needed.
- To make use of this feature, we need an additional uploader that can
- import DMABUF FDs and also directly pass the pixel format, relying
- on the GPU to do the conversion.
+- this section will be filled in in due course
-- The OpenGL library no longer restores the OpenGL viewport. This is a
- performance optimization to not require performing multiple
- expensive glGet*() function calls per frame. This affects any
- application or plugin use of the following functions and objects:
- - glcolorconvert library object (not the element)
- - glviewconvert library object (not the element)
- - gst_gl_framebuffer_draw_to_texture()
- - custom GstGLWindow implementations
+Miscellaneous other changes and enhancements
+- this section will be filled in in due course
Tracing framework and debugging improvements
-- There is now a GDB PRETTY PRINTER FOR VARIOUS GSTREAMER TYPES: For
- GstObject pointers the type and name is added, e.g.
- 0x5555557e4110 [GstDecodeBin|decodebin0]. For GstMiniObject pointers
- the object type is added, e.g. 0x7fffe001fc50 [GstBuffer]. For
- GstClockTime and GstClockTimeDiff the time is also printed in human
- readable form, e.g. 150116219955 [+0:02:30.116219955].
-
-- GDB EXTENSION WITH TWO CUSTOM GDB COMMANDS gst-dot AND gst-print:
-
- - gst-dot creates dot files that a very close to what
- GST_DEBUG_BIN_TO_DOT_FILE() produces, but object properties and
- buffer contents such as codec-data in caps are not available.
-
- - gst-print produces high-level information about a GStreamer
- object. This is currently limited to pads for GstElements and
- events for the pads. The output may look like this:
-
-- gst_structure_to_string() now serialises the actual value of
- pointers when serialising GstStructures instead of claiming they’re
- NULL. This makes debug logging in various places less confusing,
- because it’s clear now that structure fields actually hold valid
- objects. Such object pointer values will never be deserialised
- however.
-
+- this section will be filled in in due course
Tools
-- gst-inspect-1.0 has coloured output now and will automatically use a
- pager if the output does not fit on a page. This only works in a
- UNIX environment and if the output is not piped, and on Windows 10
- build 16257 or newer. If you don’t like the colours you can disable
- them by setting the GST_INSPECT_NO_COLORS=1 environment variable or
- passing the --no-color command line option.
-
+- this section will be filled in in due course
GStreamer RTSP server
-- Improved backlog handling when using TCP interleaved for data
- transport. Before there was a fixed maximum size for backlog
- messages, which was prone to deadlocks and made it difficult to
- control memory usage with the watch backlog. The RTSP server now
- limits queued TCP data messages to one per stream, moving queuing of
- the data into the pipeline and leaving the RTSP connection
- responsive to RTSP messages in both directions, preventing all those
- problems.
-
-- Initial ULP Forward Error Correction support in rtspclientsink and
- for RECORD mode in the server.
-
-- API to explicitly enable retransmission requests (RTX)
-
-- Lots of multicast-related fixes
-
-- rtsp-auth: Add support for parsing .htdigest files
-
+- this section will be filled in in due course
GStreamer VAAPI
-- Support Wayland’s display for context sharing, so the application
- can pass its own wl_display in order to be used for the VAAPI
- display creation.
-
-- A lot of work to support new Intel hardware using media-driver as VA
- backend.
-
-- For non-x86 devices, VAAPI display can instantiate, through DRM,
- with no PCI bus. This enables the usage of libva-v4l2-request
- driver.
-
-- Added support for XDG-shell protocol as wl_shell replacement which
- is currently deprecated. This change add as dependency
- wayland-protocol.
-
-- GstVaapiFilter, GstVaapiWindow, and GstVaapiDecoder classes now
- inherit from GstObject, gaining all the GStreamer’s instrumentation
- support.
-
-- The metadata now specifies the plugin as Hardware class.
-
-- H264 decoder is more stable with problematic streams.
-
-- In H265 decoder added support for profiles main-422-10 (P010_10LE),
- main-444 (AYUV) and main-444-10 (Y410)
-
-- JPEG decoder handles dynamic resolution changes.
-
-- More specification adherence in H264 and H265 encoders.
-
+- this section will be filled in in due course
GStreamer OMX
-- Add support of NV16 format to video encoders input.
-
-- Video decoders now handle the ALLOCATION query to tell upstream
- about the number of buffers they require. Video encoders will also
- use this query to adjust their number of allocated buffers
- preventing starvation when using dynamic buffer mode.
-
-- The OMX_PERFORMANCE debug category has been renamed to OMX_API_TRACE
- and can now be used to track a widder variety of interactions
- between OMX and GStreamer.
-
-- Video encoders will now detect frame rate only changes and will
- inform OMX about it rather than doing a full format reset.
-
-- Various Zynq UltraScale+ specific improvements:
- - Video encoders are now able to import dmabuf from upstream.
- - Support for HEVC range extension profiles and more AVC profiles.
- - We can now request video encoders to generate an IDR using the
- force key unit event.
-
+- this section will be filled in in due course
GStreamer Editing Services and NLE
-- Added a gesdemux element, it is an auto pluggable element that
- allows decoding edit list like files supported by GES
-
-- Added gessrc which wraps a GESTimeline as a standard source element
- (implementing the ges protocol handler)
-
-- Added basic support for videorate::rate property potentially
- allowing changing playback speed
-
-- Layer priority is now fully automatic and they should be moved with
- the new ges_timeline_move_layer method, ges_layer_set_priority is
- now deprecated.
-
-- Added a ges_timeline_element_get_layer_priority so we can simply get
- all information about GESTimelineElement position in the timeline
-
-- GESVideoSource now auto orientates the images if it is defined in a
- meta (overridable).
-
-- Added some PyGObject overrides to make the API more pythonic
-
-- The threading model has been made more explicit with safe guard to
- make sure not thread safe APIs are not used from the wrong threads.
- It is also now possible to properly handle in what thread the API
- should be used.
-
-- Optimized GESClip and GESTrackElement creation
-
-- Added a way to compile out the old, unused and deprecated
- GESPitiviFormatter
-
-- Re implemented the timeline editing API making it faster and making
- the code much more maintainable
-
-- Simplified usage of nlecomposition outside GES by removing quirks in
- it API usage and removing the need to treat it specially from an
- application perspective.
-
-- ges-launch-1.0:
-
- - Added support to add titles to the timeline
- - Enhance the help auto generating it from the code
-
-- Deprecate ges_timeline_load_from_uri as loading the timeline should
- be done through a project now
-
-- MANY leaks have been plugged and the unit testsuite is now “leak
- free”
-
+- this section will be filled in in due course
GStreamer validate
-- Added an action type to verify the checksum of the sink last-sample
-
-- Added an include keyword to validate scenarios
-
-- Added the notion of variable in scenarios, with the set-vars keyword
-
-- Started adding support for “performance” like tests by allowing to
- define the number of dropped buffers or the minimum buffer frequency
- on a specific pad
-
-- Added a validateflow plugin which allows defining the data flow to
- be seen on a particular pad and verifying that following runs match
- the expectations
-
-- Added support for appsrc based test definition so we can instrument
- the data pushed into the pipeline from scenarios
-
-- Added a mockdecryptor allowing adding tests with on encrypted files,
- the element will potentially be instrumented with a validate
- scenario
-
-- gst-validate-launcher:
-
- - Cleaned up output
-
- - Changed the default for “muting” tests as user doesn’t expect
- hundreds of windows to show up when running the testsuite
-
- - Fixed the outputted xunit files to be compatible with GitLab
-
- - Added support to run tests on media files in push mode (using
- pushfile://)
-
- - Added support for running inside gst-build
-
- - Added support for running ssim tests on rendered files
-
- - Added a way to simply define tests on pipelines through a simple
- .json file
-
- - Added a python app to easily run python testsuite reusing all
- the launcher features
-
- - Added flatpak knowledge so we can print backtrace even when
- running from within flatpak
-
- - Added a way to automatically generated “known issues”
- suppressions lines
-
- - Added a way to rerun tests to check if they are flaky and added
- a way to tolerate tests known to be flaky
-
- - Add a way to output html log files
-
+- this section will be filled in in due course
GStreamer Python Bindings
-- add binding for gst_pad_set_caps()
-
-- pygobject dependency requirement was bumped to >= 3.8
-
-- new audiotestsrc, audioplot, and mixer plugin examples, and a
- dynamic pipeline example
-
+- this section will be filled in in due course
GStreamer C# Bindings
-- bindings for the GstWebRTC library
-
-
-GStreamer Rust Bindings
-
-The GStreamer Rust bindings are now officially part of the GStreamer
-project and are also maintained in the GStreamer GitLab.
-
-The releases will generally not be synchronized with the releases of
-other GStreamer parts due to dependencies on other projects.
-
-Also unlike the other GStreamer libraries, the bindings will not commit
-to full API stability but instead will follow the approach that is
-generally taken by Rust projects, e.g.:
-
-1) 0.12.X will be completely API compatible with all other 0.12.Y
- versions.
-2) 0.12.X+1 will contain bugfixes and compatible new feature additions.
-3) 0.13.0 will _not_ be backwards compatible with 0.12.X but projects
- will be able to stay at 0.12.X without any problems as long as they
- don’t need newer features.
-
-The current stable release is 0.12.2 and the next release series will be
-0.13, probably around March 2019.
-
-At this point the bindings cover most of GStreamer core (except for most
-notably GstAllocator and GstMemory), and most parts of the app, audio,
-base, check, editing-services, gl, net. pbutils, player, rtsp,
-rtsp-server, sdp, video and webrtc libraries.
-
-Also included is support for creating subclasses of the following types
-and writing GStreamer plugins:
-
-- gst::Element
-- gst::Bin and gst::Pipeline
-- gst::URIHandler and gst::ChildProxy
-- gst::Pad, gst::GhostPad
-- gst_base::Aggregator and gst_base::AggregatorPad
-- gst_base::BaseSrc and gst_base::BaseSink
-- gst_base::BaseTransform
-
-Changes to 0.12.X since 0.12.0
-
-Fixed
-
-- PTP clock constructor actually creates a PTP instead of NTP clock
-
-Added
-
-- Bindings for GStreamer Editing Services
-- Bindings for GStreamer Check testing library
-- Bindings for the encoding profile API (encodebin)
-
-- VideoFrame, VideoInfo, AudioInfo, StructureRef implements Send and
- Sync now
-- VideoFrame has a function to get the raw FFI pointer
-- From impls from the Error/Success enums to the combined enums like
- FlowReturn
-- Bin-to-dot file functions were added to the Bin trait
-- gst_base::Adapter implements SendUnique now
-- More complete bindings for the gst_video::VideoOverlay interface,
- especially
- gst_video::is_video_overlay_prepare_window_handle_message()
-
-Changed
-
-- All references were updated from GitHub to freedesktop.org GitLab
-- Fix various links in the README.md
-- Link to the correct location for the documentation
-- Remove GitLab badge as that only works with gitlab.com currently
-
-Changes in git master for 0.13
-
-Fixed
-
-- gst::tag::Album is the album tag now instead of artist sortname
-
-Added
-
-- Subclassing infrastructure was moved directly into the bindings,
- making the gst-plugin crate deprecated. This involves many API
- changes but generally cleans up code and makes it more flexible.
- Take a look at the gst-plugins-rs crate for various examples.
-
-- Bindings for CapsFeatures and Meta
-- Bindings for
- ParentBufferMeta,VideoMetaandVideoOverlayCompositionMeta`
-- Bindings for VideoOverlayComposition and VideoOverlayRectangle
-- Bindings for VideoTimeCode
-
-- UniqueFlowCombiner and UniqueAdapter wrappers that make use of the
- Rust compile-time mutability checks and expose more API in a safe
- way, and as a side-effect implement Sync and Send now
-
-- More complete bindings for Allocation Query
-- pbutils functions for codec descriptions
-- TagList::iter() for iterating over all tags while getting a single
- value per tag. The old ::iter_tag_list() function was renamed to
- ::iter_generic() and still provides access to each value for a tag
-- Bus::iter() and Bus::iter_timed() iterators around the corresponding
- ::pop\*() functions
-
-- serde serialization of Value can also handle Buffer now
-
-- Extensive comments to all examples with explanations
-- Transmuxing example showing how to use typefind, multiqueue and
- dynamic pads
-- basic-tutorial-12 was ported and added
-
-Changed
-
-- Rust 1.31 is the minimum supported Rust version now
-- Update to latest gir code generator and glib bindings
-
-- Functions returning e.g. gst::FlowReturn or other “combined” enums
- were changed to return split enums like
- Result<gst::FlowSuccess, gst::FlowError> to allow usage of the
- standard Rust error handling.
-
-- MiniObject subclasses are now newtype wrappers around the underlying
- GstRc<FooRef> wrapper. This does not change the API in any breaking
- way for the current usages, but allows MiniObjects to also be
- implemented in other crates and makes sure rustdoc places the
- documentation in the right places.
-
-- BinExt extension trait was renamed to GstBinExt to prevent conflicts
- with gtk::Bin if both are imported
-
-- Buffer::from_slice() can’t possible return None
-
-- Various clippy warnings
-
-
-GStreamer Rust Plugins
-
-Like the GStreamer Rust bindings, the Rust plugins are now officially
-part of the GStreamer project and are also maintained in the GStreamer
-GitLab.
-
-In the 0.3.x versions this contained infrastructure for writing
-GStreamer plugins in Rust, and a set of plugins.
-
-In git master that infrastructure was moved to the GLib and GStreamer
-bindings directly, together with many other improvements that were made
-possible by this, so the gst-plugins-rs repository only contains
-GStreamer elements now.
-
-Elements included are:
-
-- Tutorials plugin: identity, rgb2gray and sinesrc with extensive
- comments
-
-- rsaudioecho, a port of the audiofx element
-
-- rsfilesrc, rsfilesink
-
-- rsflvdemux, a FLV demuxer. Not feature-equivalent with flvdemux yet
-
-- threadshare plugin: ts-appsrc, ts-proxysrc/sink, ts-queue, ts-udpsrc
- and ts-tcpclientsrc elements that use a fixed number of threads and
- share them between instances. For more background about these
- elements see Sebastian’s talk “When adding more threads adds more
- problems - Thread-sharing between elements in GStreamer” at the
- GStreamer Conference 2017.
-
-- rshttpsrc, a HTTP source around the hyper/reqwest Rust libraries.
- Not feature-equivalent with souphttpsrc yet.
-
-- togglerecord, an element that allows to start/stop recording at any
- time and keeps all audio/video streams in sync.
-
-- mccparse and mccenc, parsers and encoders for the MCC closed caption
- file format.
+- this section will be filled in in due course
+
+GStreamer Rust Bindings and Rust Plugins
+
+The GStreamer Rust bindings are released separately with a different
+release cadence that’s tied to gtk-rs, but the latest release has
+already been updated for the upcoming new GStreamer 1.20 API.
+
+gst-plugins-rs, the module containing GStreamer plugins written in Rust,
+has also seen lots of activity with many new elements and plugins.
+
+What follows is a list of elements and plugins available in
+gst-plugins-rs, so people don’t miss out on all those potentially useful
+elements that have no C equivalent.
+
+- FIXME: add new elements
+
+Rust audio plugins
+
+- audiornnoise: New element for audio denoising which implements the
+ noise removal algorithm of the Xiph RNNoise library, in Rust
+- rsaudioecho: Port of the audioecho element from gst-plugins-good
+ rsaudioloudnorm: Live audio loudness normalization element based on
+ the FFmpeg af_loudnorm filter
+- claxondec: FLAC lossless audio codec decoder element based on the
+ pure-Rust claxon implementation
+- csoundfilter: Audio filter that can use any filter defined via the
+ Csound audio programming language
+- lewtondec: Vorbis audio decoder element based on the pure-Rust
+ lewton implementation
+
+Rust video plugins
+
+- cdgdec/cdgparse: Decoder and parser for the CD+G video codec based
+ on a pure-Rust CD+G implementation, used for example by karaoke CDs
+- cea608overlay: CEA-608 Closed Captions overlay element
+- cea608tott: CEA-608 Closed Captions to timed-text (e.g. VTT or SRT
+ subtitles) converter
+- tttocea608: CEA-608 Closed Captions from timed-text converter
+- mccenc/mccparse: MacCaption Closed Caption format encoder and parser
+- sccenc/sccparse: Scenarist Closed Caption format encoder and parser
+- dav1dec: AV1 video decoder based on the dav1d decoder implementation
+ by the VLC project
+- rav1enc: AV1 video encoder based on the fast and pure-Rust rav1e
+ encoder implementation
+- rsflvdemux: Alternative to the flvdemux FLV demuxer element from
+ gst-plugins-good, not feature-equivalent yet
+- rsgifenc/rspngenc: GIF/PNG encoder elements based on the pure-Rust
+ implementations by the image-rs project
+
+Rust text plugins
+
+- textwrap: Element for line-wrapping timed text (e.g. subtitles) for
+ better screen-fitting, including hyphenation support for some
+ languages
+
+Rust network plugins
+
+- reqwesthttpsrc: HTTP(S) source element based on the Rust
+ reqwest/hyper HTTP implementations and almost feature-equivalent
+ with the main GStreamer HTTP source souphttpsrc
+- s3src/s3sink: Source/sink element for the Amazon S3 cloud storage
+- awstranscriber: Live audio to timed text transcription element using
+ the Amazon AWS Transcribe API
+
+Generic Rust plugins
+
+- sodiumencrypter/sodiumdecrypter: Encryption/decryption element based
+ on libsodium/NaCl
+- togglerecord: Recording element that allows to pause/resume
+ recordings easily and considers keyframe boundaries
+- fallbackswitch/fallbacksrc: Elements for handling potentially
+ failing (network) sources, restarting them on errors/timeout and
+ showing a fallback stream instead
+- threadshare: Set of elements that provide alternatives for various
+ existing GStreamer elements but allow to share the streaming threads
+ between each other to reduce the number of threads
+- rsfilesrc/rsfilesink: File source/sink elements as replacements for
+ the existing filesrc/filesink elements
-Changes to 0.3.X since 0.3.0
-
-- All references were updated from GitHub to freedesktop.org GitLab
-- Fix various links in the README.md
-- Link to the correct location for the documentation
-
-Changes in git master for 0.4
-
-- togglerecord: Switch to parking_lot crate for mutexes/condition
- variables for lower overhead
-- Merge threadshare plugin here
-- New closedcaption plugin with mccparse and mccenc elements
-- New identity element for the tutorials plugin
-
-- Register plugins statically in tests instead of relying on the
- plugin loader to find the shared library in a specific place
-
-- Update to the latest API changes in the GLib and GStreamer bindings
-- Update to the latest versions of all crates
+Build and Dependencies
+- this section will be filled in in due course
-Build and Dependencies
+gst-build
-- The MESON BUILD SYSTEM BUILD IS NOW FEATURE-COMPLETE (*) and it is
- now the recommended build system on all platforms and also used by
- Cerbero to build GStreamer on all platforms. The Autotools build is
- scheduled to be removed in the next cycle. Developers who currently
- use gst-uninstalled should move to gst-build. The build option
- naming has been cleaned up and made consistent and there are now
- feature options to enable/disable plugins and various other features
- on a case-by-case basis. (*) with the exception of plugin docs which
- will be handled differently in future
-
-- Symbol export in libraries is now controlled via explicit exports
- using symbol visibility or export defines where supported, to ensure
- consistency across all platforms. This also allows libraries to have
- exports that vary based on detected platform features and configure
- options as is the case with the GStreamer OpenGL integration library
- for example. A few symbols that had been exported by accident in
- earlier versions may no longer be exported. These symbols will not
- have had declarations in any public header files then though and
- would not have been usable.
-
-- The GStreamer FFmpeg wrapper plugin (gst-libav) now depends on
- FFmpeg 4.x and uses the new FFmpeg 4.x API and stopped relying on
- ancient API that was removed with the FFmpeg 4.x release. This means
- that it is no longer possible to build this module against an older
- system-provided FFmpeg 3.x version. Use the internal FFmpeg 4.x copy
- instead if you build using autotools, or use gst-libav 1.14.x
- instead which targets the FFmpeg 3.x API and _should_ work fine in
- combination with a newer GStreamer. It’s difficult for us to support
- both old and new FFmpeg APIs at the same time, apologies for any
- inconvenience caused.
-
-- Hardware-accelerated Nvidia video encoder/decoder plugins nvdec and
- nvenc can be built against CUDA Toolkit versions 9 and 10.0 now. The
- dynlink interface has been dropped since it’s deprecated in 10.0.
-
-- The (optional) OpenCV requirement has been bumped to >= 3.0.0 and
- the plugin can also be built against OpenCV 4.x now.
-
-- New sctp plugin based on usrsctp (for WebRTC data channels)
+- this section will be filled in in due course
Cerbero
on platforms where dependencies are not readily available, such as
Windows, Android, iOS and macOS.
-Cerbero has seen a number of improvements:
-
-- Cerbero has been ported to Python 3 and requires Python 3.5 or newer
- now
-
-- Source tarballs are now protected by checksums in the recipes to
- guard against download errors and malicious takeover of projects or
- websites. In addition, downloads are only allowed via secure
- transports now and plain HTTP, FTP and git:// transports are not
- allowed anymore.
+General improvements
-- There is now a new fetch-bootstrap command which downloads sources
- required for bootstrapping, with an optional --build-tools-only
- argument to match the bootstrap --build-tools-only command.
+- this section will be filled in in due course
-- The bootstrap, build, package and bundle-source commands gained a
- new --offline switch that ensures that only sources from the cache
- are used and never downloaded via the network. This is useful in
- combination with the fetch and fetch-bootstrap commands that acquire
- sources ahead of time before any build steps are executed. This
- allows more control over the sources used and when sources are
- updated, and is particularly useful for build environments that
- don’t have network access.
+macOS / iOS
-- bootstrap --assume-yes will automatically say ‘yes’ to any
- interactive prompts during the bootstrap stage, such as those from
- apt-get or yum.
+- this section will be filled in in due course
-- bootstrap --system-only will only bootstrap the system without build
- tools.
-
-- Manifest support: The build manifest can be used in continuous
- integration (CI) systems to fixate the Git revision of certain
- projects so that all builds of a pipeline are on the same reference.
- This is used in GStreamer’s gitlab CI for example. It can also be
- used in order to re-produce a specific build. To set a manifest, you
- can set manifest = 'my_manifest.xml' in your configuration file, or
- use the --manifest command line option. The command line option will
- take precedence over anything specific in the configuration file.
+Windows
-- The new build-deps command can be used to build only the
- dependencies of a recipe, without the recipe itself.
+- this section will be filled in in due course
-- new --list-variants command to list available variants
+Windows MSI installer
-- variants can now be set on the command line via the -v option as a
- comma-separated list. This overrides any variants set in any
- configuration files.
+- this section will be filled in in due course
-- new qt5, intelmsdk and nvidia variants for enabling Qt5 and hardware
- codec support. See the Enabling Optional Features with Variants
- section in the Cerbero documentation for more details how to enable
- and use these variants.
+Linux
-- When building on Windows, Cerbero can now build GStreamer recipes
- and core dependencies such as glib with Visual Studio. This is
- controlled by the visualstudio variant. Visual Studio 2015, 2017,
- and 2019 are supported. Currently, only 64-bit x86 is supported due
- to a known bug which will be fixed for the next release.
+- this section will be filled in in due course
-- A new -t / --timestamp command line switch makes commands print
- timestamps
+Android
+- this section will be filled in in due course
Platform-specific changes and improvements
Android
-- toolchain: update compiler to clang and NDKr18. NDK r18 removed the
- armv5 target and only has Android platforms that target at least
- armv7 so the armv5 target is not useful anymore.
-
-- The way that GIO modules are named has changed due to upstream GLib
- natively adding support for loading static GIO modules. This means
- that any GStreamer application using gnutls for SSL/TLS on the
- Android or iOS platforms (or any other setup using static libraries)
- will fail to link looking for the g_io_module_gnutls_load_static()
- function. The new function name is now
- g_io_gnutls_load(gpointer data). data can be NULL for a static
- library. Look at this commit for the necessary change in the
- examples.
-
-- various build issues on Android have been fixed.
+- this section will be filled in in due course
macOS and iOS
-- various build issues on iOS have been fixed.
+- this section will be filled in in due course
-- the minimum required iOS version is now 9.0. The difference in
- adoption between 8.0 and 9.0 is 0.1% and the bump to 9.0 fixes some
- build issues.
+Windows
-- The way that GIO modules are named has changed due to upstream GLib
- natively adding support for loading static GIO modules. This means
- that any GStreamer application using gnutls for SSL/TLS on the
- Android or iOS platforms (or any other setup using static libraries)
- will fail to link looking for the g_io_module_gnutls_load_static()
- function. The new function name is now
- g_io_gnutls_load(gpointer data). data can be NULL for a static
- library. Look at this commit for the necessary change in the
- examples.
+- this section will be filled in in due course
-Windows
+Linux
-- The webrtcdsp element is shipped again as part of the Windows binary
- packages, the build system issue has been resolved.
+- this section will be filled in in due course
-- ‘Inconsistent DLL linkage’ warnings when building with MSVC have
- been fixed
+Documentation improvements
-- Hardware-accelerated Nvidia video encoder/decoder plugins nvdec and
- nvenc build on Windows now, also with MSVC and using Meson.
+- this section will be filled in in due course
-- The ksvideosrc camera capture plugin supports 16-bit grayscale video
- now
+Possibly Breaking Changes
-- The wasapisrc audio capture element implements loopback recording
- from another output device or sink
+- this section will be filled in in due course
+- MPEG-TS SCTE-35 API changes (FIXME: flesh out)
+- gst_parse_launch() and friends now error out on non-existing
+ properties on top-level bins where they would silently fail and
+ ignore those before.
-- wasapisink recover from low buffer levels in shared mode and some
- exclusive mode fixes
+Known Issues
+
+- this section will be filled in in due course
-- dshowsrc now implements the GstDeviceMonitor interface
+- There are a couple of known WebRTC-related regressions/blockers:
+ - webrtc: DTLS setup with Chrome is broken
+ - webrtcbin: First keyframe is usually lost
Contributors
-Aaron Boxer, Aleix Conchillo Flaqué, Alessandro Decina, Alexandru Băluț,
-Alex Ashley, Alexey Chernov, Alicia Boya García, Amit Pandya, Andoni
-Morales Alastruey, Andreas Frisch, Andre McCurdy, Andy Green, Anthony
-Violo, Antoine Jacoutot, Antonio Ospite, Arun Raghavan, Aurelien Jarno,
-Aurélien Zanelli, ayaka, Bananahemic, Bastian Köcher, Branko Subasic,
-Brendan Shanks, Carlos Rafael Giani, Charlie Turner, Christoph Reiter,
-Corentin Noël, Daeseok Youn, Damian Vicino, Dan Kegel, Daniel Drake,
-Daniel Klamt, Danilo Spinella, Dardo D Kleiner, David Ing, David
-Svensson Fors, Devarsh Thakkar, Dimitrios Katsaros, Edward Hervey,
-Emilio Pozuelo Monfort, Enrique Ocaña González, Erlend Eriksen, Ezequiel
-Garcia, Fabien Dessenne, Fabrizio Gennari, Florent Thiéry, Francisco
-Velazquez, Freyr666, Garima Gaur, Gary Bisson, George Kiagiadakis, Georg
-Lippitsch, Georg Ottinger, Geunsik Lim, Göran Jönsson, Guillaume
-Desmottes, H1Gdev, Haihao Xiang, Haihua Hu, Harshad Khedkar, Havard
-Graff, He Junyan, Hoonhee Lee, Hosang Lee, Hyunjun Ko, Ilya Smelykh,
-Ingo Randolf, Iñigo Huguet, Jakub Adam, James Stevenson, Jan Alexander
-Steffens, Jan Schmidt, Jerome Laheurte, Jimmy Ohn, Joakim Johansson,
-Jochen Henneberg, Johan Bjäreholt, John-Mark Bell, John Bassett, John
-Nikolaides, Jonathan Karlsson, Jonny Lamb, Jordan Petridis, Josep Torra,
-Joshua M. Doe, Jos van Egmond, Juan Navarro, Julian Bouzas, Jun Xie,
-Junyan He, Justin Kim, Kai Kang, Kim Tae Soo, Kirill Marinushkin, Kyrylo
-Polezhaiev, Lars Petter Endresen, Linus Svensson, Louis-Francis
-Ratté-Boulianne, Lucas Stach, Luis de Bethencourt, Luz Paz, Lyon Wang,
-Maciej Wolny, Marc-André Lureau, Marc Leeman, Marco Trevisan (Treviño),
-Marcos Kintschner, Marian Mihailescu, Marinus Schraal, Mark Nauwelaerts,
-Marouen Ghodhbane, Martin Kelly, Matej Knopp, Mathieu Duponchelle,
-Matteo Valdina, Matthew Waters, Matthias Fend, memeka, Michael Drake,
-Michael Gruner, Michael Olbrich, Michael Tretter, Miguel Paris, Mike
-Wey, Mikhail Fludkov, Naveen Cherukuri, Nicola Murino, Nicolas Dufresne,
-Niels De Graef, Nirbheek Chauhan, Norbert Wesp, Ognyan Tonchev, Olivier
-Crête, Omar Akkila, Pat DeSantis, Patricia Muscalu, Patrick Radizi,
-Patrik Nilsson, Paul Kocialkowski, Per Forlin, Peter Körner, Peter
-Seiderer, Petr Kulhavy, Philippe Normand, Philippe Renon, Philipp Zabel,
-Pierre Labastie, Piotr Drąg, Roland Jon, Roman Sivriver, Roman Shpuntov,
-Rosen Penev, Russel Winder, Sam Gigliotti, Santiago Carot-Nemesio,
-Sean-Der, Sebastian Dröge, Seungha Yang, Shi Yan, Sjoerd Simons, Snir
-Sheriber, Song Bing, Soon, Thean Siew, Sreerenj Balachandran, Stefan
-Ringel, Stephane Cerveau, Stian Selnes, Suhas Nayak, Takeshi Sato,
-Thiago Santos, Thibault Saunier, Thomas Bluemel, Tianhao Liu,
-Tim-Philipp Müller, Tobias Ronge, Tomasz Andrzejak, Tomislav Tustonić,
-U. Artie Eoff, Ulf Olsson, Varunkumar Allagadapa, Víctor Guzmán, Víctor
-Manuel Jáquez Leal, Vincenzo Bono, Vineeth T M, Vivia Nikolaidou, Wang
-Fei, wangzq, Whoopie, Wim Taymans, Wind Yuan, Wonchul Lee, Xabier
-Rodriguez Calvar, Xavier Claessens, Haihao Xiang, Yacine Bandou,
-Yeongjin Jeong, Yuji Kuwabara, Zeeshan Ali,
+- this section will be filled in in due course
… and many others who have contributed bug reports, translations, sent
suggestions or helped testing.
+Stable 1.20 branch
-Stable 1.16 branch
-
-After the 1.16.0 release there will be several 1.16.x bug-fix releases
+After the 1.20.0 release there will be several 1.20.x bug-fix releases
which will contain bug fixes which have been deemed suitable for a
stable branch, but no new features or intrusive changes will be added to
-a bug-fix release usually. The 1.16.x bug-fix releases will be made from
-the git 1.16 branch, which is a stable branch.
-
-1.16.0
-
-1.16.0 was released on 19 April 2019.
-
-1.16.1
-
-The first 1.16 bug-fix release (1.16.1) was released on 23 September
-2019.
-
-This release only contains bugfixes and it _should_ be safe to update
-from 1.16.0.
-
-Highlighted bugfixes in 1.16.1
-
-- GStreamer-vaapi: fix green frames and decoding artefacts in some
- cases
-- OpenGL: fix wayland event source burning CPU in certain
- circumstances
-- Memory leak fixes and memory footprint improvements
-- Performance improvements
-- Stability and security fixes
-- Fix enum for GST_MESSAGE_DEVICE_CHANGED which is technically an API
- break, but this is only used internally in GStreamer and duplicated
- another message enum
-- hls: Make crypto dependency optional when hls-crypto is auto
-- player: fix switching back and forth between forward and reverse
- playback
-- decklinkaudiosink: Drop late buffers
-- openh264enc: Fix compilation with openh264 v2.0
-- wasapisrc: fix segtotal value being always 2
-- android: Fix gnutls issue causing a FORTIFY crash on Android Q
-- windows: Fix two crashes due to cross-CRT free when using MSVC
-
-gstreamer core
-
-- device: gst_device_create_element() is transfer floating, not
- transfer full
-- filesink, fdsink: respect IOV_MAX for the writev iovec array
- (Solaris)
-- miniobject: free qdata array when the last qdata is removed (reduces
- memory footprint)
-- bin: Fix minor race when adding to a bin
-- aggregator: Actually handle NEED_DATA return from update_src_caps()
-- aggregator: Ensure that the source pad is created as a
- GstAggregatorPad if no type is given in the pad template
-- latency: fix custom event leaks
-- registry: Use plugin directory from the build system for
- relocateable Windows builds
-- message: fix up enum value for GST_MESSAGE_DEVICE_CHANGED
-- info: Fix deadlock in gst_ring_buffer_logger_log()
-- downloadbuffer: Check for flush after seek
-- identity: Non-live upstream have no max latency
-- identity: Fix the ts-offset property getter
-- aggregator: Make parsing of explicit sink pad names more robust
-- bufferpool: Fix the buffer size reset code
-- fakesink, fakesrc, identity: sync gst_buffer_get_flags_string() with
- new flags
-- multiqueue: never unref queries we do not own
-- concat: Reset last_stop on FLUSH_STOP too
-- aggregator: fix flow-return boolean return type mismatch
-- gstpad: Handle probes that reset the data field
-- gst: Add support for g_autoptr(GstPromise)
-- gst-inspect: fix unused-const-variable error in windows
-- base: Include gstbitwriter.h in the single-include header
-- Add various Since: 1.16 markers
-- GST_MESSAGE_DEVICE_CHANGED duplicates GST_MESSAGE_REDIRECT
-- Targetting wrong meson version
-- meson: Make get_flex_version.py script executable
-- meson: Link to objects instead of static helper library
-- meson: set correct install path for gdb helper
-- meson: fix warning about configure_file() install kwarg
-
-gst-plugins-base
-
-- video-info: parse field-order for all interleaved formats
-- tests: fix up valgrind suppressions for glibc getaddrinfo leaks
-- meson: Reenable NEON support (in audio resampler)
-- audio-resampler: Update NEON to handle remainders not multiples of 4
-- eglimage: Fix memory leak
-- audiodecoder: Set output caps with negotiated caps to avoid critical
- info printed
-- video-frame: Take TFF flag from the video info if it was set in
- there
-- glcolorconvert: Fix external-oes shader
-- video-anc: Fix ADF detection when trying to extract data from vanc
-- gl/wayland: fix wayland event source burning CPU
-- configure: add used attribute in order to make NEON detection
- working with -flto.
-- audioaggregator: Return a valid rate range from caps query if
- downstream supports a whole range
-- rtspconnection: data-offset increase not set
-- rtpsconnection: Fix number of n_vectors
-- video-color: Add compile-time assert for ColorimetryInfo enum
-- audiodecoder: Fix leak on failed audio gaps
-- glupload: Keep track of cached EGLImage texture format
-- playsink: Set ts-offset to text sink.
-- meson.build: use join_paths() on prefix
-- compositor: copy frames as-is when possible
-- compositor: Skip background when a pad obscures it completely
-- rtspconnection: Start CSeq at 1 (some servers don’t cope well with
- seqnum 0)
-- viv-fb: fix build break for GST_GL_API
-- gl/tests: fix shader creation tests part 2
-- gl/tests: fix shader creation tests
-- wayland: set the event queue also for the xdg_wm_base object
-- video: Added GI annotation for gstvideoaffinetransformationmeta
- apply_matrix
-- compositor: Remove unneeded left shift for ARGB/AYUV SOURCE operator
-- Colorimetry fixes
-- alsasrc: Don’t use driver timestamp if it’s zero
-- gloverlaycompositor: fix crash if buffer doesn’t have video meta
-- meson: Don’t try to find gio-unix on Windows
-- glshader: fix default external-oes shaders
-- subparse: fix pushing WebVTT cue with no newline at the end
-- meson: Missing “android” choice in gl_winsys
-- video test: Keep BE test inline with LE test
-- id3tag: Correctly validate the year from v1 tags before passing to
- GstDateTime
-- gl/wayland: Don’t prefix wl_shell struct field
-- eglimage: Add compatibility define for DRM_FORMAT_NV24
-- Add various Since: 1.16 markers
-- video-anc: Handle SD formats correctly
-- Docs: add GL_CFLAGS to GTK_DOC_CFLAGS
-- GL: using vaapi and showing on glimagesink on wayland loads one core
- for 100% on 1.16
-- GL: external-oes shader places precision qualifier before #extension
- (was: androidmedia amcviddec fail after 1.15.90 1.16.0 update)
-
-gst-plugins-good
-
-- alpha: Fix one_over_kc calculation on arm/aarch64
-- souphttpsrc: Fix incompatible type build warning
-- rtpjitterbuffer: limit max-dropout-time to maxint32
-- rtpjitterbuffer: Clear clock master before unreffing
-- qtdemux: Use empty-array safe way to cleanup GPtrArray
-- v4l2: Fix type compatibility issue with glibc 2.30
-- valgrind: suppress Cond error coming from gnutls and Ignore leaks
- caused by shout/sethostent
-- rtpfunnel: forward correct segment when switching pad
-- gtkglsink: fix crash when widget is resized after element
- destruction
-- jpegdec: Don’t dereference NULL input state if we have no caps in
- TIME segments
-- rtp: opuspay: fix memory leak in gst_rtp_opus_pay_setcaps
-- v4l2videodec: return right type for drain.
-- rtpssrcdemux: Avoid taking streamlock out-of-band
-- Support v4l2src buffer orphaning
-- splitmuxsink: Only set running time on finalizing sink element when
- in async-finalize mode
-- rtpsession: Always keep at least one NACK on early RTCP
-- rtspsrc: do not try to send EOS with invalid seqnum
-- rtpsession: Call on-new-ssrc earlier
-- rtprawdepay: Don’t get rid of the buffer pool on FLUSH_STOP
-- rtpbin: Free storage when freeing session
-- scaletempo: Advertise interleaved layout in caps templates
-- Support v4l2src buffer orphaning
-
-gst-plugins-bad
-
-- hls: Make crypto dependency optional when hls-crypto is auto
-- player: fix switching back and forth between forward and reverse
- playback
-- decklinkaudiosink: Drop late buffers
-- srt: Add stats property, include sender-side statistics and fix a
- crash
-- dshowsrcwrapper: fix regression on device selection
-- tsdemux: Limit the maximum PES payload size
-- wayland: Define libdrm_dep in meson.build to fix meson configure
- error when kms is disabled
-- sctp: Fix crash on free() when using the MSVC binaries
-- webrtc: Fix signals documentation
-- h264parse: don’t critical on VUI parameters > 2^31
-- rtmp: Fix crash inside free() with MSVC on Windows
-- iqa: fix leak of map_meta.data
-- d3dvideosink: Fix crash on WinProc handler
-- amc: Fix crash when a sync_meta survives its sink
-- pitch: Fix race between putSamples() and setting soundtouch
- parameters
-- webrtc: fix type of max-retransmits, make it work
-- mxfdemux: Also allow picture essence element type 0x05 for VC-3
-- wasapi: fix symbol redefinition build error
-- decklinkvideosrc: Retrieve mode of the ancillary data from the frame
-- decklinkaudiosrc/decklinkvideosrc: Do nothing in
- BaseSrc::negotiate() and…
-- adaptivedemux: do not retry downloads during shutdown.
-- webrtcbin: fix GInetAddress leak
-- dtls: fix dtls connection object leak
-- siren: fix a global buffer overflow spotted by asan
-- kmssink: Fix implicit declaration build error
-- Fix -Werror=return-type error in configure.
-- aiff: Fix infinite loop in header parsing.
-- nvdec: Fix possible frame drop on EOS
-- srtserversrc: yields malformed rtp payloads
-- srtsink: Fix crash in case no URI
-- dtlsagent: Fix leaked dtlscertificate
-- meson: bluez: Early terminate configure on Windows
-- decklink: Correctly ensure >=16 byte alignment for the buffers we
- allocate
-- webrtcbin: fix DTLS when receivebin is set to DROP
-- zbar: Include running-time, stream-time and duration in the messages
-- uvch264src: Make sure we set our segment
-- avwait: Allow start and end timecode to be set back to NULL
-- avwait: Don’t print warnings for every buffer passed
-- hls/meson: fix dependency logic
-- Waylandsink gnome shell workaround
-- avwait: Allow setting start timecode after end timecode; protect
- propeties with mutex
-- wayland/wlbuffer: just return if used_by_compositor is true when
- attach
-- proxy: Set SOURCE flag on the source and SINK flag on the sink
-- ivfparse: Check the data size against IVF_FRAME_HEADER_SIZE
-- webrtc: Add various Since markers to new types after 1.14.0
-- msdk: fix the typo in debug category
-- dtlsagent: Do not overwrite openssl locking callbacks
-- meson: Fix typo in gsm header file name
-- srt: handle races in state change
-- webrtc: Add g_autoptr() support for public types
-- openh264enc: Fix compilation with openh264 v2.0
-- meson: Allow CUDA_PATH fallback on linux
-- meson: fix build with opencv=enabled and opencv4. Fixes #964
-- meson: Add support for the colormanagement plugin
-- autotools: gstsctp: set LDFLAGS
-- nvenc/nvdec: Add NVIDIA SDK headers to noinst_HEADERS
-- h264parse: Fix typo when setting multiview mode and flags
-- Add various Since: 1.16 markers
-- opencv: allow compilation against 4.1.x
-- Backport of some minor srt commits without MR into 1.16
-- meson: fix build with opencv=enabled and opencv4
-- wasapisrc: fix segtotal value being always 2 due to an unused
- variable
-- meson: colormanagement missing
-- androidmedia amcviddec fail after 1.15.90 1.16.0 update
-
-gst-plugins-ugly
-
-- meson: Always require the gmodule dependency
-
-gst-libav
-
-- docs: don’t include the type hierarchy, fixing build with gtk-doc
- 1.30
-- avvidenc: Correctly signal interlaced input to ffmpeg when the input
- caps are interlaced
-- autotools: add bcrypt to win32 libs
-- gstav: Use libavcodec util function for version check
-- API documentation fails to build with gtk-doc 1.30
-
-gst-rtsp-server
-
-- rtsp-client: RTP Info must exist in PLAY response
-- onvif-media: fix “void function returning a value” compiler warning
-- Add various Since: 1.16 markers
-
-gstreamer-vaapi
-
-- fix egl context leak and display creation race
-- pluginutil: Remove Mesa from drivers white list
-- Classify vaapidecodebin as a hardware decoder
-- Fix two leak
-- vaapivideomemory: demote error message to info
-- encoder: vp8,vp9: reset frame_counter when input frame’s format
- changes
-- encoder: mpeg2: No packed header for SPS and PPS
-- decoder: vp9: clear parser pointer after release
-- encoder: Fixes deadlock in change state function
-- encoder: h265: reset num_ref_idx_l1_active_minus1 when low delay B.
-- encoder: not call ensure_num_slices inside g_assert()
-- encoder: continue if roi meta is NULL
-- decoder: vp9: Set chroma_ ype by VP9 bit_depth
-- vaapipostproc: don’t do any color conversion when GL_TEXTURE_UPLOAD
-- libs: surface: fix double free when dmabuf export fails
-- h264 colors and artifacts upon upgrade to GStreamer Core Library
- version 1.15.90
-
-gst-editing-services
-
-- element: Properly handle the fact that pasting can return NULL
-- Add various missing Since markers
-- launch: Fix caps restriction short names
-- python: Avoid warning about using deprecated methods
-- video-transition: When using non crossfade effect use ‘over’
- operations
-- meson: Generate a pkgconfig file for the GES plugin
-
-gst-devtools
-
-- launcher: testsuites: skip systemclock stress tests
-- validate: fix build on macOS
-
-gst-build
-
-- Update win flex bison binaries
-- Update the flexmeson windows binary version
-- Don’t allow people to run meson inside the uninstalled env
-
-Cerbero build tool and packaging changes in 1.16.1
-
-- cerbero: Add enums for Fedora 30, Fedora 31 and Debian bullseye
-- gnutls.recipe: Fix crash when running on Android Q
-- recipes: Upgrade openssl to 1.1.1c
-- Fix some typos
-- add support for vs build tools 2019, fixes #183
-- android: Adjust gstreamer-1.0.mk for NDK r20
-- Fix license enums
-- bootstrap: Fix dnf usage on CentOS
-- Make _add_system_libs reentrant
-- meson.recipe: Fix setting of bitcode compiler options
-- cerbero: support Ubuntu disco dingo
-- cerbero: Set utf-8 to execution character set also on MSVC
-- git: simplify the reset of the source branch.
-- FORTIFY: %n not allowed on Android Q
-- Fails to build if there’s no license file for the given license
- (GPL/LGPL without Plus, Proprietary, …)
-
-Contributors to 1.16.1
-
-Aaron Boxer, Adam Duskett, Alicia Boya García, Andoni Morales Alastruey,
-Antonio Ospite, Arun Raghavan, Askar Safin, A. Wilcox, Charlie Turner,
-Christoph Reiter, Damian Hobson-Garcia, Daniel Klamt, Danny Smith, David
-Gunzinger, David Ing, David Svensson Fors, Doug Nazar, Edward Hervey,
-Eike Hein, Fabrice Bellet, Fernando Herrrera, Georg Lippitsch, Göran
-Jönsson, Guillaume Desmottes, Haihao Xiang, Haihua Hu, Håvard Graff, Hou
-Qi, Ignacio Casal Quinteiro, Ilya Smelykh, Jan Schmidt, Javier Celaya,
-Jim Mason, Jonas Larsson, Jordan Petridis, Jose Antonio Santos Cadenas,
-Juan Navarro, Knut Andre Tidemann, Kristofer Björkström, Lucas Stach,
-Marco Felsch, Marcos Kintschner, Mark Nauwelaerts, Martin Liska, Martin
-Theriault, Mathieu Duponchelle, Matthew Waters, Michael Olbrich, Mike
-Gorse, Nicola Murino, Nicolas Dufresne, Niels De Graef, Niklas
-Hambüchen, Nirbheek Chauhan, Olivier Crête, Philippe Normand, Ross
-Burton, Sebastian Dröge, Seungha Yang, Song Bing, Thiago Santos,
-Thibault Saunier, Thomas Coldrick, Tim-Philipp Müller, Víctor Manuel
-Jáquez Leal, Vivia Nikolaidou, Xavier Claessens, Yeongjin Jeong,
-
-… and many others who have contributed bug reports, translations, sent
-suggestions or helped testing. Thank you all!
-
-List of merge requests and issues fixed in 1.16.1
-
-- List of Merge Requests applied in 1.16
-- List of Issues fixed in 1.16.1
-
-1.16.2
-
-The second 1.16 bug-fix release (1.16.2) was released on 03 December
-2019.
-
-This release only contains bugfixes and it _should_ be safe to update
-from 1.16.1.
-
-Highlighted bugfixes in 1.16.2
-
-- Interlaced video scaling fixes
-- CineForm video support in AVI
-- audioresample: avoid glitches due to rounding errors after changing
- rate
-- Command line tool output printing improvements on Windows
-- various performance improvements, memory leak fixes and security
- fixes
-- VP9 decoding fixes
-- avfvideosrc: Explicitly request video permission on macOS 10.14+
-- wasapi: bug fixes and stability improvements
-- webrtc-audio-processing: fix segmentation fault on 32-bit windows
-- tsdemux: improved handling of certain discontinuities
-- vaapi h265 decoder: wait for I-frame before trying to decode
-
-gstreamer
-
-- gst-launch: Fix ugly stdout on Windows
-- tee: Make sure to actually deactivate pads that are released
-- bin: Drop need-context messages without source instead of crashing
-- gst: Don’t pass miniobjects to GST_DEBUG_OBJECT() and similar macros
-- tracers: Don’t leak temporary GstStructure
-
-gst-plugins-base
-
-- xvimagepool: Update size, stride, and offset with allocated XvImage
-- video-converter: Fix RGB-XYZ-RGB conversion
-- audiorate: Update next_offset on rate change
-- audioringbuffer: Reset reorder flag before check
-- audio-buffer: Don’t fail to map buffers with zero samples
-- videorate: Fix max-duplication-time handling
-- gl/gbm: ensure we call the resize callback before attempting to draw
-- video-converter: Various fixes for interlaced scaling
-- gstrtspconnection: messages_bytes not decreased
-- check: Don’t use real audio devices for tests
-- riff: add CineForm mapping
-- glfilters: Don’t use static variables for storing per-element state
-- glupload: Add VideoMetas and GLSyncMeta to the raw uploaded buffers
-- streamsynchronizer: avoid pad release race during logging.
-- gst-play: Use gst_print* to avoid broken stdout string on Windows
-
-gst-plugins-good
-
-- vp9dec: Fix broken 4:4:4 8bits decoding
-- rtpsession: add locking for clear-pt-map
-- rtpL16depay: don’t crash if data is not modulo channels*width
-- wavparse: Fix push mode ignoring audio with a size smaller than
- segment buffer
-- wavparse: Fix push mode ignoring last audio payload chunk
-- aacparse: fix wrong offset of the channel number in adts header
-- jpegdec: Fix incorrect logic in EOI tag detection
-- videocrop: Also update the coordinate when in-place
-- jpegdec: don’t overwrite the last valid line
-- vpx: Error out if enabled and no features found
-- v4l2videodec: ensure pool exists before orphaning it
-- v4l2videoenc: fix type conversion errors
-- v4l2bufferpool: Queue number of allocated buffers to capture
-- v4l2object: fix mpegversion number typo
-- v4l2object: Work around bad TRY_FMT colorimetry implementations
-
-gst-plugins-bad
-
-- avfvideosrc: Explicitly request video permission on macOS 10.14+
-- wasapi: Various fixes and a workaround for a specific driver bug
-- wasapi: Move to CoInitializeEx for COM initialization
-- wasapi: Fix runtime/build warnings
-- waylandsink: Commit the parent after creating subsurface
-- msdkdec: fix surface leak in msdkdec_handle_frame
-- tsmux: Fix copying of buffer region
-- tsdemux: Handle continuity mismatch in more cases
-- tsdemux: Always issue a DTS even when it’s equal to PTS
-- openexr: Fix build with OpenEXR 2.4 (and also OpenEXR 2.2 on Ubuntu
- 18.04)
-- ccextractor: Always forward all sticky events to the caption pad
-- pnmdec: Return early on ::finish() if we have no actual data to
- parse
-- ass: avoid infinite unref loop with bad data
-- fluidsynth: add sf3 to soundfont search path
-- webrtcdsp/webrtcechoprobe segmentation fault on windows (1.16.0 x86)
-
-gst-libav
-
-- avvidenc: Fix error propagation
-- avdemux: Fix segmentation fault if long_name is NULL
-- avviddec: Fix huge leak caused by circular reference
-- avviddec: Enforce allocate new AVFrame per input frame
-- avdec_mpeg2video (and probably more): Huge memory leak in git master
-
-gst-rtsp-server
-
-- rtsp-media: Use lock in gst_rtsp_media_is_receive_only
-- rtsp-client: RTP Info when completed_sender
-- rtsp-client: fix location uri-format by getting uri directly from
- context instead
-
-gstreamer-vaapi
-
-- meson build: halt configuration if no renderer API
-- libs: decoder: h265: skip all pictures prior the first I-frame
-- libs: window: x11: Avoid usage of deprecated API
-
-gst-editing-services
-
-- Initialize debug categories before usage
-
-gst-build
-
-- gst-env: Use locally built GStreamer utility programs
-
-Cerbero build tool and packaging changes in 1.16.2
-
-General
-
-- openssl: Update to 1.1.1d
-- Updated ffmpeg, expat, flac, freetype, croco, ogg, xml2, mpg123,
- openjpeg, opus, pixman, speex, tiff recipes
-- Fix setting of git credentials in local source repos
-
-Windows
-
-- webrtc-audio-processing: fix segmentation fault on 32-bit windows
- with webrtcdsp/webrtcechoprobe elemens
-- vpx plugin has no features when built with Visual Studio 2019
-- libvpx: Add support for Visual Studio 2019
-- mingw-runtime.recipe: Correctly package pkg-config in the MSI
-- GIO doesn’t load any modules on Windows with MSVC, which breaks TLS
- support since glib-networking’s giognutls module isn’t loaded
-- Make the instructions for running Cerbero the same on all platforms
-
-macOS + iOS
-
-- Add support for macOS 10.15 Catalina
-- Updates for Xcode 11
-- macos/ios: expose objc++ compilers in env variables
-- srt.recipe: Fix crash in constructor on iOS
-- osx-framework.recipe: Dynamically generate the list of libraries and
- ship pkg-config
-- macos: add -mmacosx-version-min for framework
-- gstreamer-1.0-osx-framework.recipe contains an outdated hard-coded
- list of libraries
-- We need to ship pkg-config with macOS
-
-Linux
-
-- Fix filesprovider.find_shlib_regex when a lib_suffix is used in the
- cerbero config file
-
-Contributors to 1.16.2
-
-Adam Nilsson, Amr Mahdi, Angus Ao, Charlie Turner, Edward Hervey, Fabian
-Greffrath, Fuwei Tang, Havard Graff, Hu Qian, James Cowgill, Jan
-Alexander Steffens (heftig), Jeffy Chen, Jeremy Lempereur, Joakim
-Johansson, Jochen Henneberg, Julien Isorce, Kevin Joly, Kristofer
-Bjorkstrom, Kyrylo Polezhaiev, Matthew Waters, Michael Olbrich, Muhammet
-Ilendemli, Nicolas Dufresne, Nirbheek Chauhan, Pablo Marcos Oltra, Roman
-Shpuntov, Ruben Gonzalez, Scott Kanowitz, Sebastian Dröge, Seungha Yang,
-Thibault Saunier, Tim-Philipp Müller, Víctor Manuel Jáquez Leal, Vivia
-Nikolaidou,
-
-… and many others who have contributed bug reports, translations, sent
-suggestions or helped testing. Thank you all!
-
-List of merge requests and issues fixed in 1.16.2
-
-- List of Merge Requests applied in 1.16
-- List of Issues fixed in 1.16.2
-
-
-Known Issues
-
-- possibly breaking/incompatible changes to properties of wrapped
- FFmpeg decoders and encoders (see above).
+a bug-fix release usually. The 1.20.x bug-fix releases will be made from
+the git 1.20 branch, which will be a stable branch.
-- The way that GIO modules are named has changed due to upstream GLib
- natively adding support for loading static GIO modules. This means
- that any GStreamer application using gnutls for SSL/TLS on the
- Android or iOS platforms (or any other setup using static libraries)
- will fail to link looking for the g_io_module_gnutls_load_static()
- function. The new function name is now
- g_io_gnutls_load(gpointer data). See Android/iOS sections above for
- further details.
+1.20.0
+1.20.0 is scheduled to be released around October/November 2021.
-Schedule for 1.18
+Schedule for 1.22
-Our next major feature release will be 1.18, and 1.17 will be the
-unstable development version leading up to the stable 1.18 release. The
-development of 1.17/1.18 will happen in the git master branch.
+Our next major feature release will be 1.22, and 1.21 will be the
+unstable development version leading up to the stable 1.22 release. The
+development of 1.21/1.22 will happen in the git main branch.
-The plan for the 1.18 development cycle is yet to be confirmed, but it
-is now expected that feature freeze will take place in December 2019,
-with the first 1.18 stable release ready in late January or February.
+The plan for the 1.22 development cycle is yet to be confirmed.
-1.18 will be backwards-compatible to the stable 1.16, 1.14, 1.12, 1.10,
-1.8, 1.6, 1.4, 1.2 and 1.0 release series.
+1.22 will be backwards-compatible to the stable 1.20, 1.18, 1.16, 1.14,
+1.12, 1.10, 1.8, 1.6, 1.4, 1.2 and 1.0 release series.
------------------------------------------------------------------------
-_These release notes have been prepared by Tim-Philipp Müller with_
-_contributions from Sebastian Dröge, Guillaume Desmottes, Matthew
-Waters, _ _Thibault Saunier, and Víctor Manuel Jáquez Leal._
+These release notes have been prepared by Tim-Philipp Müller with
+contributions from …
-_License: CC BY-SA 4.0_
+License: CC BY-SA 4.0