Version

menu_open
Warning: you were redirected to the latest documentation corresponding to your major release ( 2023.1.9.8628 ). Should you wish to access your specific version's documentation, please download the offline documentation from the Audiokinetic Launcher and check the Offline Documentation option in Wwise Authoring.

Pitch Shifter

The Pitch Shifter plug-in can be used to change the pitch of an audio signal without affecting its duration. The plug-in can be used with complex polyphonic signals (i.e. not just voice for example) and allows pitch shifts upwards or downwards. It can also be used as a harmonizer when the dry signal is not completely attenuated (although the Harmonizer is the recommended solution for this).

Choosing the delay time

Choosing the delay time parameter dictates the nature of artifacts that will heard using the algorithm. Short delay values can lead to amplitude modulations artifacts but do not suffer from distinct echo problem. On the other hand, using large delay values will no longer suffer from amplitude modulation problems and make the interval sound more in tune when compared to the dry signal on monophonic signals, but a distinct echo can be heard. Recommendation: A range between 10 ms to 100 ms is usually recommended for sounds that are just pitched (not harmonized). In those cases the echo is tolerable and high pitch resolution is not necessary since the original (dry) signal reference is not present.

The ideal delay time is dependent on audio content where signals with lots of transients (e.g. punches, drums, explosions,etc.) may benefit from smaller delay time settings while harmonic signals with more stable frequency content (e.g. voices, musical instruments, etc.) may work best with slightly larger delay time parameter values which provide more accurate frequency resolution.

Pitch Shifter properties

The Pitch Shifter plug-in contains a series of properties, many of which can be edited in real-time and can be mapped to specific Game Parameters using RTPCs.

Interface Element

Description

Name

The name of the Effect instance.

Effect instances are a group of effect property settings. They can be one of two types: custom instances or ShareSets. Custom instances can be used by only one object, whereas ShareSets can be shared across several objects.

Displays the object's color. Clicking the icon opens the color selector.

Select a color to apply it to the object. When you choose a color for an object, a palette icon appears on the selected square, as well as a yellow triangle in the lower-right corner, as shown.

To inherit the parent object's color, select the square at the far left of the color selector.

Inclusion

Determines whether the element is included in the SoundBanks when they are generated. When selected, the element is included. When unselected, the element is not included.

To optimize your sound design for each platform, you might want to exclude certain elements on certain platforms. By default, this check box applies across all platforms. Use the Link indicator to the left of the check box to unlink the element. Then you can customize the state of the check box per platform.

When this option is unselected, the property and behavior options in the editor become unavailable.

Default value: true

Indicates the number of elements in your project that contain direct references to the object. The icon is displayed in orange when references to the object exist, and in gray when no references exist.

Selecting the button opens the Reference View with the object's name in the References to: field.

Notes

Additional information about the Effect.

Metering

Indicates the name of the object currently being metered.

Allows you to browse for other objects to meter.

[Note]Note

The metering interface elements only appear in the Effect Editor for Effects that include VU meters.

Sets the display of the Effect Editor's selected tabs. By default, there is one panel displaying only one selected tab. You can, however, click a splitter button to split the panel into two, either side by side or one on top of the other, for two different tabs. The currently selected option is highlighted with a background color.

[Note]Note

You cannot display the same tab in both panels. If you select the tab that is currently displayed in the other panel, then the other panel will automatically display another tab.

Input

This parameter determines which channels will be processed by the pitch shifter.

Values:

  • As Input: All input channels are processed (default).

  • Mono-Center: Only the center channel is processed. Mono signals are also processed.

  • Stereo: Only the front left and right speakers are processed.

  • L-R-C: All front speakers are processed, including center when present.

  • L-R-Ls-Rs: The front and rear stereo pairs are processed.

  • L-R-C-Ls-Rs: All full band channels are processed.

Default value: As Input

Process LFE

This parameter determines if the LFE channel will be processed by the pitch shifter.

Default value: false

Delay Time

Larger delay time reduces amplitude modulation artifacts but can create distinct echoes. See section above for a more detailed discussion on how to choose the value for this parameter.

Default value: 50

Range: 10 to 400

Units: ms

Delay Dry

Determines whether the dry signal should be delayed to preserve synchronization with the transposed signal (wet path).

[Note]Note

This property has no effect when the pitch shifter is used in an Auxiliary Bus. In this case, the dry signal is defined by the object sending to the Auxiliary Bus.

Default value: false

Pitch Shift

The pitch is raised or lowered by the amount specified by this parameter (in Cents). So, +1200 Cents transposes an octave up and -1,200 is an octave down. This value supports RTPC and may be smoothly changed during playback without additional artifacts.

Default value: 0

Range: -2400 to 2400

Units: cents

Filter Parameters

Filter Type

Determines the type of filtering that can be applied to the transposed (wet) signal. The following filters are available:

  • None to disable the filter.

  • Low Pass to provide a fixed sloped attenuation of high frequencies from a specified frequency. Below this point the signal is almost unaffected but higher frequencies are progressively more attenuated past the cutoff frequency point.

  • High Pass to provide a fixed slope attenuation of low frequencies from a specified frequency. Above this point the signal is almost unaffected while lower frequencies are progressively more attenuated below the cutoff frequency point.

  • Band Pass to reject all frequencies around the specified center frequency. The range of frequencies around the center is controlled by the Q.

  • Notch to provide a fixed attenuation of a specified frequency range with a varying width. The range of frequencies around the center is controlled by the Q.

  • Low Shelf to provide gain/attenuation for a specified range of low frequencies. This curve type is also known as Bass Tone Control.

  • High Shelf to provide gain /attenuation for a specified range of high frequencies. This curve type is also known as Treble Tone Control.

  • Peaking to provide amplification/attenuation of a specified frequency range with a varying width. The range of frequencies around the peak is controlled by the Q.

Default value: None

Filter Gain

The amount of the amplification of the transposed (wet) signal for the selected frequency band. Increasing this value “boosts” the audio signal. Decreasing this value “cuts” or attenuates the audio signal.

[Note]Note

The Gain controls are not available when the Low Pass, High Pass, Notch, and Band Pass curves have been selected because these filter types have their passband normalized at 0 dB.

Default value: 0

Range: -24 to 24

Units: dB

Frequency

The portion of the frequency spectrum that will be affected by the gain.

Default value: 1000

Range: 20 to 20000

Units: Hz

Filter Q Factor

The area around the center frequency that will be affected by the change in gain. A low Q value means that the bandwidth range will be wide, and conversely a high Q value means that the bandwidth range will be narrow.

This control is not available when the Low Pass, High Pass, Low Shelf, and High Shelf curves have been selected.

Default value: 1

Range: 0.1 to 20

Output Levels

Dry Level

Gain applied to unprocessed signal.

Default value: -96

Range: -96 to 24

Units: dB

Wet Level

Gain applied to transposed (wet) signal.

Default value: 0

Range: -96 to 24

Units: dB


Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise