From 7fe47dfbbddc4e24fa8c24c987ad77f640c71305 Mon Sep 17 00:00:00 2001
From: Robbert van der Helm <mail@robbertvanderhelm.nl>
Date: Wed, 26 Jan 2022 11:48:40 +0100
Subject: [PATCH] Add a decibel to gain conversion function

---
 nih_plug/src/lib.rs  |  1 +
 nih_plug/src/util.rs | 46 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+)
 create mode 100644 nih_plug/src/util.rs

diff --git a/nih_plug/src/lib.rs b/nih_plug/src/lib.rs
index 89304f6a..a512a9cb 100644
--- a/nih_plug/src/lib.rs
+++ b/nih_plug/src/lib.rs
@@ -17,3 +17,4 @@
 pub mod debug;
 pub mod params;
 pub mod plugin;
+pub mod util;
diff --git a/nih_plug/src/util.rs b/nih_plug/src/util.rs
new file mode 100644
index 00000000..fd184447
--- /dev/null
+++ b/nih_plug/src/util.rs
@@ -0,0 +1,46 @@
+// nih-plug: plugins, but rewritten in Rust
+// Copyright (C) 2022 Robbert van der Helm
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+pub const MINUS_INFINITY_DB: f32 = -100.0;
+
+/// Convert decibels to gain, treating anything below -100 dB as minus infinity.
+pub fn db_to_gain(dbs: f32) -> f32 {
+    if dbs > MINUS_INFINITY_DB {
+        10.0f32.powf(dbs * 0.05)
+    } else {
+        0.0
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_db_to_gain_positive() {
+        assert_eq!(db_to_gain(3.0), 1.4125376);
+    }
+
+    #[test]
+    fn test_db_to_gain_negative() {
+        assert_eq!(db_to_gain(-3.0), 1.4125376f32.recip());
+    }
+
+    #[test]
+    fn test_db_to_gain_minus_infinity() {
+        assert_eq!(db_to_gain(-100.0), 0.0);
+    }
+}