Table of Contents

Source Editor: SoundSeed Grain Plug-in

The Source Editor displays all the properties associated with the SoundSeed Grain plug-in.

The first part of this page covers only the Effect Settings tab of the plug-in. Exceptionally for a plug-in, however, the SoundSeed Grain plug-in has two additional tabs which are covered in the Source Settings section below.

For a general overview of the SoundSeed Grain plug-in, refer to Wwise SoundSeed Grain.

Interface Element

Description

Name

The user-defined name given to this instance of the Wwise SoundSeed Grain plug-in.

Source Plug-in

The type of source plug-in.

Notes

Any additional information about the SoundSeed Grain plug-in.

Filename

The audio source file, WAV or AMB, to be used by the granular synthesizer. Click the browse button to the right of the field to choose the file.

Grains

Time between Emissions

Time between each grain emitted, in ms.

Select Freq/Time needs to be set to Time Between Emissions.

Default value: 1000
Range: 0.05 to 50000

Emissions per Second

Number of grains emitted per second.

Select Freq/Time needs to be set to Emissions per Second.

Default value: 1
Range: 0.02 to 20000
Units: Frequency

Duration Link

When Duration Multiplier is selected, grain duration is specified as a multiple of the time between emissions. When Duration is selected, grain duration is completely independent from the time between emissions. When MIDI Duration is selected, and if the synthesizer was spawned from a MIDI note, the note value overrides grain Duration. Modulating the Duration property will modulate MIDI Duration.

Default value: Duration Multiplier

Duration Multiplier

Grain duration, expressed as a multiplication factor of the emission rate (set using either Emissions per Second or Time Between Emissions). This control is only available when Duration Link is set to Duration Multiplier.

When set to 1, actual grain duration is equal to the time that elapses between each grain, with envelope release overlapping envelope attack, resulting in a continuous dovetailing of grains. When smaller than 1, gaps will exist between grains; when greater than 1, grains stack up.

Default value: 1
Range: 0.001 to 1000

Duration

Grain duration, in ms. This control is only available when Duration Link is set to Duration.

[Note] Note

The release portion of the grain envelope is not comprised in the grain duration, so grains may actually be longer.

Default value: 1000
Range: 0.02 to 10000.0

Amplitude

Amplitude of grains, in percent.

This control is useful when assigned with a modulator, in order to vary the relative level of grains.

[Note] Note

If the effective amplitude goes below zero, the perceived amplitude goes back up, but the signal is 180 degrees out of phase.

Default value: 100
Range: 0 to 100

Attack

Attack time of the grain envelope, in ms. When Window Mode is Release Same as Attack, the Release time is equal to Attack time.

The Attack envelope starts at the beginning of the grain and is therefore comprised in the grain’s duration, as opposed to the envelope’s release portion (Release), which starts at the end of the grain.

You may also change the Attack time using the upper-left handle in the grain visualizer window.

[Note] Note

If the Attack time is longer than the grain’s duration, the grain will not play at full volume but, instead, at the envelope level that was applied when the Attack was truncated.

Default value: 10
Range: 0 to 5000

Window Mode

When there's an independent Attack and Release, allows you to set different values for envelope Attack and Release times.

Default value: Release Same as Attack

Release

Release time of the grain envelope, in ms. Ignored when Window Mode is Release Same as Attack.

The release envelope starts at the end of the grain, and is therefore not comprised in the grain’s duration, as opposed to the envelope’s attack portion (Attack).

You may also change the release time using the lower-right handle in the Grain Visualizer window.

Default value: 10
Range: 0 to 5000

Grain Envelope Shape

Defines the shape of the Attack and Release segments of the grain envelope.

Choices available are:

  • Linear
  • Constant Power
  • Exponential
  • Raised Cosine

Default value: Linear

Playback

Position

Position in the source file from which grains are read. The position is expressed in percentage of the file’s duration.

