annotate foosdk/sdk/pfc/audio_sample.h @ 1:20d02a178406 default tip

*: check in everything else yay
author Paper <paper@tflc.us>
date Mon, 05 Jan 2026 02:15:46 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
1 #pragma once
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
2 #include <math.h>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
3
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
4 #ifdef _MSC_VER
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
5 #include <intrin.h>
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
6 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
7
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
8
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
9 namespace pfc {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
10 // made a class so it can be redirected to an alternate class more easily than with namespacing
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
11 // in win desktop fb2k these are implemented in a DLL
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
12 class audio_math {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
13 public:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
14
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
15 //! p_source/p_output can point to same buffer
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
16 static void convert_to_int16(const float* p_source, size_t p_count, int16_t * p_output, float p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
17 static void convert_to_int16(const double* p_source, size_t p_count, int16_t* p_output, double p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
18 static void convert_to_int32(const float* p_source, size_t p_count, int32_t * p_output, float p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
19 static void convert_to_int32(const double* p_source, size_t p_count, int32_t* p_output, double p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
20 static void convert_from_int16(const int16_t * p_source, size_t p_count, float * p_output, float p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
21 static void convert_from_int16(const int16_t* p_source, size_t p_count, double * p_output, double p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
22 static void convert_from_int32(const int32_t* p_source, size_t p_count, float* p_output, float p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
23 static void convert_from_int32(const int32_t* p_source, size_t p_count, double* p_output, double p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
24 static void convert_to_int24(const float* in, size_t count, void* out, float scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
25 static void convert_to_int24(const double* in, size_t count, void* out, double scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
26
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
27 static float calculate_peak(const float * p_source, size_t p_count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
28 static double calculate_peak(const double * p_source, size_t p_count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
29
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
30 static void remove_denormals(float * p_buffer, size_t p_count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
31 static void remove_denormals(double * p_buffer, size_t p_count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
32
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
33
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
34 static void add_offset(float * p_buffer, float p_delta, size_t p_count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
35 static void add_offset(double * p_buffer, double p_delta, size_t p_count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
36
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
37 static void scale(const float* p_source, size_t p_count, float * p_output, float p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
38 static void scale(const double* p_source, size_t p_count, double * p_output, double p_scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
39
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
40 static void convert(const float* in, float* out, size_t count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
41 static void convert(const float* in, float* out, size_t count, float scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
42 static void convert(const float* in, double* out, size_t count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
43 static void convert(const float* in, double* out, size_t count, double scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
44 static void convert(const double* in, float* out, size_t count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
45 static void convert(const double* in, float* out, size_t count, double scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
46 static void convert(const double* in, double* out, size_t count);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
47 static void convert(const double* in, double* out, size_t count, double scale);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
48
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
49 inline static int64_t rint64(float val) { return (int64_t)llrint(val); }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
50 inline static int32_t rint32(float val) { return (int32_t)lrint(val); }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
51 inline static int64_t rint64(double val) { return (int64_t)llrint(val); }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
52 inline static int32_t rint32(double val) { return (int32_t)lrint(val); }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
53
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
54 static inline uint64_t time_to_samples(double p_time, uint32_t p_sample_rate) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
55 return (uint64_t)pfc::rint64((double)p_sample_rate * p_time);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
56 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
57
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
58 static inline double samples_to_time(uint64_t p_samples, uint32_t p_sample_rate) {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
59 PFC_ASSERT(p_sample_rate > 0);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
60 return (double)p_samples / (double)p_sample_rate;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
61 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
62
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
63 static inline double gain_to_scale(double p_gain) { return pow(10.0, p_gain / 20.0); }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
64 static inline double scale_to_gain(double scale) { return 20.0*log10(scale); }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
65
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
66 static unsigned bitrate_kbps( uint64_t fileSize, double duration );
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
67
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
68 static constexpr float float16scale = 65536.f;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
69
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
70 static float decodeFloat24ptr(const void* sourcePtr);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
71 static float decodeFloat24ptrbs(const void* sourcePtr);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
72 static float decodeFloat16(uint16_t source);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
73 }; // class audio_math
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
74
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
75 } // namespace pfc