objects: allow overloading renderer for other formats

Author: tomjnixon

ear/core/objectbased/renderer.py

@@ -1,10 +1,12 @@
 import numpy as np
 import math
 from fractions import Fraction
+from functools import singledispatch
 from ..convolver import OverlapSaveConvolver, VariableBlockSizeAdapter
 from ..delay import Delay
 from .gain_calc import GainCalc
 from . import decorrelate
+from ..layout import Layout
 from ..renderer_common import BlockProcessingChannel, InterpretTimingMetadata, InterpGains, FixedGains
 from ..track_processor import TrackProcessor
 
@@ -148,3 +150,19 @@ def render(self, sample_rate, start_sample, input_samples):
         direct_out = self.delays.process(interpolated[:, :self._nchannels])
         diffuse_out = self.decorrelators_vbs.process(interpolated[:, self._nchannels:])
         return direct_out + diffuse_out
+
+
+@singledispatch
+def build_objects_renderer(_layout, **_options):
+    """build an objects renderer (e.g. ObjectRenderer) given a loudspeaker
+    layout or other output format; this can be overridden from other modules to
+    add support for different formats
+
+    returns None if no handler renderer is defined for this format
+    """
+    return None
+
+
+@build_objects_renderer.register(Layout)
+def _build_objects_renderer_speakers(layout, **options):
+    return ObjectRenderer(layout, **options)

ear/core/renderer.py

@@ -1,5 +1,5 @@
 import numpy as np
-from .objectbased.renderer import ObjectRenderer
+from .objectbased.renderer import build_objects_renderer
 from .direct_speakers.renderer import DirectSpeakersRenderer
 from .scenebased.renderer import HOARenderer
 from .metadata_input import ObjectRenderingItem, DirectSpeakersRenderingItem, HOARenderingItem
@@ -20,7 +20,7 @@ class Renderer(object):
     def __init__(self, layout, object_renderer_opts={}, direct_speakers_opts={}, hoa_renderer_opts={}):
         self.block_aligner = BlockAligner(layout.num_channels)
 
-        self._object_renderer = ObjectRenderer(layout, **object_renderer_opts)
+        self._object_renderer = build_objects_renderer(layout, **object_renderer_opts)
         self._direct_speakers_renderer = DirectSpeakersRenderer(layout, **direct_speakers_opts)
         self._hoa_renderer = HOARenderer(layout, **hoa_renderer_opts)