Files
soundobjects_blender_addon/README.md
2020-10-03 12:02:35 -07:00

37 lines
1.6 KiB
Markdown

# soundobjects Blender Add-On
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.
https://vimeo.com/464569386
[blender]: https://www.blender.org
[atmos]: https://www.dolby.com/technologies/dolby-atmos/
## 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.