pcm_utils: export pcm_range()

We are going to split the pcm_utils.c library, and pcm_range() will be
useful for several sub libraries.

1 files changed, 16 insertions, 0 deletions

diff --git a/src/pcm_utils.h b/src/pcm_utils.h
index 71398c015..44ea5aa16 100644
--- a/src/pcm_utils.h
+++ b/src/pcm_utils.h
@@ -22,6 +22,8 @@
 #include "pcm_resample.h"
 #include "pcm_dither.h"
 
+#include <glib.h>
+
 #include <stdint.h>
 #include <stddef.h>
 
@@ -42,6 +44,20 @@ struct pcm_convert_state {
 };
 
 /**
+ * Check if the value is within the range of the provided bit size,
+ * and caps it if necessary.
+ */
+static inline int32_t
+pcm_range(int32_t sample, unsigned bits)
+{
+	if (G_UNLIKELY(sample < (-1 << (bits - 1))))
+		return -1 << (bits - 1);
+	if (G_UNLIKELY(sample >= (1 << (bits - 1))))
+		return (1 << (bits - 1)) - 1;
+	return sample;
+}
+
+/**
  * Converts a float value (0.0 = silence, 1.0 = 100% volume) to an
  * integer volume value (1000 = 100%).
  */