Release 0.9.3

Author: Tomasz Andrzejak

COPYING

@@ -1,5 +1,5 @@
 Dolby Home Audio GStreamer Plugins
-Copyright (C) 2020-2021, Dolby Laboratories
+Copyright (C) 2020-2022, Dolby Laboratories
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public

README.md

@@ -8,7 +8,7 @@ GStreamer plugins collection for building Dolby Home Audio media pipeline.
 ## Dependencies
  - [Python](https://python.org) 3.5 or later
  - [Ninja](https://ninja-build.org) 1.7 or later
- - [Meson](https://mesonbuild.com/) 0.54 or later
+ - [Meson](https://mesonbuild.com/) 0.58 or later
  - [GStreamer](https://gstreamer.freedesktop.org/) 1.16.2 or later
  - more, see building section...
 
@@ -45,8 +45,8 @@ $ ninja -C build
 
 ### Windows
 Support for Windows is enabled via [MSYS2](https://www.msys2.org/). Follow
-instructions on [MSYS2 install page](https://www.msys2.org/). You should have
-the gcc toolchain on MSYS environment.
+instructions on [MSYS2 install page](https://www.msys2.org/#installation).
+You should have the gcc toolchain on MSYS environment.
 
 **Note:** *Run `MSYS2 MinGW 64-bit`.*
 
@@ -58,13 +58,14 @@ $ pacman -S mingw-w64-x86_64-meson mingw-w64-x86_64-ninja
 Install the GStreamer dependencies (required to build plugins):
 ```console
 $ pacman -S mingw-w64-x86_64-gstreamer mingw-w64-x86_64-gst-plugins-base \
-    mingw-w64-x86_64-json-glib mingw-w64-x86_64-gst-python
+    mingw-w64-x86_64-gst-plugins-good mingw-w64-x86_64-json-glib \
+    mingw-w64-x86_64-gst-python
 ```
 
 Install some useful plugins (optional)
 ```console
-$ pacman -S mingw-w64-x86_64-gst-plugins-good mingw-w64-x86_64-gst-plugins-bad \
-    mingw-w64-x86_64-gst-plugins-ugly mingw-w64-x86_64-gst-libav
+$ pacman -S mingw-w64-x86_64-gst-plugins-bad mingw-w64-x86_64-gst-plugins-ugly \
+    mingw-w64-x86_64-gst-libav
 ```
 
 Build and install
@@ -91,7 +92,8 @@ $ ninja -C build
 
 ## Building from source
 GStreamer and the plugins can be built from source by using
-[gst-build](https://gitlab.freedesktop.org/gstreamer/gst-build).
+[gst-build](https://gitlab.freedesktop.org/gstreamer/gst-build), or starting
+from GStreamer 1.20, [GStreamer mono repo](https://gitlab.freedesktop.org/gstreamer/gstreamer).
 
 Install `meson` and `ninja` as instructed in the [Linux](#linux) and
 [Windows](#windows) sections above.
@@ -180,13 +182,33 @@ configuration files: a stream configuration file, and a device configuration
 file.
 **Note:** *The configuration files are generated by a propietary tool.*
 
-To decode a bitstream, type
+To decode a bitstream, type:
 ```console
 $ ./gst-ha-flexr -i input.ec3 -s stream.conf -d device.dconf -o output.wav
 ```
+#### Playback
+Playback is supported on Windows, Linux and macOS. Note that 48kHz output is required, and macOS supports playback up to eight channels only.
+
+**Note:** *This feature is mutually exclusive with decoding to file.*
+
+To decode and play a bitstream, type:
+```console
+$ ./gst-ha-flexr -i input.ec3 -s stream.conf -d device.dconf -p
+```
+First the command invokes the device selection menu to allow a user to choose a target device.
+**Note:** *Device selection menu is not available on macOS, audio will be played to default device.*
+
+To decode and play a bitstream directly on a device, type:
+```console
+$ ./gst-ha-flexr -i input.ec3 -s stream.conf -d device.dconf -p <device id>
+```
+It will skip device selection menu and start playback immediately. Running `gst-device-monitor-1.0` will show all connected devices with their ids.\
+**On macOS, the feature is not supported.**
+
+**Note:** *On Linux, ensure that your device id is correct so that a pipeline does not get stuck*
 
 ### gst-ha-dap
-This integration binary wraps the following plugins:
+The integration binary wraps the following plugins:
 ```console
 filesrc ! dlbaudiodecbin ! dlbdap ! wavenc ! filesink
 ```

config.h.in

@@ -1,7 +1,7 @@
 /*******************************************************************************
 
  * Dolby Home Audio GStreamer Plugins
- * Copyright (C) 2020-2021, Dolby Laboratories
+ * Copyright (C) 2020-2022, Dolby Laboratories
 
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
@@ -33,26 +33,31 @@
 
 #mesondefine HAVE_WINAPI
 
+#mesondefine DLB_AUDIO_PARSER_LIBNAME
 #mesondefine DLB_AUDIO_PARSER_OPEN_DYNLIB
 #ifdef DLB_AUDIO_PARSER_OPEN_DYNLIB
 OPEN_DYNLIB_FUN(dlb_audio_parser)
 #endif
 
+#mesondefine DLB_FLEXR_LIBNAME
 #mesondefine DLB_FLEXR_OPEN_DYNLIB
 #ifdef DLB_FLEXR_OPEN_DYNLIB
 OPEN_DYNLIB_FUN(dlb_flexr)
 #endif
 
+#mesondefine DLB_DAP_LIBNAME
 #mesondefine DLB_DAP_OPEN_DYNLIB
 #ifdef DLB_DAP_OPEN_DYNLIB
 OPEN_DYNLIB_FUN(dlb_dap)
 #endif
 
+#mesondefine DLB_OAR_LIBNAME
 #mesondefine DLB_OAR_OPEN_DYNLIB
 #ifdef DLB_OAR_OPEN_DYNLIB
 OPEN_DYNLIB_FUN(dlb_oar)
 #endif
 
+#mesondefine DLB_UDC_LIBNAME
 #mesondefine DLB_UDC_OPEN_DYNLIB
 #ifdef DLB_UDC_OPEN_DYNLIB
 OPEN_DYNLIB_FUN(dlb_udc)

docker/Dockerfile

@@ -24,7 +24,9 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     gstreamer1.0-plugins-good \
     libgtest-dev \
     libjson-glib-dev \
-    ssh
+    ssh \
+    valgrind\
+    wget
 
 RUN pip3 install --no-cache-dir meson
 

integration/frontend-flexr.py

@@ -19,8 +19,7 @@ def main():
 
     settings = create_settings(args)
     run_pipeline(os.path.abspath(plugin_path),
-                 settings,
-                 args.pipeline_graph)
+                 settings)
 
 
 if __name__ == '__main__':

integration/gst_ha_dap/interface.py

@@ -11,7 +11,7 @@
 
 VERSION_MAJOR  = 0
 VERSION_MINOR  = 9
-VERSION_BUGFIX = 1
+VERSION_BUGFIX = 3
 
 PREAMBLE = """
 Dolby Atmos for home audio executable