dynamics¶

class Amplitude(*, calculation_rate: CalculationRate | SupportsInt | str | None, source: SupportsFloat | UGenScalar, attack_time: SupportsFloat | UGenScalar = 0.01, release_time: SupportsFloat | UGenScalar = 0.01, **kwargs)¶

Bases: UGen

An amplitude follower.

>>> source = supriya.ugens.In.ar(bus=0)
>>> amplitude = supriya.ugens.Amplitude.kr(
...     attack_time=0.01,
...     release_time=0.01,
...     source=source,
... )
>>> amplitude
<Amplitude.kr()[0]>

classmethod ar(*, source: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]], attack_time: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.01, release_time: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.01) → UGenOperable¶

classmethod kr(*, source: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]], attack_time: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.01, release_time: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.01) → UGenOperable¶

property attack_time : UGenScalar¶

property release_time : UGenScalar¶

property source : UGenScalar¶

class Compander(*, calculation_rate: CalculationRate | SupportsInt | str | None, source: SupportsFloat | UGenScalar, control: SupportsFloat | UGenScalar = 0.0, threshold: SupportsFloat | UGenScalar = 0.5, slope_below: SupportsFloat | UGenScalar = 1.0, slope_above: SupportsFloat | UGenScalar = 1.0, clamp_time: SupportsFloat | UGenScalar = 0.01, relax_time: SupportsFloat | UGenScalar = 0.1, **kwargs)¶

Bases: UGen

A general purpose hard-knee dynamics processor.

classmethod ar(*, source: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]], control: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.0, threshold: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.5, slope_below: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 1.0, slope_above: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 1.0, clamp_time: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.01, relax_time: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.1) → UGenOperable¶

property clamp_time : UGenScalar¶

property control : UGenScalar¶

property relax_time : UGenScalar¶

property slope_above : UGenScalar¶

property slope_below : UGenScalar¶

property source : UGenScalar¶

property threshold : UGenScalar¶

class CompanderD¶

Bases: PseudoUGen

A convenience constructor for Compander.

classmethod ar(source=None, threshold=0.5, clamp_time=0.01, relax_time=0.1, slope_above=1.0, slope_below=1.0)¶

Constructs an audio-rate dynamics processor.

>>> source = supriya.ugens.In.ar(bus=0)
>>> compander_d = supriya.ugens.CompanderD.ar(
...     source=source,
... )
>>> supriya.graph(compander_d)

>>> print(compander_d)
synthdef:
    name: ...
    ugens:
    -   In.ar:
            bus: 0.0
    -   DelayN.ar:
            source: In.ar[0]
            maximum_delay_time: 0.01
            delay_time: 0.01
    -   Compander.ar:
            source: In.ar[0]
            control: DelayN.ar[0]
            threshold: 0.5
            slope_below: 1.0
            slope_above: 1.0
            clamp_time: 0.01
            relax_time: 0.1

Returns ugen graph.

class Limiter(*, calculation_rate: CalculationRate | SupportsInt | str | None, source: SupportsFloat | UGenScalar, level: SupportsFloat | UGenScalar = 1.0, duration: SupportsFloat | UGenScalar = 0.01, **kwargs)¶

Bases: UGen

A peak limiter.

>>> source = supriya.ugens.In.ar(bus=0)
>>> limiter = supriya.ugens.Limiter.ar(
...     duration=0.01,
...     level=1,
...     source=source,
... )
>>> limiter
<Limiter.ar()[0]>

classmethod ar(*, source: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]], level: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 1.0, duration: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.01) → UGenOperable¶

property duration : UGenScalar¶

property level : UGenScalar¶

property source : UGenScalar¶

class Normalizer(*, calculation_rate: CalculationRate | SupportsInt | str | None, source: SupportsFloat | UGenScalar, level: SupportsFloat | UGenScalar = 1.0, duration: SupportsFloat | UGenScalar = 0.01, **kwargs)¶

Bases: UGen

A dynamics flattener.

>>> source = supriya.ugens.In.ar(bus=0)
>>> normalizer = supriya.ugens.Normalizer.ar(
...     duration=0.01,
...     level=1,
...     source=source,
... )
>>> normalizer
<Normalizer.ar()[0]>

classmethod ar(*, source: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]], level: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 1.0, duration: SupportsFloat | UGenOperable | UGenSerializable | Sequence[SupportsFloat | UGenOperable | UGenSerializable | Sequence[UGenRecursiveInput]] = 0.01) → UGenOperable¶

property duration : UGenScalar¶

property level : UGenScalar¶

property source : UGenScalar¶