SpectMorph
smaudio.hh
1 // Licensed GNU LGPL v3 or later: http://www.gnu.org/licenses/lgpl.html
2 
3 #ifndef SPECTMORPH_AUDIO_HH
4 #define SPECTMORPH_AUDIO_HH
5 
6 #include <vector>
7 
8 #include "smgenericin.hh"
9 #include "smgenericout.hh"
10 #include "smmath.hh"
11 #include "smutils.hh"
12 
13 #define SPECTMORPH_BINARY_FILE_VERSION 13
14 #define SPECTMORPH_SUPPORT_LPC 0
15 
16 namespace SpectMorph
17 {
18 
28 {
29 public:
30  std::vector<uint16_t> noise;
31  std::vector<uint16_t> freqs;
32  std::vector<uint16_t> mags;
33  std::vector<uint16_t> phases;
34  std::vector<float> lpc_lsf_p;
35  std::vector<float> lpc_lsf_q;
36  std::vector<float> original_fft;
37  std::vector<float> debug_samples;
38 
39  void sort_freqs();
40 
41  double
42  freqs_f (size_t i) const
43  {
44  return sm_ifreq2freq (freqs[i]);
45  }
46 
47  double
48  mags_f (size_t i) const
49  {
50  return sm_idb2factor (mags[i]);
51  }
52 
53  double
54  phases_f (size_t i) const
55  {
56  const double factor = 2.0 * M_PI / 65536.0;
57  return phases[i] * factor;
58  }
59 
60  double
61  noise_f (size_t i) const
62  {
63  return sm_idb2factor (noise[i]);
64  }
65 };
66 
67 enum AudioLoadOptions
68 {
69  AUDIO_LOAD_DEBUG,
70  AUDIO_SKIP_DEBUG
71 };
72 
80 class Audio
81 {
82  SPECTMORPH_CLASS_NON_COPYABLE (Audio);
83 public:
84  Audio();
85  ~Audio();
86 
87  enum LoopType {
88  LOOP_NONE = 0,
89  LOOP_FRAME_FORWARD,
90  LOOP_FRAME_PING_PONG,
91  LOOP_TIME_FORWARD,
92  LOOP_TIME_PING_PONG,
93  };
94 
96  float mix_freq;
97  float frame_size_ms;
98  float frame_step_ms;
101  int zeropad;
102  LoopType loop_type;
104  int loop_end;
107  std::vector<float> original_samples;
109  std::vector<AudioBlock> contents;
110 
111  Error load (const std::string& filename, AudioLoadOptions load_options = AUDIO_LOAD_DEBUG);
112  Error load (SpectMorph::GenericIn *file, AudioLoadOptions load_options = AUDIO_LOAD_DEBUG);
113  Error save (const std::string& filename) const;
114  Error save (SpectMorph::GenericOut *file) const;
115 
116  Audio *clone() const; // create a deep copy
117 
118  static bool loop_type_to_string (LoopType loop_type, std::string& s);
119  static bool string_to_loop_type (const std::string& s, LoopType& loop_type);
120 };
121 
122 }
123 
124 #endif
std::vector< float > lpc_lsf_p
LPC line spectrum frequencies, P(z) roots.
Definition: smaudio.hh:34
LoopType loop_type
type of loop to be used during sustain phase of playback
Definition: smaudio.hh:102
std::vector< float > original_samples
original time domain signal as samples (debugging only)
Definition: smaudio.hh:107
Generic Input Stream.
Definition: smgenericin.hh:17
float attack_end_ms
end of attack in milliseconds
Definition: smaudio.hh:100
Audio sample containing many blocks.
Definition: smaudio.hh:80
float mix_freq
mix freq (sampling rate) of the original audio data
Definition: smaudio.hh:96
float original_samples_norm_db
normalization factor to be applied to original samples
Definition: smaudio.hh:108
float frame_step_ms
stepping of the audio frames in milliseconds
Definition: smaudio.hh:98
std::vector< float > original_fft
original zeropadded FFT data - for debugging only
Definition: smaudio.hh:36
std::vector< float > lpc_lsf_q
LPC line spectrum frequencies, Q(z) roots.
Definition: smaudio.hh:35
Block of audio data, encoded in SpectMorph parametric format.
Definition: smaudio.hh:27
float fundamental_freq
fundamental frequency (note which was encoded), or 0 if not available
Definition: smaudio.hh:95
std::vector< uint16_t > noise
noise envelope, representing the original signal minus sine components
Definition: smaudio.hh:30
std::vector< uint16_t > freqs
frequencies of the sine components of this frame
Definition: smaudio.hh:31
float attack_start_ms
start of attack in milliseconds
Definition: smaudio.hh:99
std::vector< AudioBlock > contents
the actual frame data
Definition: smaudio.hh:109
std::vector< uint16_t > phases
phases of the sine components
Definition: smaudio.hh:33
Definition: smalignedarray.cc:7
int loop_start
loop point to be used during sustain phase of playback
Definition: smaudio.hh:103
std::vector< uint16_t > mags
magnitudes of the sine components
Definition: smaudio.hh:32
int loop_end
loop point to be used during sustain phase of playback
Definition: smaudio.hh:104
Generic Output Stream.
Definition: smgenericout.hh:17
std::vector< float > debug_samples
original audio samples for this frame - for debugging only
Definition: smaudio.hh:37
int zero_values_at_start
number of zero values added by encoder (strip during decoding)
Definition: smaudio.hh:105
int sample_count
number of samples encoded (including zero_values_at_start)
Definition: smaudio.hh:106
int zeropad
FFT zeropadding used during analysis.
Definition: smaudio.hh:101
float frame_size_ms
length of each audio frame in milliseconds
Definition: smaudio.hh:97