Files
soundobjects_blender_addon/README.md
2020-10-02 22:24:33 -07:00

31 lines
1.5 KiB
Markdown

# soundobjects Blender Add-On
This add-on adds three operators for working with immersive 3D audio, specifically it allows you to create ADM Boradcast
WAVE files for use with Dolby ATMOS or other object-based sound mixing workflows.
## Operators
### `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.
### `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
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).
## Important Note
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 installation.