-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathInputSoundFile_8hpp_source.htm
More file actions
159 lines (159 loc) · 21.1 KB
/
InputSoundFile_8hpp_source.htm
File metadata and controls
159 lines (159 loc) · 21.1 KB
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
<!doctype html>
<html class="no-js" lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>cpp3ds · Documentation</title>
<link rel="stylesheet" href="../css/app.css" />
<link rel="stylesheet" type="text/css" href="doxygen.css" title="default" media="screen,print" />
<script src="../bower_components/modernizr/modernizr.js"></script>
</head>
<body>
<div id="topnav" class="text-center">
<dl class="sub-nav">
<dd id="navlogo"><a href="/">
<img src="../img/logo.svg" />
</a></dd>
<dd><a href="/#what">What is it?</a></dd>
<dd><a href="/#download">Download</a></dd>
<dd><a href="/#faqs">FAQs</a></dd>
<dd class="active"><a href="/docs">Docs</a></dd>
</dl>
</div>
<div id="content">
<!-- Generated by Doxygen 1.8.10 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.htm"><span>Main Page</span></a></li>
<li><a href="modules.htm"><span>Modules</span></a></li>
<li><a href="annotated.htm"><span>Classes</span></a></li>
<li class="current"><a href="files.htm"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.htm"><span>File List</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_0b93ed46ee854382aab85c778b89946e.htm">include</a></li><li class="navelem"><a class="el" href="dir_18d409fe281a3b15bd325ab753ead42a.htm">cpp3ds</a></li><li class="navelem"><a class="el" href="dir_f11191753e0b9218936d11d72560cde3.htm">Audio</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">InputSoundFile.hpp</div> </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">//</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">// SFML - Simple and Fast Multimedia Library</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">// Copyright (C) 2007-2015 Laurent Gomila ([email protected])</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">//</span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment">// This software is provided 'as-is', without any express or implied warranty.</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">// In no event will the authors be held liable for any damages arising from the use of this software.</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">//</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">// Permission is granted to anyone to use this software for any purpose,</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">// including commercial applications, and to alter it and redistribute it freely,</span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">// subject to the following restrictions:</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">//</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">// 1. The origin of this software must not be misrepresented;</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">// you must not claim that you wrote the original software.</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">// If you use this software in a product, an acknowledgment</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment">// in the product documentation would be appreciated but is not required.</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment">//</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment">// 2. Altered source versions must be plainly marked as such,</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment">// and must not be misrepresented as being the original software.</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">//</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment">// 3. This notice may not be removed or altered from any source distribution.</span></div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment">//</span></div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment"></span></div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="preprocessor">#ifndef CPP3DS_INPUTSOUNDFILE_HPP</span></div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#define CPP3DS_INPUTSOUNDFILE_HPP</span></div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> </div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment">// Headers</span></div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment"></span><span class="preprocessor">#include <cpp3ds/System/NonCopyable.hpp></span></div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include <cpp3ds/System/Time.hpp></span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <string></span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> </div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> </div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="keyword">namespace </span><a class="code" href="namespacecpp3ds.htm">cpp3ds</a></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> {</div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="keyword">class </span>InputStream;</div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="keyword">class </span>SoundFileReader;</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div>
<div class="line"><a name="l00045"></a><span class="lineno"><a class="line" href="classcpp3ds_1_1InputSoundFile.htm"> 45</a></span> <span class="keyword">class </span><a class="code" href="classcpp3ds_1_1InputSoundFile.htm">InputSoundFile</a> : <a class="code" href="classcpp3ds_1_1NonCopyable.htm">NonCopyable</a></div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> {</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="keyword">public</span>:</div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> </div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#ac0a2d7706c6dc0c2042fff882d40c5c2">InputSoundFile</a>();</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a2254ef59168e905fda64e01cea5e33c3">~InputSoundFile</a>();</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="keywordtype">bool</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a01ec1f76ae4326761e602f9170d16444">openFromFile</a>(<span class="keyword">const</span> std::string& filename);</div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> </div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>  <span class="keywordtype">bool</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#abde77c1ebfabffc4fe90e74ebd83645e">openFromMemory</a>(<span class="keyword">const</span> <span class="keywordtype">void</span>* data, std::size_t sizeInBytes);</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> </div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="keywordtype">bool</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a221f9a7f7d4d24a4977f6f76d5840f11">openFromStream</a>(<a class="code" href="classcpp3ds_1_1InputStream.htm">InputStream</a>& stream);</div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> </div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>  <span class="keywordtype">bool</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#afbedac3524e8b2b318a3b632b07a232f">openForWriting</a>(<span class="keyword">const</span> std::string& filename, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> channelCount, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> sampleRate);</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> </div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>  Uint64 <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a9e4d921cbb7bec2c5352219554f8ee90">getSampleCount</a>() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span> </div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a268df900934f2b886cf4a871700bc0c3">getChannelCount</a>() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> </div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a0009db474420f8ee2faf167b12c68758">getSampleRate</a>() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> </div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span>  <a class="code" href="classcpp3ds_1_1Time.htm">Time</a> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#ad87170912e6575f4efd907a038de3524">getDuration</a>() <span class="keyword">const</span>;</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <span class="keywordtype">void</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a8a470bf2e4f55a7b368053f689af4193">seek</a>(Uint64 sampleOffset);</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span> </div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="keywordtype">void</span> <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#a8a470bf2e4f55a7b368053f689af4193">seek</a>(<a class="code" href="classcpp3ds_1_1Time.htm">Time</a> timeOffset);</div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> </div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  Uint64 <a class="code" href="classcpp3ds_1_1InputSoundFile.htm#abf872958bdfd9dc4793645b6500d9082">read</a>(Int16* samples, Uint64 maxCount);</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span> </div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="keyword">private</span>:</div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span> </div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="keywordtype">void</span> close();</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span> </div>
<div class="line"><a name="l00194"></a><span class="lineno"> 194</span>  <span class="comment">// Member data</span></div>
<div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="comment"></span> <a class="code" href="classcpp3ds_1_1SoundFileReader.htm">SoundFileReader</a>* m_reader; </div>
<div class="line"><a name="l00197"></a><span class="lineno"> 197</span>  <a class="code" href="classcpp3ds_1_1InputStream.htm">InputStream</a>* m_stream; </div>
<div class="line"><a name="l00198"></a><span class="lineno"> 198</span>  <span class="keywordtype">bool</span> m_streamOwned; </div>
<div class="line"><a name="l00199"></a><span class="lineno"> 199</span>  Uint64 m_sampleCount; </div>
<div class="line"><a name="l00200"></a><span class="lineno"> 200</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> m_channelCount; </div>
<div class="line"><a name="l00201"></a><span class="lineno"> 201</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> m_sampleRate; </div>
<div class="line"><a name="l00202"></a><span class="lineno"> 202</span> };</div>
<div class="line"><a name="l00203"></a><span class="lineno"> 203</span> </div>
<div class="line"><a name="l00204"></a><span class="lineno"> 204</span> } <span class="comment">// namespace cpp3ds</span></div>
<div class="line"><a name="l00205"></a><span class="lineno"> 205</span> </div>
<div class="line"><a name="l00206"></a><span class="lineno"> 206</span> </div>
<div class="line"><a name="l00207"></a><span class="lineno"> 207</span> <span class="preprocessor">#endif // CPP3DS_INPUTSOUNDFILE_HPP</span></div>
<div class="line"><a name="l00208"></a><span class="lineno"> 208</span> </div>
<div class="line"><a name="l00209"></a><span class="lineno"> 209</span> </div>
<div class="ttc" id="classcpp3ds_1_1InputStream_htm"><div class="ttname"><a href="classcpp3ds_1_1InputStream.htm">cpp3ds::InputStream</a></div><div class="ttdoc">Abstract class for custom file input streams. </div><div class="ttdef"><b>Definition:</b> <a href="InputStream_8hpp_source.htm#l00040">InputStream.hpp:40</a></div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_ad87170912e6575f4efd907a038de3524"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#ad87170912e6575f4efd907a038de3524">cpp3ds::InputSoundFile::getDuration</a></div><div class="ttdeci">Time getDuration() const </div><div class="ttdoc">Get the total duration of the sound file. </div></div>
<div class="ttc" id="namespacecpp3ds_htm"><div class="ttname"><a href="namespacecpp3ds.htm">cpp3ds</a></div><div class="ttdef"><b>Definition:</b> <a href="AlResource_8hpp_source.htm#l00033">AlResource.hpp:33</a></div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_abf872958bdfd9dc4793645b6500d9082"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#abf872958bdfd9dc4793645b6500d9082">cpp3ds::InputSoundFile::read</a></div><div class="ttdeci">Uint64 read(Int16 *samples, Uint64 maxCount)</div><div class="ttdoc">Read audio samples from the open file. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_a9e4d921cbb7bec2c5352219554f8ee90"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#a9e4d921cbb7bec2c5352219554f8ee90">cpp3ds::InputSoundFile::getSampleCount</a></div><div class="ttdeci">Uint64 getSampleCount() const </div><div class="ttdoc">Get the total number of audio samples in the file. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_a01ec1f76ae4326761e602f9170d16444"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#a01ec1f76ae4326761e602f9170d16444">cpp3ds::InputSoundFile::openFromFile</a></div><div class="ttdeci">bool openFromFile(const std::string &filename)</div><div class="ttdoc">Open a sound file from the disk for reading. </div></div>
<div class="ttc" id="classcpp3ds_1_1Time_htm"><div class="ttname"><a href="classcpp3ds_1_1Time.htm">cpp3ds::Time</a></div><div class="ttdoc">Represents a time value. </div><div class="ttdef"><b>Definition:</b> <a href="Time_8hpp_source.htm#l00037">Time.hpp:37</a></div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_a268df900934f2b886cf4a871700bc0c3"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#a268df900934f2b886cf4a871700bc0c3">cpp3ds::InputSoundFile::getChannelCount</a></div><div class="ttdeci">unsigned int getChannelCount() const </div><div class="ttdoc">Get the number of channels used by the sound. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_abde77c1ebfabffc4fe90e74ebd83645e"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#abde77c1ebfabffc4fe90e74ebd83645e">cpp3ds::InputSoundFile::openFromMemory</a></div><div class="ttdeci">bool openFromMemory(const void *data, std::size_t sizeInBytes)</div><div class="ttdoc">Open a sound file in memory for reading. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_a0009db474420f8ee2faf167b12c68758"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#a0009db474420f8ee2faf167b12c68758">cpp3ds::InputSoundFile::getSampleRate</a></div><div class="ttdeci">unsigned int getSampleRate() const </div><div class="ttdoc">Get the sample rate of the sound. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm">cpp3ds::InputSoundFile</a></div><div class="ttdoc">Provide read access to sound files. </div><div class="ttdef"><b>Definition:</b> <a href="InputSoundFile_8hpp_source.htm#l00045">InputSoundFile.hpp:45</a></div></div>
<div class="ttc" id="classcpp3ds_1_1NonCopyable_htm"><div class="ttname"><a href="classcpp3ds_1_1NonCopyable.htm">cpp3ds::NonCopyable</a></div><div class="ttdoc">Utility class that makes any derived class non-copyable. </div><div class="ttdef"><b>Definition:</b> <a href="NonCopyable_8hpp_source.htm#l00035">NonCopyable.hpp:35</a></div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_a2254ef59168e905fda64e01cea5e33c3"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#a2254ef59168e905fda64e01cea5e33c3">cpp3ds::InputSoundFile::~InputSoundFile</a></div><div class="ttdeci">~InputSoundFile()</div><div class="ttdoc">Destructor. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_a8a470bf2e4f55a7b368053f689af4193"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#a8a470bf2e4f55a7b368053f689af4193">cpp3ds::InputSoundFile::seek</a></div><div class="ttdeci">void seek(Uint64 sampleOffset)</div><div class="ttdoc">Change the current read position to the given sample offset. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_afbedac3524e8b2b318a3b632b07a232f"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#afbedac3524e8b2b318a3b632b07a232f">cpp3ds::InputSoundFile::openForWriting</a></div><div class="ttdeci">bool openForWriting(const std::string &filename, unsigned int channelCount, unsigned int sampleRate)</div><div class="ttdoc">Open the sound file from the disk for writing. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_a221f9a7f7d4d24a4977f6f76d5840f11"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#a221f9a7f7d4d24a4977f6f76d5840f11">cpp3ds::InputSoundFile::openFromStream</a></div><div class="ttdeci">bool openFromStream(InputStream &stream)</div><div class="ttdoc">Open a sound file from a custom stream for reading. </div></div>
<div class="ttc" id="classcpp3ds_1_1InputSoundFile_htm_ac0a2d7706c6dc0c2042fff882d40c5c2"><div class="ttname"><a href="classcpp3ds_1_1InputSoundFile.htm#ac0a2d7706c6dc0c2042fff882d40c5c2">cpp3ds::InputSoundFile::InputSoundFile</a></div><div class="ttdeci">InputSoundFile()</div><div class="ttdoc">Default constructor. </div></div>
<div class="ttc" id="classcpp3ds_1_1SoundFileReader_htm"><div class="ttname"><a href="classcpp3ds_1_1SoundFileReader.htm">cpp3ds::SoundFileReader</a></div><div class="ttdoc">Abstract base class for sound file decoding. </div><div class="ttdef"><b>Definition:</b> <a href="SoundFileReader_8hpp_source.htm#l00043">SoundFileReader.hpp:43</a></div></div>
</div><!-- fragment --></div><!-- contents -->
</div>
<div id="footer-container">
<div id="footer">
SFML Copyright © Laurent Gomila
</div>
</div>
</body>
</html>