Release 1.19.2
[platform/upstream/gstreamer.git] / NEWS
diff --git a/NEWS b/NEWS
index c216f07..0e581c3 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,22 +1,23 @@
-GStreamer 1.18 Release Notes
+GStreamer 1.20 Release Notes
 
-These release notes are a placeholder, please bear with us while we
-finish writing up the real thing.
+GStreamer 1.20 has not been released yet. It is scheduled for release
+around October/November 2021.
 
-GStreamer 1.18.0 has not yet been released. It is scheduled for release
-in late August / early September 2020.
+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
 
-1.17.x is the unstable development series that is currently being
-developed in the git master branch and which will eventually result in
-1.18, and 1.17.90 is the current 1.18 pre-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.
 
-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.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.
 
-See https://gstreamer.freedesktop.org/releases/1.18/ for the latest
+See https://gstreamer.freedesktop.org/releases/1.20/ for the latest
 version of this document.
 
-Last updated: Wednesday 20 August 2020, 11:00 UTC (log)
+Last updated: Wednesday 22 September 2021, 18:00 UTC (log)
 
 Introduction
 
@@ -29,117 +30,167 @@ fixes and other improvements.
 
 Highlights
 
--   FIXME
+-   this section will be completed in due course
 
 Major new features and changes
 
-Noteworthy new API
+Noteworthy new features and API
 
--   FIXME
+-   this section will be filled in in due course
 
-New Elements
+New elements
 
--   FIXME
+-   this section will be filled in in due course
 
 New element features and additions
 
--   FIXME
+-   this section will be filled in in due course
 
 Plugin and library moves
 
--   FIXME
+-   this section will be filled in in due course
+
+-   There were no plugin moves or library moves in this cycle.
 
 Plugin removals
 
-The following plugins have been removed from gst-plugins-bad:
+The following elements or plugins have been removed:
 
--   FIXME
+-   this section will be filled in in due course
 
 Miscellaneous API additions
 
--   FIXME
-
-Miscellaneous performance and memory optimisations
-
-As always there have been many performance and memory usage improvements
-across all components and modules. Some of them 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:
+-   this section will be filled in in due course
 
--   FIXME
+Miscellaneous performance, latency and memory optimisations
 
-GstPlayer
+-   this section will be filled in in due course
 
--   FIXME
+Miscellaneous other changes and enhancements
 
-Miscellaneous changes
-
--   FIXME
-
-OpenGL integration
-
--   FIXME
+-   this section will be filled in in due course
 
 Tracing framework and debugging improvements
 
--   FIXME
+-   this section will be filled in in due course
 
 Tools
 
--   FIXME
+-   this section will be filled in in due course
 
 GStreamer RTSP server
 
--   FIXME
+-   this section will be filled in in due course
 
 GStreamer VAAPI
 
--   FIXME
+-   this section will be filled in in due course
 
 GStreamer OMX
 
--   FIXME
+-   this section will be filled in in due course
 
 GStreamer Editing Services and NLE
 
--   FIXME
+-   this section will be filled in in due course
 
 GStreamer validate
 
--   FIXME
+-   this section will be filled in in due course
 
 GStreamer Python Bindings
 
--   FIXME
+-   this section will be filled in in due course
 
 GStreamer C# Bindings
 
--   FIXME
-
-GStreamer Rust Bindings
-
--   FIXME
-
-GStreamer Rust Plugins
-
--   FIXME
+-   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
 
 Build and Dependencies
 
--   The Autotools build system has finally been removed in favour of the
-    Meson build system. Developers who currently use gst-uninstalled
-    should move to gst-build.
+-   this section will be filled in in due course
 
--   API and plugin documentation are no longer built with gtk_doc. The
-    gtk_doc documentation has been removed in favour of a new unified
-    documentation module built with hotdoc. The intention is to
-    distribute the generated documentation in form of tarballs alongside
-    releases.
+gst-build
 
--   FIXME
+-   this section will be filled in in due course
 
 Cerbero
 
@@ -147,63 +198,102 @@ Cerbero is a meta build system used to build GStreamer plus dependencies
 on platforms where dependencies are not readily available, such as
 Windows, Android, iOS and macOS.
 
-Cerbero has seen a number of improvements:
+General improvements
+
+-   this section will be filled in in due course
+
+macOS / iOS
+
+-   this section will be filled in in due course
+
+Windows
+
+-   this section will be filled in in due course
+
+Windows MSI installer
 
--   FIXME
+-   this section will be filled in in due course
+
+Linux
+
+-   this section will be filled in in due course
+
+Android
+
+-   this section will be filled in in due course
 
 Platform-specific changes and improvements
 
 Android
 
--   FIXME
+-   this section will be filled in in due course
 
 macOS and iOS
 
--   FIXME
+-   this section will be filled in in due course
 
 Windows
 
--   toolchain upgrade
+-   this section will be filled in in due course
+
+Linux
+
+-   this section will be filled in in due course
+
+Documentation improvements
+
+-   this section will be filled in in due course
+
+Possibly Breaking Changes
 
--   FIXME
+-   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.
+
+Known Issues
+
+-   this section will be filled in in due course
+
+-   There are a couple of known WebRTC-related regressions/blockers:
+
+    -   webrtc: DTLS setup with Chrome is broken
+    -   webrtcbin: First keyframe is usually lost
 
 Contributors
 
--   FIXME
+-   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.18 branch
+Stable 1.20 branch
 
-After the 1.18.0 release there will be several 1.18.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.18.x bug-fix releases will be made from
-the git 1.18 branch, which will be a stable branch.
+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.
 
-1.18.0
+1.20.0
 
-1.18.0 has not been released yet.
+1.20.0 is scheduled to be released around October/November 2021.
 
-Known Issues
-
--   FIXME
+Schedule for 1.22
 
-Schedule for 1.20
+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.
 
-Our next major feature release will be 1.20, and 1.19 will be the
-unstable development version leading up to the stable 1.20 release. The
-development of 1.19/1.20 will happen in the git master branch.
+The plan for the 1.22 development cycle is yet to be confirmed.
 
-The plan for the 1.20 development cycle is yet to be confirmed.
-
-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.
+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 … (FIXME)
+contributions from …
 
 License: CC BY-SA 4.0