1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
/*############################################################################*/
/*# #*/
/*# Ambisonic C++ Library #*/
/*# CBFormat - Ambisonic BFormat #*/
/*# Copyright © 2007 Aristotel Digenis #*/
/*# #*/
/*# Filename: BFormat.h #*/
/*# Version: 0.1 #*/
/*# Date: 19/05/2007 #*/
/*# Author(s): Aristotel Digenis #*/
/*# Licence: MIT #*/
/*# #*/
/*############################################################################*/
#ifndef _BFORMAT_H
#define _BFORMAT_H
#include "AmbisonicBase.h"
#include <memory>
#include <vector>
/// Storage for BFormat signals.
/** This object is used to store and transfer BFormat signals. Memory is
allocated for the number of channels needed for the given Ambisonic
configuration (order and 2D/3D) and the number of samples. */
class CBFormat : public CAmbisonicBase
{
public:
CBFormat();
/**
Returns the number of samples.
*/
unsigned GetSampleCount();
/**
Re-create the buffers needed for the given configuration. Previous
buffer contents are lost.
*/
bool Configure(unsigned nOrder, bool b3D, unsigned nSampleCount);
/**
Fill the buffer with zeros.
*/
void Reset();
/**
Not implemented.
*/
void Refresh();
/**
Copy a number of samples to a specific channel of the BFormat.
*/
void InsertStream(float* pfData, unsigned nChannel, unsigned nSamples);
/**
Copy a number of samples from a specific channel of the BFormat.
*/
void ExtractStream(float* pfData, unsigned nChannel, unsigned nSamples);
/**
Copy the content of the buffer. It is assumed that the two objects are
of the same configuration.
*/
void operator = (const CBFormat &bf);
/**
Returns true if the configuration of the two objects match.
*/
bool operator == (const CBFormat &bf);
/**
Returns true if the configuration of the two objects don't match.
*/
bool operator != (const CBFormat &bf);
CBFormat& operator += (const CBFormat &bf);
CBFormat& operator -= (const CBFormat &bf);
CBFormat& operator *= (const CBFormat &bf);
CBFormat& operator /= (const CBFormat &bf);
CBFormat& operator += (const float &fValue);
CBFormat& operator -= (const float &fValue);
CBFormat& operator *= (const float &fValue);
CBFormat& operator /= (const float &fValue);
protected:
unsigned m_nSamples;
unsigned m_nDataLength;
std::vector<float> m_pfData;
std::unique_ptr<float*[]> m_ppfChannels;
//friend classes cannot be pure abstract type,
//so must list each friend class manually
friend class CAmbisonicEncoder;
friend class CAmbisonicEncoderDist;
friend class CAmbisonicDecoder;
friend class CAmbisonicSpeaker;
friend class CAmbisonicMicrophone;
friend class CAmbisonicProcessor;
friend class CAmbisonicBinauralizer;
friend class CAmbisonicZoomer;
};
#endif //_BFORMAT_H
|
