ScummVM API documentation
audio.h
1 /* ScummVM - Graphic Adventure Engine
2  *
3  * ScummVM is the legal property of its developers, whose names
4  * are too numerous to list here. Please refer to the COPYRIGHT
5  * file distributed with this source distribution.
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation, either version 3 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program. If not, see <http://www.gnu.org/licenses/>.
19  *
20  */
21 
22 #ifndef MEDIASTATION_AUDIO_H
23 #define MEDIASTATION_AUDIO_H
24 
25 #include "common/array.h"
26 #include "audio/audiostream.h"
27 #include "audio/mixer.h"
28 
29 #include "mediastation/datafile.h"
30 
31 namespace MediaStation {
32 
33 enum SoundPlayState {
34  kSoundPlayStateInvalid = 0,
35  kSoundPlayStateStopped = 1,
36  kSoundPlayStatePlaying = 2,
37  kSoundPlayStatePaused = 3,
38  kSoundPlayStateSleep = 4,
39  kSoundPlayStateAwake = 5
40 };
41 
42 enum SoundStopReason {
43  kSoundStopForNone = 0,
44  kSoundStopForFailure = 1,
45  kSoundStopForEnd = 2,
46  kSoundStopForScriptStop = 3,
47  kSoundStopForAbort = 4
48 };
49 
50 class SoundClient {
51 public:
52  virtual ~SoundClient() {}
53  virtual void soundPlayStateChanged(SoundPlayState state, SoundStopReason why) = 0;
54 };
55 
57 public:
58  AudioSequence(SoundClient *client) : _client(client) {};
59  ~AudioSequence();
60 
61  void start();
62  void pause();
63  void resume();
64  void stop();
65  void sleep();
66  void awake();
67 
68  void service();
69  void makeSoundIdle(SoundStopReason stopReason = kSoundStopForNone);
70  void playStateChanged(SoundPlayState state, SoundStopReason why = kSoundStopForNone);
71 
72  void readParameters(Chunk &chunk);
73  void readChunk(Chunk &chunk);
74  bool isEmpty() { return _streams.empty(); }
75 
76  uint _rate = 0;
77  uint _channelCount = 0;
78  uint _bitsPerSample = 0;
79  uint _chunkCount = 0;
80 
81 private:
83  Audio::SoundHandle _handle;
84  SoundClient *_client = nullptr;
85  SoundPlayState _state = kSoundPlayStateStopped;
86 };
87 
88 } // End of namespace MediaStation
89 
90 #endif
Definition: actor.h:34
Definition: array.h:52
Definition: audio.h:50
Definition: datafile.h:99
Definition: mixer.h:49
Definition: audio.h:56