Coverage Report

Created: 2026-10-17 07:46

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/vlc/contrib/contrib-build/game-music-emu/gme/Multi_Buffer.h
Line
Count
Source
1
// Multi-channel sound buffer interface, and basic mono and stereo buffers
2
3
// Blip_Buffer 0.4.1
4
#ifndef MULTI_BUFFER_H
5
#define MULTI_BUFFER_H
6
7
#include "blargg_common.h"
8
#include "Blip_Buffer.h"
9
10
// Interface to one or more Blip_Buffers mapped to one or more channels
11
// consisting of left, center, and right buffers.
12
class Multi_Buffer {
13
public:
14
  Multi_Buffer( int samples_per_frame );
15
2.73k
  virtual ~Multi_Buffer() { }
16
17
  // Set the number of channels available
18
  virtual blargg_err_t set_channel_count( int );
19
20
  // Get indexed channel, from 0 to channel count - 1
21
  struct channel_t {
22
    Blip_Buffer* center;
23
    Blip_Buffer* left;
24
    Blip_Buffer* right;
25
  };
26
  enum { type_index_mask = 0xFF };
27
  enum { wave_type = 0x100, noise_type = 0x200, mixed_type = wave_type | noise_type };
28
  virtual channel_t channel( int index, int type ) = 0;
29
30
  // See Blip_Buffer.h
31
  virtual blargg_err_t set_sample_rate( long rate, int msec = blip_default_length ) = 0;
32
  virtual void clock_rate( uint32_t ) = 0;
33
  virtual void bass_freq( int ) = 0;
34
  virtual void clear() = 0;
35
  long sample_rate() const;
36
37
  // Length of buffer, in milliseconds
38
  int length() const;
39
40
  // See Blip_Buffer.h
41
  virtual void end_frame( blip_time_t ) = 0;
42
43
  // Number of samples per output frame (1 = mono, 2 = stereo)
44
  int samples_per_frame() const;
45
46
  // Count of changes to channel configuration. Incremented whenever
47
  // a change is made to any of the Blip_Buffers for any channel.
48
2.03M
  unsigned channels_changed_count() { return channels_changed_count_; }
49
50
  // See Blip_Buffer.h
51
  virtual long read_samples( blip_sample_t*, long ) = 0;
52
  virtual long samples_avail() const = 0;
53
54
public:
55
  BLARGG_DISABLE_NOTHROW
56
protected:
57
5.46k
  void channels_changed() { channels_changed_count_++; }
58
private:
59
  // noncopyable
60
  Multi_Buffer( const Multi_Buffer& );
61
  Multi_Buffer& operator = ( const Multi_Buffer& );
62
63
  unsigned channels_changed_count_;
64
  long sample_rate_;
65
  int length_;
66
  int const samples_per_frame_;
67
};
68
69
// Uses a single buffer and outputs mono samples.
70
class Mono_Buffer : public Multi_Buffer {
71
  Blip_Buffer buf;
72
  channel_t chan;
73
public:
74
  // Buffer used for all channels
75
0
  Blip_Buffer* center() { return &buf; }
76
77
public:
78
  Mono_Buffer();
79
  ~Mono_Buffer();
80
  blargg_err_t set_sample_rate( long rate, int msec = blip_default_length ) override;
81
0
  void clock_rate( uint32_t rate ) override { buf.clock_rate( rate ); }
82
0
  void bass_freq( int freq ) override { buf.bass_freq( freq ); }
83
0
  void clear() override { buf.clear(); }
84
0
  long samples_avail() const override { return buf.samples_avail(); }
85
0
  long read_samples( blip_sample_t* p, long s ) override { return buf.read_samples( p, s ); }
86
0
  channel_t channel( int, int ) override { return chan; }
87
0
  void end_frame( blip_time_t t ) override { buf.end_frame( t ); }
88
};
89
90
// Uses three buffers (one for center) and outputs stereo sample pairs.
91
class Stereo_Buffer : public Multi_Buffer {
92
public:
93
94
  // Buffers used for all channels
95
0
  Blip_Buffer* center()       { return &bufs [0]; }
96
0
  Blip_Buffer* left()         { return &bufs [1]; }
97
0
  Blip_Buffer* right()        { return &bufs [2]; }
98
99
public:
100
  Stereo_Buffer();
101
  ~Stereo_Buffer();
102
  blargg_err_t set_sample_rate( long, int msec = blip_default_length ) override;
103
  void clock_rate( uint32_t ) override;
104
  void bass_freq( int ) override;
105
  void clear() override;
106
0
  channel_t channel( int, int ) override { return chan; }
107
  void end_frame( blip_time_t ) override;
108
109
0
  long samples_avail() const override { return bufs [0].samples_avail() * 2; }
110
  long read_samples( blip_sample_t*, long ) override;
111
112
private:
113
  enum { buf_count = 3 };
114
  Blip_Buffer bufs [buf_count];
115
  channel_t chan;
116
  int stereo_added;
117
  int was_stereo;
118
119
  void mix_stereo_no_center( blip_sample_t*, int32_t );
120
  void mix_stereo( blip_sample_t*, int32_t );
121
  void mix_mono( blip_sample_t*, int32_t );
122
};
123
124
// Silent_Buffer generates no samples, useful where no sound is wanted
125
class Silent_Buffer : public Multi_Buffer {
126
  channel_t chan;
127
public:
128
  Silent_Buffer();
129
  blargg_err_t set_sample_rate( long rate, int msec = blip_default_length ) override;
130
0
  void clock_rate( uint32_t ) override { }
131
0
  void bass_freq( int ) override { }
132
0
  void clear() override { }
133
0
  channel_t channel( int, int ) override { return chan; }
134
0
  void end_frame( blip_time_t ) override { }
135
0
  long samples_avail() const override { return 0; }
136
0
  long read_samples( blip_sample_t*, long ) override { return 0; }
137
};
138
139
140
inline blargg_err_t Multi_Buffer::set_sample_rate( long rate, int msec )
141
2.73k
{
142
2.73k
  sample_rate_ = rate;
143
2.73k
  length_ = msec;
144
2.73k
  return 0;
145
2.73k
}
146
147
inline blargg_err_t Silent_Buffer::set_sample_rate( long rate, int msec )
148
0
{
149
0
  return Multi_Buffer::set_sample_rate( rate, msec );
150
0
}
151
152
0
inline int Multi_Buffer::samples_per_frame() const { return samples_per_frame_; }
153
154
0
inline long Multi_Buffer::sample_rate() const { return sample_rate_; }
155
156
2.03M
inline int Multi_Buffer::length() const { return length_; }
157
158
#endif