From 2279b2156ba9e91f16655425e0b84220ad62180f Mon Sep 17 00:00:00 2001 From: Tylemagne Date: Sat, 21 Oct 2023 18:45:27 -0500 Subject: [PATCH 1/8] Update audio_effects.rst --- tutorials/audio/audio_effects.rst | 32 +++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index eada442a546..57d2216b862 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -73,20 +73,27 @@ The compressor has many uses. For example: a :ref:`limiter ` is likely a better choice than a compressor. +Limiter +~~~~~~~ + +A limiter is similar to a compressor, but it's less flexible and designed to +prevent a signal's amplitude exceeding a given dB threshold. Adding a limiter to +the Master bus is good practice, as it offers an easy safeguard against clipping. Delay ~~~~~ -Adds an "echo" effect with a feedback loop. It can be used together -with *Reverb* to simulate wide rooms, canyons, etc. where sound bounces -are far apart. +Digital delay essentially duplicates a signal and replays it at a specified speed with a volume level that decays for each repeat. Delay is great for simulating the acoustic space of a canyon or large room, where sound bounces have a lot of *delay* between their repeats. This is in contrast to reverb, which has a more natural and blurred sound to it. Using this in conjunction with reverb can create very natural sounding environments! Distortion ~~~~~~~~~~ -Makes the sound distorted. Godot offers several types of distortion: *overdrive*, -*tan* and *bit crushing*. Distortion can be used to simulate sound coming through +Makes the sound distorted. Godot offers several types of distortion: +- *Overdrive* sounds like a guitar distortion pedal or megaphone. Sounds distorted with this sound like they're coming through a low-quality speaker or device. +- *Tan* sounds like another interesting flavor of overdrive. +- *Bit crushing* clamps the amplitude of the signal, making it sound flat and crunchy. +All three types of distortion can add higher frequency sounds to an original sound, making it stand out better in "the mix". EQ ~~ @@ -97,10 +104,10 @@ scripts to create an equalizer with a custom number of bands. EQ6, EQ10, EQ21 ~~~~~~~~~~~~~~~ -Godot provides three equalizers with different numbers of bands. An equalizer on -the Master bus can be useful to cut frequencies that the device's speakers can't -reproduce well (e.g. a mobile phone's speakers won't reproduce bass content -well). The equalizer effect can be disabled when headphones are plugged in. +Godot provides three equalizers with different numbers of bands, which are represented in the title (6, 10, and 21 bands, respectively). An equalizer on the Master bus can be useful for cutting low and high frequencies that the device's speakers can't +reproduce well. For example a mobile phone's speakers won't reproduce bass content below 100Hz well, and could introduce sound to a limiter or compressor's attenuator that isn't even audible to the user anyway. + +Note: The equalizer effect can be disabled when headphones are plugged in, giving the user the best of both worlds. Filter ~~~~~~ @@ -121,13 +128,6 @@ Reduces all frequencies above a specific *Cutoff* frequency. .. _doc_audio_buses_limiter: -Limiter -~~~~~~~ - -A limiter is similar to a compressor, but it's less flexible and designed to -prevent a signal's amplitude exceeding a given dB threshold. Adding a limiter to -the Master bus is a safeguard against clipping. - LowPassFilter ~~~~~~~~~~~~~ From 65c57650f4be6fb22f83706d610f65732240db00 Mon Sep 17 00:00:00 2001 From: Tylemagne Date: Sat, 21 Oct 2023 18:54:25 -0500 Subject: [PATCH 2/8] Update audio_effects.rst --- tutorials/audio/audio_effects.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index 57d2216b862..2f8f52205e2 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -73,13 +73,6 @@ The compressor has many uses. For example: a :ref:`limiter ` is likely a better choice than a compressor. -Limiter -~~~~~~~ - -A limiter is similar to a compressor, but it's less flexible and designed to -prevent a signal's amplitude exceeding a given dB threshold. Adding a limiter to -the Master bus is good practice, as it offers an easy safeguard against clipping. - Delay ~~~~~ @@ -128,6 +121,13 @@ Reduces all frequencies above a specific *Cutoff* frequency. .. _doc_audio_buses_limiter: +Limiter +~~~~~~~ + +A limiter is similar to a compressor, but it's less flexible and designed to +prevent a signal's amplitude exceeding a given dB threshold. Adding a limiter to +the Master bus is good practice, as it offers an easy safeguard against clipping. + LowPassFilter ~~~~~~~~~~~~~ From 3eaa4d6719e2709ce95b137c465f07d526049819 Mon Sep 17 00:00:00 2001 From: Tylemagne Date: Sat, 21 Oct 2023 19:36:21 -0500 Subject: [PATCH 3/8] Update audio_effects.rst --- tutorials/audio/audio_effects.rst | 48 +++++++++++++++---------------- 1 file changed, 23 insertions(+), 25 deletions(-) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index 2f8f52205e2..169ad3381c0 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -16,9 +16,8 @@ description of the available effects: Amplify ~~~~~~~ -Amplify changes the amplitude of the signal. Some care needs to be taken. -Setting the level too high can make the sound clip, which is usually -undesirable. +Amplify changes the volume of the signal. Some care needs to be taken, though: +setting the level too high can make the sound digitally clip, which can produce unpleasant crackles and pops. BandLimit and BandPass ~~~~~~~~~~~~~~~~~~~~~~ @@ -39,30 +38,27 @@ or to transmit audio over the network in real-time. Chorus ~~~~~~ -The Chorus effect duplicates the incoming audio, delays the duplicate slightly -and uses an LFO to continuously modulate the pitch of the duplicated signal -before mixing the duplicated signal(s) and the original together again. This -creates a shimmering effect and adds stereo width to the sound. +As the name of the effect implies, the Chorus effect makes a single audio sample sound like an entire chorus. It does this by duplicating a signal and very slightly altering the timing and pitch of each duplicate, and varying that over time via an LFO (low frequency oscillator). The duplicate(s) are then mixed back together with the original signal, producing a lush, wide, and large sound. Although chorus is traditionally used for voices, it can be desirable with almost any type of sound. Compressor ~~~~~~~~~~ -A dynamic range compressor automatically attenuates the level of the incoming +A dynamic range compressor automatically attenuates (ducks) the level of the incoming signal when its amplitude exceeds a certain threshold. The level of attenuation applied is proportional to how far the incoming audio exceeds the threshold. The compressor's Ratio parameter controls the degree of attenuation. One of the main uses of a compressor is to reduce the dynamic range of signals with very loud and quiet parts. Reducing the dynamic range of a signal -can make it easier to mix. +can make it fit more comfortably in a mix. The compressor has many uses. For example: -- It can be used in the Master bus to compress the whole output. +- It can be used in the Master bus to compress the whole output prior to being hit by a limiter, making the effect of the limiter much more subtle. - It can be used in voice channels to ensure they sound as even as possible. -- It can be *sidechained*. This means it can reduce the sound level +- It can be *sidechained* by another sound source. This means it can reduce the sound level of one signal using the level of another audio bus for threshold detection. This technique is very common in video game mixing to "duck" the level of - music or sound effects when voices need to be heard. + music or sound effects when in-game or multiplayer voices need to be fully audible. - It can accentuate transients by using a slower attack. This can make sound effects more punchy. @@ -71,12 +67,13 @@ The compressor has many uses. For example: If your goal is to prevent a signal from exceeding a given amplitude altogether, rather than to reduce the dynamic range of the signal, a :ref:`limiter ` is likely a better choice - than a compressor. + than a compressor for this purpose. However, applying compression before + a limiter is still good practice. Delay ~~~~~ -Digital delay essentially duplicates a signal and replays it at a specified speed with a volume level that decays for each repeat. Delay is great for simulating the acoustic space of a canyon or large room, where sound bounces have a lot of *delay* between their repeats. This is in contrast to reverb, which has a more natural and blurred sound to it. Using this in conjunction with reverb can create very natural sounding environments! +Digital delay essentially duplicates a signal and repeats it at a specified speed with a volume level that decays for each repeat. Delay is great for simulating the acoustic space of a canyon or large room, where sound bounces have a lot of *delay* between their repeats. This is in contrast to reverb, which has a more natural and blurred sound to it. Using this in conjunction with reverb can create very natural sounding environments! Distortion ~~~~~~~~~~ @@ -86,7 +83,7 @@ Makes the sound distorted. Godot offers several types of distortion: a low-quality speaker or device. - *Tan* sounds like another interesting flavor of overdrive. - *Bit crushing* clamps the amplitude of the signal, making it sound flat and crunchy. -All three types of distortion can add higher frequency sounds to an original sound, making it stand out better in "the mix". +All three types of distortion can add higher frequency sounds to an original sound, making it stand out better in a mix. EQ ~~ @@ -97,8 +94,7 @@ scripts to create an equalizer with a custom number of bands. EQ6, EQ10, EQ21 ~~~~~~~~~~~~~~~ -Godot provides three equalizers with different numbers of bands, which are represented in the title (6, 10, and 21 bands, respectively). An equalizer on the Master bus can be useful for cutting low and high frequencies that the device's speakers can't -reproduce well. For example a mobile phone's speakers won't reproduce bass content below 100Hz well, and could introduce sound to a limiter or compressor's attenuator that isn't even audible to the user anyway. +Godot provides three equalizers with different numbers of bands, which are represented in the title (6, 10, and 21 bands, respectively). An equalizer on the Master bus can be useful for cutting low and high frequencies that the device's speakers can't reproduce well. For example, phone or tablet speakers usually don't reproduce low frequency sounds well, and could make a limiter or compressor attenuate sounds that aren't even audible to the user anyway. Note: The equalizer effect can be disabled when headphones are plugged in, giving the user the best of both worlds. @@ -125,7 +121,7 @@ Limiter ~~~~~~~ A limiter is similar to a compressor, but it's less flexible and designed to -prevent a signal's amplitude exceeding a given dB threshold. Adding a limiter to +prevent a signal's amplitude exceeding a given dB threshold. Adding a limiter to the final point of the Master bus is good practice, as it offers an easy safeguard against clipping. LowPassFilter @@ -151,14 +147,12 @@ Panner ~~~~~~ The Panner allows the stereo balance of a signal to be adjusted between -the left and right channels (wear headphones to audition this effect). +the left and right channels. Headphones are recommended when configuring in this effect. Phaser ~~~~~~ -It probably does not make much sense to explain that this effect is formed by -two signals being dephased and cancelling each other out. You can make a Darth -Vader voice with it, or jet-like sounds. +This effect is formed by de-phasing two duplicates of the same sound so they cancel each other out in an interesting way. Phaser produces a pleasant whooshing sound that moves back and forth through the audio spectrum, and can be a great way to create sci fi effects or Darth Vader-like voices. PitchShift ~~~~~~~~~~ @@ -166,6 +160,8 @@ PitchShift This effect allows the adjustment of the signal's pitch independently of its speed. All frequencies can be increased/decreased with minimal effect on transients. PitchShift can be useful to create unusually high or deep voices. +Do note that altering pitch can sound unnatural when pushed outside of a +narrow window. Record ~~~~~~ @@ -185,10 +181,12 @@ SpectrumAnalyzer ~~~~~~~~~~~~~~~~ This effect doesn't alter audio, instead, you add this effect to buses you want -a spectrum analysis of. This would typically be used for audio visualization. A -demo project using this can be found `here `__. +a spectrum analysis of. This would typically be used for audio visualization. +Visualizing voices can be a great way to draw attention to them without just +increasing their volume. +A demo project using this can be found `here `__. StereoEnhance ~~~~~~~~~~~~~ -This effect uses a few algorithms to enhance a signal's stereo spectrum. +This effect uses a few algorithms to enhance a signal's stereo width. From 74638af6b737a23a843e086e54f00c950642d255 Mon Sep 17 00:00:00 2001 From: Tylemagne Date: Sun, 22 Oct 2023 10:54:26 -0500 Subject: [PATCH 4/8] Update tutorials/audio/audio_effects.rst Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> --- tutorials/audio/audio_effects.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index 169ad3381c0..15ad067c1ce 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -83,6 +83,7 @@ Makes the sound distorted. Godot offers several types of distortion: a low-quality speaker or device. - *Tan* sounds like another interesting flavor of overdrive. - *Bit crushing* clamps the amplitude of the signal, making it sound flat and crunchy. + All three types of distortion can add higher frequency sounds to an original sound, making it stand out better in a mix. EQ From d412fada6637038b83c53e73721bd22dd117166b Mon Sep 17 00:00:00 2001 From: Tylemagne Date: Sun, 22 Oct 2023 10:54:39 -0500 Subject: [PATCH 5/8] Update tutorials/audio/audio_effects.rst Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> --- tutorials/audio/audio_effects.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index 15ad067c1ce..25a52698cea 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -79,6 +79,7 @@ Distortion ~~~~~~~~~~ Makes the sound distorted. Godot offers several types of distortion: + - *Overdrive* sounds like a guitar distortion pedal or megaphone. Sounds distorted with this sound like they're coming through a low-quality speaker or device. - *Tan* sounds like another interesting flavor of overdrive. From 1b2b8690731497a4ac4abd662943b2f1f7c27cc4 Mon Sep 17 00:00:00 2001 From: Tylemagne Date: Sun, 22 Oct 2023 10:56:34 -0500 Subject: [PATCH 6/8] Update audio_effects.rst Broke lines down further --- tutorials/audio/audio_effects.rst | 32 ++++++++++++++++++++++++++----- 1 file changed, 27 insertions(+), 5 deletions(-) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index 25a52698cea..e8c5d3fb4cb 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -17,7 +17,8 @@ Amplify ~~~~~~~ Amplify changes the volume of the signal. Some care needs to be taken, though: -setting the level too high can make the sound digitally clip, which can produce unpleasant crackles and pops. +setting the level too high can make the sound digitally clip, which can produce +unpleasant crackles and pops. BandLimit and BandPass ~~~~~~~~~~~~~~~~~~~~~~ @@ -38,7 +39,13 @@ or to transmit audio over the network in real-time. Chorus ~~~~~~ -As the name of the effect implies, the Chorus effect makes a single audio sample sound like an entire chorus. It does this by duplicating a signal and very slightly altering the timing and pitch of each duplicate, and varying that over time via an LFO (low frequency oscillator). The duplicate(s) are then mixed back together with the original signal, producing a lush, wide, and large sound. Although chorus is traditionally used for voices, it can be desirable with almost any type of sound. +As the name of the effect implies, the Chorus effect makes a single audio sample +sound like an entire chorus. It does this by duplicating a signal and very +slightly altering the timing and pitch of each duplicate, and varying that +over time via an LFO (low frequency oscillator). The duplicate(s) are then +mixed back together with the original signal, producing a lush, wide, and +large sound. Although chorus is traditionally used for voices, it can be +desirable with almost any type of sound. Compressor ~~~~~~~~~~ @@ -73,7 +80,12 @@ The compressor has many uses. For example: Delay ~~~~~ -Digital delay essentially duplicates a signal and repeats it at a specified speed with a volume level that decays for each repeat. Delay is great for simulating the acoustic space of a canyon or large room, where sound bounces have a lot of *delay* between their repeats. This is in contrast to reverb, which has a more natural and blurred sound to it. Using this in conjunction with reverb can create very natural sounding environments! +Digital delay essentially duplicates a signal and repeats it at a specified +speed with a volume level that decays for each repeat. Delay is great for +simulating the acoustic space of a canyon or large room, where sound bounces +have a lot of *delay* between their repeats. This is in contrast to reverb, +which has a more natural and blurred sound to it. Using this in conjunction +with reverb can create very natural sounding environments! Distortion ~~~~~~~~~~ @@ -96,7 +108,13 @@ scripts to create an equalizer with a custom number of bands. EQ6, EQ10, EQ21 ~~~~~~~~~~~~~~~ -Godot provides three equalizers with different numbers of bands, which are represented in the title (6, 10, and 21 bands, respectively). An equalizer on the Master bus can be useful for cutting low and high frequencies that the device's speakers can't reproduce well. For example, phone or tablet speakers usually don't reproduce low frequency sounds well, and could make a limiter or compressor attenuate sounds that aren't even audible to the user anyway. +Godot provides three equalizers with different numbers of bands, which +are represented in the title (6, 10, and 21 bands, respectively). +An equalizer on the Master bus can be useful for cutting low and high +frequencies that the device's speakers can't reproduce well. +For example, phone or tablet speakers usually don't reproduce +low frequency sounds well, and could make a limiter or compressor +attenuate sounds that aren't even audible to the user anyway. Note: The equalizer effect can be disabled when headphones are plugged in, giving the user the best of both worlds. @@ -154,7 +172,11 @@ the left and right channels. Headphones are recommended when configuring in this Phaser ~~~~~~ -This effect is formed by de-phasing two duplicates of the same sound so they cancel each other out in an interesting way. Phaser produces a pleasant whooshing sound that moves back and forth through the audio spectrum, and can be a great way to create sci fi effects or Darth Vader-like voices. +This effect is formed by de-phasing two duplicates of the same sound so +they cancel each other out in an interesting way. Phaser produces a +pleasant whooshing sound that moves back and forth through the audio +spectrum, and can be a great way to create sci fi effects or Darth +Vader-like voices. PitchShift ~~~~~~~~~~ From 14b9d475f9336e2d6d26a76722b52c5bb4861e6c Mon Sep 17 00:00:00 2001 From: Tylemagne Date: Sun, 22 Oct 2023 21:01:06 -0500 Subject: [PATCH 7/8] Update tutorials/audio/audio_effects.rst Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> --- tutorials/audio/audio_effects.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index e8c5d3fb4cb..e0f096e5ee4 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -93,7 +93,7 @@ Distortion Makes the sound distorted. Godot offers several types of distortion: - *Overdrive* sounds like a guitar distortion pedal or megaphone. Sounds distorted with this sound like they're coming through -a low-quality speaker or device. + a low-quality speaker or device. - *Tan* sounds like another interesting flavor of overdrive. - *Bit crushing* clamps the amplitude of the signal, making it sound flat and crunchy. From 82fb2ab613ac57fb7cc0c348dcf321bc17239d2f Mon Sep 17 00:00:00 2001 From: Max Hilbrunner Date: Fri, 10 Nov 2023 06:25:37 +0100 Subject: [PATCH 8/8] Update tutorials/audio/audio_effects.rst Co-authored-by: Matthew --- tutorials/audio/audio_effects.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/audio/audio_effects.rst b/tutorials/audio/audio_effects.rst index e0f096e5ee4..9dc54bc9d73 100644 --- a/tutorials/audio/audio_effects.rst +++ b/tutorials/audio/audio_effects.rst @@ -175,7 +175,7 @@ Phaser This effect is formed by de-phasing two duplicates of the same sound so they cancel each other out in an interesting way. Phaser produces a pleasant whooshing sound that moves back and forth through the audio -spectrum, and can be a great way to create sci fi effects or Darth +spectrum, and can be a great way to create sci-fi effects or Darth Vader-like voices. PitchShift