If Snap to Markers is enabled and markers exist, the effective grain start position is that of the marker nearest to the position set with this control.

Default value: 0
Range: 0 to 100

Snap to Markers

If enabled, and markers are present, the chosen grain start position is that of the marker nearest to the position set with Position.

Default value: false

Offset%

Position in the source file from which grains are read. The position is expressed in percentage of the file’s duration.

This position offset is only considered if Snap to Markers is enabled and further offsets the grain start positions from the marker nearest to Position.

Default value: 0
Range: -100 to 100

Pitch

The pitch by which grains are transposed, in cents.

Values above 0 result in faster playback speeds, while values below 0 result in lower playback speeds.

The effective playback speed also depends on grain Speed.

Default value: 0
Range: -4800 to 4800
Units: Cents

Map MIDI to Grain Pitch

When set, and if the synthesizer was spawned from a MIDI note, the note value, relative to Root, adds to grain Pitch.

Default value: false

Root MIDI Note

Defines the root MIDI note in order to derive an offset to the Pitch from the input MIDI note value.

Default value: 60
Range: 0 to 127

Speed

Playback speed of grains.

  • With a speed of 1, grains play at the same speed as the original sound.
  • With speeds greater than 1, they play faster than the original sound, and thus at a higher pitch.
  • With speeds lower than 1, but positive, they play slower than the original sound, and thus at a lower pitch.
  • With negative speeds, they play backwards.

The effective speed at which grains play also depends on grain Pitch.

Default value: 1
Range: -4 to 4

Filter

Filter Type

Type of the filter applied on each grain.

  • LPF6: First-order (6 dB/octave) low-pass filter. With this filter, parameter Filter Q has no effect.
  • LPF12: Second-order (12 dB/octave) low-pass filter.
  • HPF6: First-order (6 dB/octave) high-pass filter. With this filter, parameter Filter Q has no effect.
  • HPF12: Second-order (12 dB/octave) high-pass filter.
  • BP: Second-order (6 dB/octave on each side) band-pass filter. With this filter, parameter Filter Q has no effect.

Default value: LPF12

Filter Cutoff

Cutoff (or center) frequency of the grain filter, in Hz.

Default value: 20000
Range: 20 to 20000
Units: Frequency

Filter Q

Quality factor of the grain filter. When this value is larger, the filter is more resonant at the filter cutoff frequency.

Filter Q only applies when Filter Type is set to LPF12, HPF12, or BP.

Default value: 0.707
Range: 0.1 to 100

Positioning

Channels

Defines whether grains should be spatialized onto the output channel configuration of the synthesizer, as defined by Output Config, or just assigned directly.

  • Direct Speaker Assignment: No spatialization or panning is applied. Mono files are routed to the center channel if the Output Config has a center channel, otherwise to the front left and front right channels. In general, the input channels are mapped to the same output channels and dropped when these channels are not present in the output configuration.
  • 3D Spatialization: Grains are 3D spatialized onto the synthesizer’s output configuration using Azimuth, Elevation, and Spread. Note that Output Config has to have multiple channels for spatialization to be useful.

Default value: Direct Speaker Assignment

Azimuth

Azimuth angle of grains’ spatial positioning, in degrees, with positive values to the right.

This control requires Channels to be set to 3D Spatialization, and only makes sense when the synthesizer’s Output Config is set to a multichannel configuration.

Default value: 0
Range: -180 to 180

Elevation

Elevation angle of grains’ spatial positioning, in degrees, with positive values to the top.

This control requires Channels to be set to 3D Spatialization, and only makes sense when the synthesizer’s Output Config is set to a multichannel configuration.

Default value: 0
Range: -90 to 90

Spread

Spread of grains used with spatial positioning, in percentage. This is the equivalent of Attenuation Spread in Wwise.

This control requires Channels to be set to 3D Spatialization and only makes sense when the synthesizer’s Output Config is set to a multichannel configuration.

Default value: 0
Range: 0 to 100

Output

Output Config

Channel configuration forced at the output of the synthesizer.

Using a multichannel output configuration is useful for creating 3D ambiences. To do so, set the positioning of the sound to 3D and set an attenuation ShareSet that uses spread at close distances. Design your synthesizer patch such that the output is maximally enveloping, by using 3D Spatialization and modulating Azimuth and, if applicable, Elevation. The channel configuration is visible in the Effect’s VU Meter during playback with Capture running.

[Note] Note

The synthesizer’s output signal is further panned or spatialized by Wwise, depending on the sound’s positioning settings.

[Note] Note

If changing the output configuration while playing, the new configuration will only be effective the next time the synthesizer is played.

Default value: Mono

Output Level

Level applied to the final signal.

Default value: 0
Range: -96 to 24
Units: dB

VU Meter

A per channel peak meter, which meters the signal at the output of the synthesizer, and its channel configuration matches that which is set in the Output group box. For more information about speaker configurations and channels, refer to Understanding Channel Configurations.

The signal level is green under -6 dB, yellow from -6 to 0 dB, and red over 0 dB.

Envelope Visualizer

The Envelope Visualizer offers a preview of the grain Envelopes' shapes and overlap. The amount of overlap depends on the emission rate, grain duration, and release. These values are before any RTPC or modulation is applied, so the actual outcome may be quite different.



[Note] Note

The following rows describe "Modulator 1" properties. They are, however, applicable to all four Modulator rows.

Grain Modulators (left pane)

Modulator 1 Waveform

Type of waveform of modulator 1.

The available waveform types are:

  • Sine: Bipolar sine wave
  • Triangle: Bipolar triangle wave
  • Square: Bipolar square wave
  • Saw up: Bipolar saw up wave
  • Saw down: Bipolar saw down wave
  • Random: Bipolar sine wave
  • Sine+: Unipolar sine wave
  • Triangle+: Unipolar triangle wave
  • Square+: Unipolar square wave
  • Saw up+: Unipolar saw up wave
  • Saw down+: Unipolar saw down wave
  • Random+: Unipolar sine wave

Default value: Random

Modulator 1 Time/Freq

Specify whether to define oscillator rate of Modulator 1 in terms of time (period, in ms) or frequency (Hz).

Default value: Frequency

Modulator 1 Period

Period of Modulator 1, in ms.

Default value: 1000
Range: 0.05 to 120000

Modulator 1 Output

Output level of Modulator 1. Negative values invert the modulator’s polarity.

Default value: 100
Range: -100 to 100

Modulator Assignment (right pane)

[Note] Note

The following rows describe the Amount and Quantization columns for each possible Property selection.

Amount

Amplitude Mod 1

Modulation amount of Mod 1 applied to Amplitude.

The modulation amount is expressed in percentage, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

[Note] Note

With a bipolar modulator it is possible to go under 0. For example, -50% plays a grain at 50% of the original level, but with the signal’s polarity inverted.

Default value: 0
Range: 0 to 100

Attack Mod 1

Modulation amount of Mod 1 applied to Attack.

The modulation amount is expressed in number of octaves, above and/or below the original value, depending on the choice of modulator waveshape. One octave up means half the attack’s duration, one octave down means twice the attack’s duration. Negative values have the effect of flipping the modulator’s output signal (that is, inverting its polarity).

Default value: 0
Range: -10 to 10

Azimuth Mod 1

Modulation amount of Mod 1 applied to Azimuth.

The modulation amount is expressed in number of degrees, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 180

Duration Mod 1

Modulation amount of Mod 1 applied to Duration.

The modulation amount is expressed in number of octaves, above and/or below the original value, depending on the choice of modulator waveshape. One octave up means half the duration, and one octave down means twice the duration. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: -10 to 10

Duration Multiplier Mod 1

Modulation amount of Mod 1 applied to Duration Multiplier.

