factories

class SynthDefFactory(channel_count=1, **kwargs)

Bases: supriya.system.SupriyaObject

A factory class for building SynthDefs with common signal flow structures.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 8b57dad7fc05126bb83671fedfe7e76d
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/1[0]
>>> synthdef = factory.build(iterations=4)
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 8bc96b58a52bebf76c1f5206d5ec376a
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   ExpRand.ir/4:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/5:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/2:
            decay_time: ExpRand.ir/4[0]
            delay_time: ExpRand.ir/5[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/1[0]
    -   ExpRand.ir/6:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/7:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/3:
            decay_time: ExpRand.ir/6[0]
            delay_time: ExpRand.ir/7[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/2[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/3[0]
>>> synthdef = factory.build(channel_count=2)
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 323128474420b5abb5be40da646d2d20
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[1]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/2:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   AllpassC.ar/3:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/1[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/2[0]
            source[1]: AllpassC.ar/3[0]
build(name=None, **kwargs)

Build the SynthDef.

with_channel_count(channel_count)

Return a new factory configured with channel_count.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with 4 channels:

>>> factory = factory.with_channel_count(4)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 2f1fa110743854c82a7bf87b4c692da2
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[1]
    -   AllpassC.ar/2:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[2]
    -   AllpassC.ar/3:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[3]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/4:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   AllpassC.ar/5:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/1[0]
    -   AllpassC.ar/6:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/2[0]
    -   AllpassC.ar/7:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/3[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/4[0]
            source[1]: AllpassC.ar/5[0]
            source[2]: AllpassC.ar/6[0]
            source[3]: AllpassC.ar/7[0]

Channel count can be overridden at build time:

>>> synthdef = factory.build(channel_count=3)
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 0cdff384d8e500d7ab0fb634be46492a
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[1]
    -   AllpassC.ar/2:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[2]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/3:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   AllpassC.ar/4:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/1[0]
    -   AllpassC.ar/5:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/2[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/3[0]
            source[1]: AllpassC.ar/4[0]
            source[2]: AllpassC.ar/5[0]
with_feedback_loop(block_function=None)

Return a new factory configured with a feedback loop.

Feedback block functions follow the same guidelines as other signal block functions.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with a basic feedback loop:

>>> factory = factory.with_feedback_loop()
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 6bbbeac53a3cf6df96ca1afd9af3fa95
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   LocalIn.ar:
            default[0]: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: In.ar[0]
            right: LocalIn.ar[0]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: BinaryOpUGen(ADDITION).ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/1[0]
    -   LocalOut.ar:
            source[0]: AllpassC.ar/1[0]

Configure the factory with a modulated feedback loop via a signal block function:

>>> def feedback_block(builder, source, state):
...     return source * supriya.ugens.SinOsc.kr(frequency=0.3)
... 
>>> factory = factory.with_feedback_loop(feedback_block)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: e8a51cf53dfa55e0add56de9d2c441f5
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   LocalIn.ar:
            default[0]: 0.0
    -   BinaryOpUGen(ADDITION).ar:
            left: In.ar[0]
            right: LocalIn.ar[0]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: BinaryOpUGen(ADDITION).ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/1[0]
    -   SinOsc.kr:
            frequency: 0.3
            phase: 0.0
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: AllpassC.ar/1[0]
            right: SinOsc.kr[0]
    -   LocalOut.ar:
            source[0]: BinaryOpUGen(MULTIPLICATION).ar[0]
with_gate(attack_time=0.02, release_time=0.02)

Return a new factory configured with a gate.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with a gate envelope and corresponding gate parameter:

>>> factory = factory.with_gate()
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 9ba01bdc4eefdb4e6e567332e74e2684
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   Control.kr: null
    -   Linen.kr:
            attack_time: 0.02
            done_action: 2.0
            gate: Control.kr[0:gate]
            release_time: 0.02
            sustain_level: 1.0
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: AllpassC.ar/1[0]
            right: Linen.kr[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: BinaryOpUGen(MULTIPLICATION).ar[0]
with_initial_state(**state)

Return a new factory configured with an inital state comprised of key/value pairs.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with an initial state consisting of a single key/value pair which can be accessed in the previously configured signal block function:

>>> factory = factory.with_initial_state(iterations=4)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 8bc96b58a52bebf76c1f5206d5ec376a
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   ExpRand.ir/4:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/5:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/2:
            decay_time: ExpRand.ir/4[0]
            delay_time: ExpRand.ir/5[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/1[0]
    -   ExpRand.ir/6:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/7:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/3:
            decay_time: ExpRand.ir/6[0]
            delay_time: ExpRand.ir/7[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/2[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/3[0]
with_input(feedback=False, private=False, windowed=False)

Return a new factory configured with a bus input.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_signal_block(signal_block)
>>> factory = factory.with_output()

Configure the factory with a basic bus input:

>>> factory = factory.with_input()
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 8b57dad7fc05126bb83671fedfe7e76d
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/1[0]

Configure the factory with a private bus input:

>>> factory = factory.with_input(private=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 808f0f1b0185316fb2437bbe6d142f4e
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:in_]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[1:out]
            source[0]: AllpassC.ar/1[0]

Configure the factory with a windowed bus input:

>>> factory = factory.with_input(windowed=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 6c705751c4a7751b9bc68ff9e67706f0
    ugens:
    -   Control.ir: null
    -   Line.kr:
            done_action: 2.0
            duration: Control.ir[0:duration]
            start: 0.0
            stop: 1.0
    -   UnaryOpUGen(HANNING_WINDOW).kr:
            source: Line.kr[0]
    -   In.ar:
            bus: Control.ir[1:out]
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: In.ar[0]
            right: UnaryOpUGen(HANNING_WINDOW).kr[0]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: BinaryOpUGen(MULTIPLICATION).ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[1:out]
            source[0]: AllpassC.ar/1[0]

A factory configured with both a windowed bus input and output will re-use the windowing signal:

>>> factory = factory.with_input(windowed=True)
>>> factory = factory.with_output(windowed=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: f48b4d830ee617727b680aaa7bbdd130
    ugens:
    -   Control.ir: null
    -   Line.kr:
            done_action: 2.0
            duration: Control.ir[0:duration]
            start: 0.0
            stop: 1.0
    -   UnaryOpUGen(HANNING_WINDOW).kr:
            source: Line.kr[0]
    -   In.ar:
            bus: Control.ir[1:out]
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: In.ar[0]
            right: UnaryOpUGen(HANNING_WINDOW).kr[0]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: BinaryOpUGen(MULTIPLICATION).ar/0[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: AllpassC.ar/1[0]
            right: UnaryOpUGen(HANNING_WINDOW).kr[0]
    -   Out.ar:
            bus: Control.ir[1:out]
            source[0]: BinaryOpUGen(MULTIPLICATION).ar/1[0]
with_output(crossfaded=False, leveled=False, replacing=False, windowed=False)

Return a new factory configured with a bus output.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with a basic bus output:

>>> factory = factory.with_output()
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 8b57dad7fc05126bb83671fedfe7e76d
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/1[0]

Configure the factory with a windowed bus output:

>>> factory = factory.with_output(windowed=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 979c1d667e70e82b8f67e46b15e765bd
    ugens:
    -   Control.ir: null
    -   Line.kr:
            done_action: 2.0
            duration: Control.ir[0:duration]
            start: 0.0
            stop: 1.0
    -   UnaryOpUGen(HANNING_WINDOW).kr:
            source: Line.kr[0]
    -   In.ar:
            bus: Control.ir[1:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: AllpassC.ar/1[0]
            right: UnaryOpUGen(HANNING_WINDOW).kr[0]
    -   Out.ar:
            bus: Control.ir[1:out]
            source[0]: BinaryOpUGen(MULTIPLICATION).ar[0]

Configure the factory with a mix-able bus output:

>>> factory = factory.with_output(crossfaded=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 0f4316d360cde45a58bb303706a98f7b
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   Control.kr: null
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   XOut.ar:
            bus: Control.ir[0:out]
            crossfade: Control.kr[0:mix]
            source[0]: AllpassC.ar/1[0]

Configure the factory with a basic bus output preceded by an amplitude level control:

>>> factory = factory.with_output(leveled=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 2386a4cef636d99392822c4841e78b43
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   Control.kr: null
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: AllpassC.ar/1[0]
            right: Control.kr[0:level]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: BinaryOpUGen(MULTIPLICATION).ar[0]

A factory configured with a crossfaded and windowed bus output will use the windowing signal to control the mix:

>>> factory = factory.with_output(
...     crossfaded=True,
...     windowed=True,
... )
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: fbe87bfdce229ac82c0eb5bb214fddbd
    ugens:
    -   Control.ir: null
    -   Line.kr:
            done_action: 2.0
            duration: Control.ir[0:duration]
            start: 0.0
            stop: 1.0
    -   UnaryOpUGen(HANNING_WINDOW).kr:
            source: Line.kr[0]
    -   In.ar:
            bus: Control.ir[1:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   XOut.ar:
            bus: Control.ir[1:out]
            crossfade: UnaryOpUGen(HANNING_WINDOW).kr[0]
            source[0]: AllpassC.ar/1[0]

A level-control can be combined with the windowing and crossfading:

>>> factory = factory.with_output(
...     crossfaded=True,
...     leveled=True,
...     windowed=True,
... )
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 4fbbd5cd7aa5d848a303c8b59008a9da
    ugens:
    -   Control.ir: null
    -   Line.kr:
            done_action: 2.0
            duration: Control.ir[0:duration]
            start: 0.0
            stop: 1.0
    -   UnaryOpUGen(HANNING_WINDOW).kr:
            source: Line.kr[0]
    -   In.ar:
            bus: Control.ir[1:out]
    -   Control.kr: null
    -   BinaryOpUGen(MULTIPLICATION).kr:
            left: UnaryOpUGen(HANNING_WINDOW).kr[0]
            right: Control.kr[0:level]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   XOut.ar:
            bus: Control.ir[1:out]
            crossfade: BinaryOpUGen(MULTIPLICATION).kr[0]
            source[0]: AllpassC.ar/1[0]

A factory configured with both a windowed bus input and output will re-use the windowing signal:

>>> factory = factory.with_input(windowed=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: fa5c6ce33947883c713aeba0830cd7e3
    ugens:
    -   Control.ir: null
    -   Line.kr:
            done_action: 2.0
            duration: Control.ir[0:duration]
            start: 0.0
            stop: 1.0
    -   UnaryOpUGen(HANNING_WINDOW).kr:
            source: Line.kr[0]
    -   In.ar:
            bus: Control.ir[1:out]
    -   BinaryOpUGen(MULTIPLICATION).ar:
            left: In.ar[0]
            right: UnaryOpUGen(HANNING_WINDOW).kr[0]
    -   Control.kr: null
    -   BinaryOpUGen(MULTIPLICATION).kr:
            left: UnaryOpUGen(HANNING_WINDOW).kr[0]
            right: Control.kr[0:level]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: BinaryOpUGen(MULTIPLICATION).ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   XOut.ar:
            bus: Control.ir[1:out]
            crossfade: BinaryOpUGen(MULTIPLICATION).kr[0]
            source[0]: AllpassC.ar/1[0]
with_parameter(name, value, rate=None)
with_parameter_block(block_function)

Return a new factory configured with a parameter block function.

Use parameter block functions to build repetitive sets of SynthDef parameters, e.g. each set of band parameters for a multi-band compressor.

Parameter block functions take two parameters:

builder

the SynthDef builder instance

state

a dictionary of arbitrary key/value pairs for parameterizing the signal and parameter block functions

The return values of parameter block functions are ignored.

A factory configured to build multi-band compressor SynthDefs, using frequency bands split at frequencies:

>>> def parameter_block(builder, state):
...     frequencies = state["frequencies"]
...     band_count = len(frequencies) + 1
...     for i in range(band_count):
...         band_name = "band_{}_".format(i + 1)
...         builder._add_parameter(band_name + "pregain", 0)
...         builder._add_parameter(band_name + "clamp_time", 0.01)
...         builder._add_parameter(band_name + "relax_time", 0.1)
...         builder._add_parameter(band_name + "threshold", -6)
...         builder._add_parameter(band_name + "slope_above", 0.5)
...         builder._add_parameter(band_name + "slope_below", 1.0)
...         builder._add_parameter(band_name + "postgain", 0)
... 
>>> def signal_block(builder, source, state):
...     bands = []
...     frequencies = state["frequencies"]
...     for frequency in frequencies:
...         band = supriya.ugens.LPF.ar(source=source, frequency=frequency)
...         bands.append(band)
...         source -= band
...     bands.append(source)
...     compressors = []
...     for i, band in enumerate(bands):
...         band_name = "band_{}_".format(i + 1)
...         band *= builder[band_name + "pregain"].db_to_amplitude()
...         band = supriya.ugens.CompanderD.ar(
...             source=band,
...             clamp_time=builder[band_name + "clamp_time"],
...             relax_time=builder[band_name + "relax_time"],
...             slope_above=builder[band_name + "slope_above"],
...             slope_below=builder[band_name + "slope_below"],
...             threshold=builder[band_name + "threshold"].db_to_amplitude(),
...         )
...         band *= builder[band_name + "postgain"].db_to_amplitude()
...         compressors.extend(band)
...     source = supriya.ugens.Mix.multichannel(
...         compressors,
...         state["channel_count"],
...     )
...     return source
... 
>>> factory = supriya.synthdefs.SynthDefFactory()
>>> factory = factory.with_initial_state(frequencies=(300, 1200, 9600))
>>> factory = factory.with_parameter_block(parameter_block)
>>> factory = factory.with_input()
>>> factory = factory.with_signal_block(signal_block)
>>> factory = factory.with_output(crossfaded=True)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 82b358a0174b4f066dda19084d45aa96
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   LPF.ar/0:
            frequency: 300.0
            source: In.ar[0]
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: In.ar[0]
            right: LPF.ar/0[0]
    -   LPF.ar/1:
            frequency: 1200.0
            source: BinaryOpUGen(SUBTRACTION).ar/0[0]
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: BinaryOpUGen(SUBTRACTION).ar/0[0]
            right: LPF.ar/1[0]
    -   LPF.ar/2:
            frequency: 9600.0
            source: BinaryOpUGen(SUBTRACTION).ar/1[0]
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: BinaryOpUGen(SUBTRACTION).ar/1[0]
            right: LPF.ar/2[0]
    -   Control.kr: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/0:
            source: Control.kr[2:band_1_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: LPF.ar/0[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/0[0]
    -   DelayN.ar/0:
            delay_time: Control.kr[0:band_1_clamp_time]
            maximum_delay_time: Control.kr[0:band_1_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/0[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/1:
            source: Control.kr[6:band_1_threshold]
    -   Compander.ar/0:
            clamp_time: Control.kr[0:band_1_clamp_time]
            control: DelayN.ar/0[0]
            relax_time: Control.kr[3:band_1_relax_time]
            slope_above: Control.kr[4:band_1_slope_above]
            slope_below: Control.kr[5:band_1_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/0[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/1[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/2:
            source: Control.kr[1:band_1_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: Compander.ar/0[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/2[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/3:
            source: Control.kr[9:band_2_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: LPF.ar/1[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/3[0]
    -   DelayN.ar/1:
            delay_time: Control.kr[7:band_2_clamp_time]
            maximum_delay_time: Control.kr[7:band_2_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/2[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/4:
            source: Control.kr[13:band_2_threshold]
    -   Compander.ar/1:
            clamp_time: Control.kr[7:band_2_clamp_time]
            control: DelayN.ar/1[0]
            relax_time: Control.kr[10:band_2_relax_time]
            slope_above: Control.kr[11:band_2_slope_above]
            slope_below: Control.kr[12:band_2_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/2[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/4[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/5:
            source: Control.kr[8:band_2_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/3:
            left: Compander.ar/1[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/5[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/6:
            source: Control.kr[16:band_3_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/4:
            left: LPF.ar/2[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/6[0]
    -   DelayN.ar/2:
            delay_time: Control.kr[14:band_3_clamp_time]
            maximum_delay_time: Control.kr[14:band_3_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/4[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/7:
            source: Control.kr[20:band_3_threshold]
    -   Compander.ar/2:
            clamp_time: Control.kr[14:band_3_clamp_time]
            control: DelayN.ar/2[0]
            relax_time: Control.kr[17:band_3_relax_time]
            slope_above: Control.kr[18:band_3_slope_above]
            slope_below: Control.kr[19:band_3_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/4[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/7[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/8:
            source: Control.kr[15:band_3_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/5:
            left: Compander.ar/2[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/8[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/9:
            source: Control.kr[23:band_4_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/6:
            left: BinaryOpUGen(SUBTRACTION).ar/2[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/9[0]
    -   DelayN.ar/3:
            delay_time: Control.kr[21:band_4_clamp_time]
            maximum_delay_time: Control.kr[21:band_4_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/6[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/10:
            source: Control.kr[27:band_4_threshold]
    -   Compander.ar/3:
            clamp_time: Control.kr[21:band_4_clamp_time]
            control: DelayN.ar/3[0]
            relax_time: Control.kr[24:band_4_relax_time]
            slope_above: Control.kr[25:band_4_slope_above]
            slope_below: Control.kr[26:band_4_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/6[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/10[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/11:
            source: Control.kr[22:band_4_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/7:
            left: Compander.ar/3[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/11[0]
    -   Sum4.ar:
            input_four: BinaryOpUGen(MULTIPLICATION).ar/7[0]
            input_one: BinaryOpUGen(MULTIPLICATION).ar/1[0]
            input_three: BinaryOpUGen(MULTIPLICATION).ar/5[0]
            input_two: BinaryOpUGen(MULTIPLICATION).ar/3[0]
    -   XOut.ar:
            bus: Control.ir[0:out]
            crossfade: Control.kr[28:mix]
            source[0]: Sum4.ar[0]

The above factory can be parameterized to use smaller or larger numbers of bands during the build stage:

>>> frequencies = (150, 300, 600, 1200, 2400, 4800, 9600)
>>> synthdef = factory.build(frequencies=frequencies)
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 29967b92ffaf0917994906c739193e0b
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   LPF.ar/0:
            frequency: 150.0
            source: In.ar[0]
    -   BinaryOpUGen(SUBTRACTION).ar/0:
            left: In.ar[0]
            right: LPF.ar/0[0]
    -   LPF.ar/1:
            frequency: 300.0
            source: BinaryOpUGen(SUBTRACTION).ar/0[0]
    -   BinaryOpUGen(SUBTRACTION).ar/1:
            left: BinaryOpUGen(SUBTRACTION).ar/0[0]
            right: LPF.ar/1[0]
    -   LPF.ar/2:
            frequency: 600.0
            source: BinaryOpUGen(SUBTRACTION).ar/1[0]
    -   BinaryOpUGen(SUBTRACTION).ar/2:
            left: BinaryOpUGen(SUBTRACTION).ar/1[0]
            right: LPF.ar/2[0]
    -   LPF.ar/3:
            frequency: 1200.0
            source: BinaryOpUGen(SUBTRACTION).ar/2[0]
    -   BinaryOpUGen(SUBTRACTION).ar/3:
            left: BinaryOpUGen(SUBTRACTION).ar/2[0]
            right: LPF.ar/3[0]
    -   LPF.ar/4:
            frequency: 2400.0
            source: BinaryOpUGen(SUBTRACTION).ar/3[0]
    -   BinaryOpUGen(SUBTRACTION).ar/4:
            left: BinaryOpUGen(SUBTRACTION).ar/3[0]
            right: LPF.ar/4[0]
    -   LPF.ar/5:
            frequency: 4800.0
            source: BinaryOpUGen(SUBTRACTION).ar/4[0]
    -   BinaryOpUGen(SUBTRACTION).ar/5:
            left: BinaryOpUGen(SUBTRACTION).ar/4[0]
            right: LPF.ar/5[0]
    -   LPF.ar/6:
            frequency: 9600.0
            source: BinaryOpUGen(SUBTRACTION).ar/5[0]
    -   BinaryOpUGen(SUBTRACTION).ar/6:
            left: BinaryOpUGen(SUBTRACTION).ar/5[0]
            right: LPF.ar/6[0]
    -   Control.kr: null
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/0:
            source: Control.kr[2:band_1_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: LPF.ar/0[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/0[0]
    -   DelayN.ar/0:
            delay_time: Control.kr[0:band_1_clamp_time]
            maximum_delay_time: Control.kr[0:band_1_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/0[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/1:
            source: Control.kr[6:band_1_threshold]
    -   Compander.ar/0:
            clamp_time: Control.kr[0:band_1_clamp_time]
            control: DelayN.ar/0[0]
            relax_time: Control.kr[3:band_1_relax_time]
            slope_above: Control.kr[4:band_1_slope_above]
            slope_below: Control.kr[5:band_1_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/0[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/1[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/2:
            source: Control.kr[1:band_1_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: Compander.ar/0[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/2[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/3:
            source: Control.kr[9:band_2_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/2:
            left: LPF.ar/1[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/3[0]
    -   DelayN.ar/1:
            delay_time: Control.kr[7:band_2_clamp_time]
            maximum_delay_time: Control.kr[7:band_2_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/2[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/4:
            source: Control.kr[13:band_2_threshold]
    -   Compander.ar/1:
            clamp_time: Control.kr[7:band_2_clamp_time]
            control: DelayN.ar/1[0]
            relax_time: Control.kr[10:band_2_relax_time]
            slope_above: Control.kr[11:band_2_slope_above]
            slope_below: Control.kr[12:band_2_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/2[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/4[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/5:
            source: Control.kr[8:band_2_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/3:
            left: Compander.ar/1[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/5[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/6:
            source: Control.kr[16:band_3_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/4:
            left: LPF.ar/2[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/6[0]
    -   DelayN.ar/2:
            delay_time: Control.kr[14:band_3_clamp_time]
            maximum_delay_time: Control.kr[14:band_3_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/4[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/7:
            source: Control.kr[20:band_3_threshold]
    -   Compander.ar/2:
            clamp_time: Control.kr[14:band_3_clamp_time]
            control: DelayN.ar/2[0]
            relax_time: Control.kr[17:band_3_relax_time]
            slope_above: Control.kr[18:band_3_slope_above]
            slope_below: Control.kr[19:band_3_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/4[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/7[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/8:
            source: Control.kr[15:band_3_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/5:
            left: Compander.ar/2[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/8[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/9:
            source: Control.kr[23:band_4_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/6:
            left: LPF.ar/3[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/9[0]
    -   DelayN.ar/3:
            delay_time: Control.kr[21:band_4_clamp_time]
            maximum_delay_time: Control.kr[21:band_4_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/6[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/10:
            source: Control.kr[27:band_4_threshold]
    -   Compander.ar/3:
            clamp_time: Control.kr[21:band_4_clamp_time]
            control: DelayN.ar/3[0]
            relax_time: Control.kr[24:band_4_relax_time]
            slope_above: Control.kr[25:band_4_slope_above]
            slope_below: Control.kr[26:band_4_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/6[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/10[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/11:
            source: Control.kr[22:band_4_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/7:
            left: Compander.ar/3[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/11[0]
    -   Sum4.ar/0:
            input_four: BinaryOpUGen(MULTIPLICATION).ar/7[0]
            input_one: BinaryOpUGen(MULTIPLICATION).ar/1[0]
            input_three: BinaryOpUGen(MULTIPLICATION).ar/5[0]
            input_two: BinaryOpUGen(MULTIPLICATION).ar/3[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/12:
            source: Control.kr[30:band_5_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/8:
            left: LPF.ar/4[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/12[0]
    -   DelayN.ar/4:
            delay_time: Control.kr[28:band_5_clamp_time]
            maximum_delay_time: Control.kr[28:band_5_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/8[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/13:
            source: Control.kr[34:band_5_threshold]
    -   Compander.ar/4:
            clamp_time: Control.kr[28:band_5_clamp_time]
            control: DelayN.ar/4[0]
            relax_time: Control.kr[31:band_5_relax_time]
            slope_above: Control.kr[32:band_5_slope_above]
            slope_below: Control.kr[33:band_5_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/8[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/13[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/14:
            source: Control.kr[29:band_5_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/9:
            left: Compander.ar/4[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/14[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/15:
            source: Control.kr[37:band_6_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/10:
            left: LPF.ar/5[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/15[0]
    -   DelayN.ar/5:
            delay_time: Control.kr[35:band_6_clamp_time]
            maximum_delay_time: Control.kr[35:band_6_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/10[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/16:
            source: Control.kr[41:band_6_threshold]
    -   Compander.ar/5:
            clamp_time: Control.kr[35:band_6_clamp_time]
            control: DelayN.ar/5[0]
            relax_time: Control.kr[38:band_6_relax_time]
            slope_above: Control.kr[39:band_6_slope_above]
            slope_below: Control.kr[40:band_6_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/10[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/16[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/17:
            source: Control.kr[36:band_6_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/11:
            left: Compander.ar/5[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/17[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/18:
            source: Control.kr[44:band_7_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/12:
            left: LPF.ar/6[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/18[0]
    -   DelayN.ar/6:
            delay_time: Control.kr[42:band_7_clamp_time]
            maximum_delay_time: Control.kr[42:band_7_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/12[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/19:
            source: Control.kr[48:band_7_threshold]
    -   Compander.ar/6:
            clamp_time: Control.kr[42:band_7_clamp_time]
            control: DelayN.ar/6[0]
            relax_time: Control.kr[45:band_7_relax_time]
            slope_above: Control.kr[46:band_7_slope_above]
            slope_below: Control.kr[47:band_7_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/12[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/19[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/20:
            source: Control.kr[43:band_7_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/13:
            left: Compander.ar/6[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/20[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/21:
            source: Control.kr[51:band_8_pregain]
    -   BinaryOpUGen(MULTIPLICATION).ar/14:
            left: BinaryOpUGen(SUBTRACTION).ar/6[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/21[0]
    -   DelayN.ar/7:
            delay_time: Control.kr[49:band_8_clamp_time]
            maximum_delay_time: Control.kr[49:band_8_clamp_time]
            source: BinaryOpUGen(MULTIPLICATION).ar/14[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/22:
            source: Control.kr[55:band_8_threshold]
    -   Compander.ar/7:
            clamp_time: Control.kr[49:band_8_clamp_time]
            control: DelayN.ar/7[0]
            relax_time: Control.kr[52:band_8_relax_time]
            slope_above: Control.kr[53:band_8_slope_above]
            slope_below: Control.kr[54:band_8_slope_below]
            source: BinaryOpUGen(MULTIPLICATION).ar/14[0]
            threshold: UnaryOpUGen(DB_TO_AMPLITUDE).kr/22[0]
    -   UnaryOpUGen(DB_TO_AMPLITUDE).kr/23:
            source: Control.kr[50:band_8_postgain]
    -   BinaryOpUGen(MULTIPLICATION).ar/15:
            left: Compander.ar/7[0]
            right: UnaryOpUGen(DB_TO_AMPLITUDE).kr/23[0]
    -   Sum4.ar/1:
            input_four: BinaryOpUGen(MULTIPLICATION).ar/15[0]
            input_one: BinaryOpUGen(MULTIPLICATION).ar/9[0]
            input_three: BinaryOpUGen(MULTIPLICATION).ar/13[0]
            input_two: BinaryOpUGen(MULTIPLICATION).ar/11[0]
    -   BinaryOpUGen(ADDITION).ar:
            left: Sum4.ar/0[0]
            right: Sum4.ar/1[0]
    -   XOut.ar:
            bus: Control.ir[0:out]
            crossfade: Control.kr[56:mix]
            source[0]: BinaryOpUGen(ADDITION).ar[0]
with_parameters(**kwargs)
with_rand_id(rand_id=0)

Return a new factory configured with a random number generator ID.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with a random number generator ID, defaulting to 23:

>>> factory = factory.with_rand_id(rand_id=23)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: c29dcbe7455de10f65eac155b812021d
    ugens:
    -   Control.ir: null
    -   RandID.ir:
            rand_id: Control.ir[1:rand_id]
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/1[0]
with_signal_block(block_function)

Return a new factory configured with an additional signal block function.

Signal block functions take three parameters:

builder

the SynthDef builder instance

source

a UGenMethodMixin representing the signal flow

state

a dictionary of arbitrary key/value pairs for parameterizing the signal and parameter block functions

Signal block functions should return a UGenMethodMixin.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with an additional signal block:

>>> def signal_block_post(builder, source, state):
...     source = supriya.ugens.LeakDC.ar(source=source)
...     source = supriya.ugens.Limiter.ar(
...         duration=supriya.ugens.Rand.ir(0.005, 0.015),
...         source=source,
...     )
...     return source
... 
>>> factory = factory.with_signal_block(signal_block_post)
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 598ec4adfcfa0518ae5638a75c43087e
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   LeakDC.ar:
            coefficient: 0.995
            source: AllpassC.ar/1[0]
    -   Rand.ir:
            maximum: 0.015
            minimum: 0.005
    -   Limiter.ar:
            duration: Rand.ir[0]
            level: 1.0
            source: LeakDC.ar[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: Limiter.ar[0]
with_silence_detection()

Return a new factory configured with silence detection.

>>> factory = supriya.synthdefs.SynthDefFactory()
>>> def signal_block(builder, source, state):
...     iterations = state.get("iterations") or 2
...     for _ in range(iterations):
...         source = supriya.ugens.AllpassC.ar(
...             decay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             delay_time=supriya.ugens.ExpRand.ir(0.01, 0.1),
...             source=source,
...             maximum_delay_time=0.1,
...         )
...     return source
... 
>>> factory = factory.with_input()
>>> factory = factory.with_output()
>>> factory = factory.with_signal_block(signal_block)

Configure the factory with silence detection.

>>> factory = factory.with_silence_detection()
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 9ffc96952d8a081f877924018f36d463
    ugens:
    -   Control.ir: null
    -   In.ar:
            bus: Control.ir[0:out]
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   Out.ar:
            bus: Control.ir[0:out]
            source[0]: AllpassC.ar/1[0]
    -   DetectSilence.kr:
            done_action: 2.0
            source: AllpassC.ar/1[0]
            threshold: 0.0001
            time: 0.1

Silence detection is applied before any output leveling or windowing.

>>> factory = factory.with_output(
...     leveled=True,
...     windowed=True,
... )
>>> synthdef = factory.build()
>>> supriya.graph(synthdef)  
>>> print(synthdef)
synthdef:
    name: 6b830f9f0f6049ef52d3fdb8fd2f231e
    ugens:
    -   Control.ir: null
    -   Line.kr:
            done_action: 2.0
            duration: Control.ir[0:duration]
            start: 0.0
            stop: 1.0
    -   UnaryOpUGen(HANNING_WINDOW).kr:
            source: Line.kr[0]
    -   In.ar:
            bus: Control.ir[1:out]
    -   Control.kr: null
    -   ExpRand.ir/0:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/1:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/0:
            decay_time: ExpRand.ir/0[0]
            delay_time: ExpRand.ir/1[0]
            maximum_delay_time: 0.1
            source: In.ar[0]
    -   ExpRand.ir/2:
            maximum: 0.1
            minimum: 0.01
    -   ExpRand.ir/3:
            maximum: 0.1
            minimum: 0.01
    -   AllpassC.ar/1:
            decay_time: ExpRand.ir/2[0]
            delay_time: ExpRand.ir/3[0]
            maximum_delay_time: 0.1
            source: AllpassC.ar/0[0]
    -   BinaryOpUGen(MULTIPLICATION).ar/0:
            left: AllpassC.ar/1[0]
            right: Control.kr[0:level]
    -   BinaryOpUGen(MULTIPLICATION).ar/1:
            left: BinaryOpUGen(MULTIPLICATION).ar/0[0]
            right: UnaryOpUGen(HANNING_WINDOW).kr[0]
    -   Out.ar:
            bus: Control.ir[1:out]
            source[0]: BinaryOpUGen(MULTIPLICATION).ar/1[0]
    -   DetectSilence.kr:
            done_action: 2.0
            source: AllpassC.ar/1[0]
            threshold: 0.0001
            time: 0.1