From 08ad33e27d57f279126a2f65b304a5d3d1ffddff Mon Sep 17 00:00:00 2001 From: Jamie Hardt Date: Wed, 5 Nov 2025 20:31:07 -0800 Subject: [PATCH] More modernizations --- README.md | 42 +++++++++++++++--------- requirements.txt => requirements_dev.txt | 0 2 files changed, 26 insertions(+), 16 deletions(-) rename requirements.txt => requirements_dev.txt (100%) diff --git a/README.md b/README.md index 9d3f69e..35c343b 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,16 @@ # soundobjects Blender Add-On -**NOTE**: _Avid made some changes to ADM file import in Pro Tools and it no longer accepts ADMs made by -this plugin. It may still work with other DAWs._ +**NOTE**: _Avid made some changes to ADM file import in Pro Tools and it no +longer accepts ADMs made by this plugin. It may still work with other DAWs._ -This add-on adds three operators for working with immersive 3D audio in [Blender][blender], specifically it allows you to create ADM Broadcast -WAVE files for use with [Dolby Atmos][atmos] or other object-based sound mixing workflows. +This add-on adds three operators for working with immersive 3D audio in +[Blender][blender], specifically it allows you to create ADM Broadcast WAVE +files for use with [Dolby Atmos][atmos] or other object-based sound mixing +workflows. -[Here](https://vimeo.com/464569386) you can see a short demo of how to add sounds to an animated Blender scene and import the resulting file -into Pro Tools and then play them into a Dolby DAPS Renderer. +[Here](https://vimeo.com/464569386) you can see a short demo of how to add +sounds to an animated Blender scene and import the resulting file into Pro +Tools and then play them into a Dolby DAPS Renderer. [blender]: https://www.blender.org [atmos]: https://www.dolby.com/technologies/dolby-atmos/ @@ -16,25 +19,32 @@ into Pro Tools and then play them into a Dolby DAPS Renderer. ### `import_test.wav_file_batch` -**Import WAV Files:** This operator allows you to add multiple audio files to a .blend file so they'll be available to -the *Add Sounds to Meshes* operator. +**Import WAV Files:** This operator allows you to add multiple audio files to a +.blend file so they'll be available to the *Add Sounds to Meshes* operator. ### `object.add_speakers_to_obj` -**Add Sounds to Meshes:** This operator takes all the selected objects in the current scene and attaches a new speaker -locked to that object's location throughout the animation. You provide the prefix for the name of a set of sound files -added with the _Import WAV Files_ operator, and these are added to each selected object randomly. The sounds can be -timed to either begin playing at the beginning of the sequence, at a random time, or when the respective object is +**Add Sounds to Meshes:** This operator takes all the selected objects in the +current scene and attaches a new speaker locked to that object's location +throughout the animation. You provide the prefix for the name of a set of sound +files +added with the _Import WAV Files_ operator, and these are added to each +selected object randomly. The sounds can be timed to either begin playing at +the beginning of the sequence, at a random time, or when the respective object +is closest to the scene's camera. ### `export.adm_wave_file` -**Export ADM Wave File:** This operator exports all of the speakers in a scene as an ADM Broadcast-WAV file compartible -with a Dolby Atmos rendering workflow. This produces a multichannel WAV file with embedded ADM metadata the passes -panning information to the client. (Has been tested and works with Avid Pro Tools 2020). +**Export ADM Wave File:** This operator exports all of the speakers in a scene +as an ADM Broadcast-WAV file compartible with a Dolby Atmos rendering workflow. +This produces a multichannel WAV file with embedded ADM metadata the passes +panning information to the client. (Has been tested and works with Avid Pro +Tools 2020). ## Requirements -This add-on requires that the [EBU Audio Renderer](https://github.com/ebu/ebu_adm_renderer) (`ear` v2.0) Python package +This add-on requires that the [EBU Audio +Renderer](https://github.com/ebu/ebu_adm_renderer) (`ear` v2.0) Python package be installed to Blender's Python. diff --git a/requirements.txt b/requirements_dev.txt similarity index 100% rename from requirements.txt rename to requirements_dev.txt