The modulation amount is expressed in number of octaves, above and/or below the original value, depending on the choice of modulator waveshape. One octave up means half the duration (i.e. the duration multiplier is halved), and one octave down means twice the duration. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: -10 to 10

Elevation Mod 1

Modulation amount of Mod 1 applied to Elevation.

The modulation amount is expressed in number of degrees, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 90.0

Filter Cutoff Mod 1

Modulation amount of Mod 1 applied to Filter Cutoff.

The modulation amount is expressed in number of octaves, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: -10 to 10

Filter Q Mod 1

Modulation amount of Mod 1 applied to Filter Q.

The modulation amount is expressed as a Q offset, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 100

Emissions per Second Mod 1

Modulation amount of Mod 1 applied to Emissions per Second.

The modulation amount is expressed in number of octaves, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: -10 to 10

Time Between Emissions Mod 1

Modulation amount of Mod 1 applied to Time Between Emissions.

The modulation amount is expressed in number of octaves, above and/or below the original value, depending on the choice of modulator waveshape. One octave up means half the duration, and one octave down means twice the duration. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

[Note] Note

The value of Time Between Emissions Mod 1 is equivalent to that of Emissions Per Second Mod 1. In other words, if Select Freq/Time was Frequency, then the same value would result in the same modulation.

Default value: 0
Range: -10 to 10

Position Mod 1

Modulation amount of Mod 1 applied to Position.

The modulation amount is expressed in percentage of the file duration, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 100

Offset Mod 1

Modulation amount of Mod 1 applied to Offset.

The modulation amount is expressed in percentage of the file duration, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 100

Release Mod 1

Modulation amount of Mod 1 applied to Release.

The modulation amount is expressed in number of octaves, above and/or below the original value, depending on the choice of modulator waveshape. One octave up means half the release’s duration, and one octave down means twice the release’s duration. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: -10 to 10

Speed Mod 1

Modulation amount of Mod 1 applied to Speed.

The modulation amount is expressed as a speed offset, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 4

Spread Mod 1

Modulation amount of Mod 1 applied to Spread.

The modulation amount is expressed as an offset, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 100

Pitch Mod 1

Modulation amount of Mod 1 applied to Pitch.

The modulation amount is expressed in cents, above and/or below the original value, depending on the choice of modulator waveshape. Negative values have the effect of flipping the modulator’s output signal (i.e. inverting its polarity).

Default value: 0
Range: 0 to 4800

Quantization

Amplitude Mod 1 Quantization

Quantization of modulation applied to Amplitude.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Amplitude value.

Default value: None

Attack Mod 1 Quantization

Quantization of modulation applied to Attack.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Attack value.
  • Chromatic: Only semitones (12th of an octave) are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6} semitones around the base Attack duration (see note below).
  • Major: Only intervals of the major scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -3, -1, 0, 2, 4, 5} semitones around the base Attack duration (see note below).
  • Minor: Only intervals of the minor scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -4, -2, 0, 2, 3, 5} semitones around the base Attack duration (see note below).
  • Pentatonic: Only intervals of the pentatonic scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -2, 0, 3, 5} semitones around the base Attack duration (see note below).
[Note] Note

Here, modulating “one octave down” is equivalent to stretching time by a factor of 2. Similarly, modulating “one semitone down” is equivalent to stretching time by 2 to the power of 1/12, that is, by a factor of 1.059.

Default value: None

Azimuth Mod 1 Quantization

Quantization of modulation applied to Azimuth.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Azimuth value.

Default value: None

Duration Mod 1 Quantization

Quantization of modulation applied to Duration.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Duration value.
  • Chromatic: Only semitones (12th of an octave) are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6} semitones around the base Duration (see note below).
  • Major: Only intervals of the major scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -3, -1, 0, 2, 4, 5} semitones around the base Duration (see note below).
  • Minor: Only intervals of the minor scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -4, -2, 0, 2, 3, 5} semitones around the base Duration (see note below).
  • Pentatonic: Only intervals of the pentatonic scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -2, 0, 3, 5} semitones around the base Duration (see note below).
