Mercurial > audlegacy-plugins
comparison src/console/Music_Emu.h @ 12:3da1b8942b8b trunk
[svn] - remove src/Input src/Output src/Effect src/General src/Visualization src/Container
author | nenolod |
---|---|
date | Mon, 18 Sep 2006 03:14:20 -0700 |
parents | src/Input/console/Music_Emu.h@13389e613d67 |
children | fb513e10174e |
comparison
equal
deleted
inserted
replaced
11:cff1d04026ae | 12:3da1b8942b8b |
---|---|
1 | |
2 // Game music emulator interface base class | |
3 | |
4 // Game_Music_Emu 0.3.0 | |
5 | |
6 #ifndef MUSIC_EMU_H | |
7 #define MUSIC_EMU_H | |
8 | |
9 #include "blargg_common.h" | |
10 #include "abstract_file.h" | |
11 class Multi_Buffer; | |
12 | |
13 class Music_Emu { | |
14 public: | |
15 | |
16 // Initialize emulator with specified sample rate. Currently should only be | |
17 // called once. | |
18 virtual blargg_err_t set_sample_rate( long sample_rate ) = 0; | |
19 | |
20 // Load music file | |
21 blargg_err_t load_file( const char* path ); | |
22 | |
23 // Start a track, where 0 is the first track. Might un-mute any muted voices. | |
24 virtual void start_track( int ) = 0; | |
25 | |
26 // Generate 'count' samples info 'buf'. Output is in stereo unless using custom | |
27 // buffer that generates mono output. | |
28 typedef short sample_t; | |
29 virtual void play( long count, sample_t* buf ) = 0; | |
30 | |
31 // Additional optional features | |
32 | |
33 // Request use of custom multichannel buffer. Only supported by "classic" emulators; | |
34 // on others this has no effect. Should be called only once *before* set_sample_rate(). | |
35 virtual void set_buffer( Multi_Buffer* ) { } | |
36 | |
37 // Load music file data from custom source | |
38 virtual blargg_err_t load( Data_Reader& ) = 0; | |
39 | |
40 // Sample rate sound is generated at | |
41 long sample_rate() const; | |
42 | |
43 // Number of voices used by currently loaded file | |
44 int voice_count() const; | |
45 | |
46 // Names of voices | |
47 virtual const char** voice_names() const; | |
48 | |
49 // Mute voice n if bit n (1 << n) of mask is set | |
50 virtual void mute_voices( int mask ); | |
51 | |
52 // Frequency equalizer parameters (see notes.txt) | |
53 struct equalizer_t { | |
54 double treble; // -50.0 = muffled, 0 = flat, +5.0 = extra-crisp | |
55 long bass; // 1 = full bass, 90 = average, 16000 = almost no bass | |
56 }; | |
57 | |
58 // Current frequency equalizater parameters | |
59 const equalizer_t& equalizer() const; | |
60 | |
61 // Set frequency equalizer parameters | |
62 virtual void set_equalizer( equalizer_t const& ); | |
63 | |
64 // Equalizer settings for TV speaker | |
65 static equalizer_t const tv_eq; | |
66 | |
67 // Number of tracks. Zero if file hasn't been loaded yet. | |
68 int track_count() const; | |
69 | |
70 // Skip 'count' samples | |
71 virtual void skip( long count ); | |
72 | |
73 // True if a track was started and has since ended. Currently only logged | |
74 // format tracks (VGM, GYM) without loop points have an ending. | |
75 bool track_ended() const; | |
76 | |
77 // Number of errors encountered while playing track due to undefined CPU | |
78 // instructions in emulated formats and undefined stream events in | |
79 // logged formats. | |
80 int error_count() const; | |
81 | |
82 Music_Emu(); | |
83 virtual ~Music_Emu(); | |
84 | |
85 protected: | |
86 typedef BOOST::uint8_t byte; | |
87 void set_voice_count( int n ) { voice_count_ = n; } | |
88 void set_track_count( int n ) { track_count_ = n; } | |
89 void set_track_ended( bool b = true ) { track_ended_ = b; } | |
90 void log_error() { error_count_++; } | |
91 void remute_voices(); | |
92 private: | |
93 // noncopyable | |
94 Music_Emu( const Music_Emu& ); | |
95 Music_Emu& operator = ( const Music_Emu& ); | |
96 | |
97 equalizer_t equalizer_; | |
98 long sample_rate_; | |
99 int voice_count_; | |
100 int mute_mask_; | |
101 int track_count_; | |
102 int error_count_; | |
103 bool track_ended_; | |
104 }; | |
105 | |
106 // Deprecated | |
107 typedef Data_Reader Emu_Reader; | |
108 typedef Std_File_Reader Emu_Std_Reader; | |
109 typedef Mem_File_Reader Emu_Mem_Reader; | |
110 | |
111 inline int Music_Emu::error_count() const { return error_count_; } | |
112 inline int Music_Emu::voice_count() const { return voice_count_; } | |
113 inline int Music_Emu::track_count() const { return track_count_; } | |
114 inline bool Music_Emu::track_ended() const { return track_ended_; } | |
115 inline void Music_Emu::mute_voices( int mask ) { mute_mask_ = mask; } | |
116 inline void Music_Emu::remute_voices() { mute_voices( mute_mask_ ); } | |
117 inline const Music_Emu::equalizer_t& Music_Emu::equalizer() const { return equalizer_; } | |
118 inline void Music_Emu::set_equalizer( const equalizer_t& eq ) { equalizer_ = eq; } | |
119 inline long Music_Emu::sample_rate() const { return sample_rate_; } | |
120 | |
121 inline blargg_err_t Music_Emu::set_sample_rate( long r ) | |
122 { | |
123 assert( !sample_rate_ ); // sample rate can't be changed once set | |
124 sample_rate_ = r; | |
125 return blargg_success; | |
126 } | |
127 | |
128 inline void Music_Emu::start_track( int track ) | |
129 { | |
130 assert( sample_rate_ ); // set_sample_rate() must have been called first | |
131 track_ended_ = false; | |
132 error_count_ = 0; | |
133 } | |
134 | |
135 #endif | |
136 |