[Note] Note

Modulating one octave down is equivalent to stretching time by a factor of 2. Similarly, modulating one semitone down is equivalent to stretching time by 2 to the power of 1/12, that is, by a factor of 1.059.

Default value: None

Duration Multiplier Mod 1 Quantization

Quantization of modulation applied to Duration Multiplier.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Duration Multiplier value.

Default value: None

Elevation Mod 1 Quantization

Quantization of modulation applied to Elevation.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Elevation value.

Default value: None

Filter Cutoff Mod 1 Quantization

Quantization of modulation applied to Filter Cutoff.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms, and corresponds to the base Filter Cutoff value.
  • Chromatic: Only semitones (12th of an octave) are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6} semitones around the base Filter Cutoff frequency.
  • Major: Only intervals of the major scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -3, -1, 0, 2, 4, 5} semitones around the base Filter Cutoff frequency.
  • Minor: Only intervals of the minor scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -4, -2, 0, 2, 3, 5} semitones around the base Filter Cutoff frequency.
  • Pentatonic: Only intervals of the pentatonic scale are allowed. Say the modulation amount is 0.5 (octave), the allowed values are {-5, -2, 0, 3, 5} semitones around the base Filter Cutoff frequency.

Default value: None

Filter Q Mod 1 Quantization

Quantization of modulation applied to Filter Q.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Filter Q value.

Default value: None

Emissions per Second Mod 1 Quantization

Quantization of modulation applied to Emissions per Second.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms, and corresponds to the base Emissions per Second value.
  • Chromatic: Only semitones (12th of an octave) are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6} semitones around the base Emissions per Second frequency.
  • Major: Only intervals of the major scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -3, -1, 0, 2, 4, 5} semitones around the base Emissions per Second frequency.
  • Minor: Only intervals of the minor scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -4, -2, 0, 2, 3, 5} semitones around the base Emissions per Second frequency.
  • Pentatonic: Only intervals of the pentatonic scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -2, 0, 3, 5} semitones around the base Emissions per Second frequency.

Default value: None

Time Between Emissions Mod 1 Quantization

Quantization of modulation applied to Time Between Emissions.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Time Between Emissions value.
  • Chromatic: Only semitones (12th of an octave) are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6} semitones around the base Time Between Emissions duration (see note below).
  • Major: Only intervals of the major scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -3, -1, 0, 2, 4, 5} semitones around the base Time Between Emissions duration (see note below).
  • Minor: Only intervals of the minor scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -4, -2, 0, 2, 3, 5} semitones around the base Time Between Emissions duration (see note below).
  • Pentatonic: Only intervals of the pentatonic scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -2, 0, 3, 5} semitones around the base Time Between Emissions duration (see note below).
[Note] Note

Time Between Emissions modulation is equivalent to Emissions per Second modulation. Thus, same values of modulation result in the same behavior. Here, modulating one octave down is equivalent to stretching time by a factor of 2. Similarly, modulating one semitone down is equivalent to stretching time by 2 to the power of 1/12, that is, by a factor of 1.059.

Default value: None

Position Mod 1 Quantization

Quantization of modulation applied to Position.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Position value.

Default value: None

Offset Mod 1 Quantization

Quantization of modulation applied to Offset.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Offset value.

Default value: None

Release Mod 1 Quantization

Quantization of modulation applied to Release.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Release value.
  • Chromatic: Only semitones (12th of an octave) are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6} semitones around the base Release duration (see note below).
  • Major: Only intervals of the major scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -3, -1, 0, 2, 4, 5} semitones around the base Release duration (see note below).
  • Minor: Only intervals of the minor scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -4, -2, 0, 2, 3, 5} semitones around the base Release duration (see note below).
  • Pentatonic: Only intervals of the pentatonic scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -2, 0, 3, 5} semitones around the base Release duration (see note below).
[Note] Note

Here, modulating one octave down is equivalent to stretching time by a factor of 2. Similarly, modulating one semitone down is equivalent to stretching time by 2 to the power of 1/12, that is, by a factor of 1.059.

Default value: None

Speed Mod 1 Quantization

Quantization of modulation applied to Speed.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Speed value.

Default value: None

Spread Mod 1 Quantization

Quantization of modulation applied to Spread.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Spread value.

Default value: None

Pitch Mod 1 Quantization

Quantization of modulation applied to Pitch.

The available quantization schemes for this property are:

  • None: No quantization.
  • (-1, 1): Quantized to the top and bottom of the modulator waveform.
  • (-1, 0, 1): Quantized to the top, middle, and bottom of the modulator waveform. “Middle” only applies to bipolar waveforms and corresponds to the base Pitch value.
  • Chromatic: Only semitones (12th of an octave) are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-6, -5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5, 6} semitones around the base Pitch.
  • Major: Only intervals of the major scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -3, -1, 0, 2, 4, 5} semitones around the base Pitch.
  • Minor: Only intervals of the minor scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -4, -2, 0, 2, 3, 5} semitones around the base Pitch.
  • Pentatonic: Only intervals of the pentatonic scale are allowed. Say the modulation amount is 0.5 octave, the allowed values are {-5, -2, 0, 3, 5} semitones around the base Pitch.

Default value: None

Source Settings

This plug-in manages media, so it has two additional tabs in the Source Editor:

Source Tab

In the Source tab, you will find the familiar Wwise Source Editor. There, you may edit Trim, Fades, and Markers like you would for standard sources in Wwise. Note that any change that you perform here is made "pre-effect", that is, it affects the media before it is stored in SoundBanks. Thus, if you change the Trim, the source file that is used by the plug-in at run-time is effectively the trimmed file.

[Warning] Warning

Moving the Trim cursors will change the meaning of the Position setting, since it depends on the audio file's duration.

Markers, if any, are displayed as blue vertical lines in the graph view of the source audio file. The Markers list specifies the source of the markers.

  • Use File Markers: The source audio file's markers are used.

  • Use Markers From Transients: Markers are placed by automatic onset detection. These will not appear until you move the Marker Detection Sensitivity slider. The higher the sensitivity, the higher the chance to have markers. Adjust the slider so that detected onsets are closest to what you desire. Then you may edit them manually. Once you edit a marker, the markers mode will change to Manual Markers.

  • Manual Markers: The markers as set by the user are used. Selecting Manual Markers does not change the markers from what they were in the previous selection. Whether file markers or markers from transients, users can directly edit them at any time. As soon as anything is editing, the Markers selection is set to Manual Markers.

    [Tip] Adding your own markers

    In addition to many standard shortcut menu options, the SoundSeed Grain Source graph view has an Add Custom Marker option to manually add markers.

In the Effect Settings, enable Snap to Markers to set the effective grain start position to that of the closest marker.


Conversion Tab

In the Conversion tab you may select the Conversion ShareSet that will be used to encode the media prior to storing it in SoundBanks for the purpose of the plug-in. SoundSeed Grain supports all channel downmixing and sample rate options, but only the PCM and ADPCM codecs.

[Warning] Warning

Currently, SoundSeed Grain only supports decoding PCM and ADPCM at runtime. If from the Conversion tab you choose another codec (such as Vorbis or Opus) for the SoundSeed Grain Sound SFX, it will fail to play and you will see an error in the Capture Log.


[Note] Note

You should avoid using ADPCM for files smaller than 64 samples per channel.

Alternatively, you may select other codecs and have the game "decode" the SoundBank at the point of loading it in memory. Refer to AK::SoundEngine::DecodeBank in the SDK documentation for more details on the Decode Bank workflow.