fluidsynth.github.io/api/example_8c-example.html at main · FluidSynth/fluidsynth.github.io · GitHub

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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>libfluidsynth: example.c</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="custom.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">libfluidsynth
   &#160;<span id="projectnumber">2.5.4</span>
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;"
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('example_8c-example.html',''); initResizable(); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div class="header">
  <div class="headertitle">
<div class="title">example.c</div>  </div>
</div><!--header-->
<div class="contents">
<p>Example producing short random music with FluidSynth</p>
<div class="fragment"><div class="line"><span class="comment">/*</span></div>
<div class="line"><span class="comment"></span> </div>
<div class="line"><span class="comment">  An example of how to use FluidSynth.</span></div>
<div class="line"><span class="comment"></span> </div>
<div class="line"><span class="comment">  To compile it on Linux:</span></div>
<div class="line"><span class="comment">  $ gcc -o example example.c `pkg-config fluidsynth --libs`</span></div>
<div class="line"><span class="comment"></span> </div>
<div class="line"><span class="comment">  To compile it on Windows:</span></div>
<div class="line"><span class="comment">    ...</span></div>
<div class="line"><span class="comment"></span> </div>
<div class="line"><span class="comment"></span> </div>
<div class="line"><span class="comment">  Author: Peter Hanappe.</span></div>
<div class="line"><span class="comment">  This code is in the public domain. Use it as you like.</span></div>
<div class="line"><span class="comment"></span> </div>
<div class="line"><span class="comment">*/</span></div>
<div class="line"> </div>
<div class="line"><span class="preprocessor">#include &lt;fluidsynth.h&gt;</span></div>
<div class="line"> </div>
<div class="line"><span class="preprocessor">#if defined(_WIN32)</span></div>
<div class="line"><span class="preprocessor">#include &lt;windows.h&gt;</span></div>
<div class="line"><span class="preprocessor">#define sleep(_t) Sleep(_t * 1000)</span></div>
<div class="line"><span class="preprocessor">#include &lt;process.h&gt;</span></div>
<div class="line"><span class="preprocessor">#define getpid _getpid</span></div>
<div class="line"><span class="preprocessor">#else</span></div>
<div class="line"><span class="preprocessor">#include &lt;stdlib.h&gt;</span></div>
<div class="line"><span class="preprocessor">#include &lt;unistd.h&gt;</span></div>
<div class="line"><span class="preprocessor">#endif</span></div>
<div class="line"> </div>
<div class="line"><span class="keywordtype">int</span> main(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv)</div>
<div class="line">{</div>
<div class="line">    <a class="code" href="group__Types.html#gaa363402d3c77333b0f070ba531d034ba">fluid_settings_t</a> *settings = NULL;</div>
<div class="line">    <a class="code" href="group__Types.html#gae265f10ae174a13afe010de50d87e1a4">fluid_synth_t</a> *synth = NULL;</div>
<div class="line">    <a class="code" href="group__Types.html#gac3706330ce49cac5b7dd079e90d376d8">fluid_audio_driver_t</a> *adriver = NULL;</div>
<div class="line">    <span class="keywordtype">int</span> sfont_id;</div>
<div class="line">    <span class="keywordtype">int</span> i, key;</div>
<div class="line"> </div>
<div class="line">    <span class="comment">/* Create the settings. */</span></div>
<div class="line">    settings = <a name="a0"></a><a class="code" href="group__settings.html#ga7623af35fb3d1abace21ef7d5b4f4781">new_fluid_settings</a>();</div>
<div class="line">    <span class="keywordflow">if</span>(settings == NULL)</div>
<div class="line">    {</div>
<div class="line">        puts(<span class="stringliteral">&quot;Failed to create the settings!&quot;</span>);</div>
<div class="line">        <span class="keywordflow">goto</span> err;</div>
<div class="line">    }</div>
<div class="line"> </div>
<div class="line">    <span class="comment">/* Change the settings if necessary*/</span></div>
<div class="line"> </div>
<div class="line">    <span class="comment">/* Create the synthesizer. */</span></div>
<div class="line">    synth = <a name="a1"></a><a class="code" href="group__synth.html#ga2aab8e0b82dc9fd086849efacb3c1b1b">new_fluid_synth</a>(settings);</div>
<div class="line">    <span class="keywordflow">if</span>(synth == NULL)</div>
<div class="line">    {</div>
<div class="line">        puts(<span class="stringliteral">&quot;Failed to create the synth!&quot;</span>);</div>
<div class="line">        <span class="keywordflow">goto</span> err;</div>
<div class="line">    }</div>
<div class="line"> </div>
<div class="line">    <span class="comment">/* Load a SoundFont and reset presets (so that new instruments</span></div>
<div class="line"><span class="comment">     * get used from the SoundFont)</span></div>
<div class="line"><span class="comment">     * Depending on the size of the SoundFont, this will take some time to complete...</span></div>
<div class="line"><span class="comment">     */</span></div>
<div class="line">    sfont_id = <a name="a2"></a><a class="code" href="group__soundfont__management.html#ga0ba0bc9d4a19c789f9969cd22d22bf66">fluid_synth_sfload</a>(synth, <span class="stringliteral">&quot;example.sf2&quot;</span>, 1);</div>
<div class="line">    <span class="keywordflow">if</span>(sfont_id == <a name="a3"></a><a class="code" href="group__misc.html#ga90e8bdbc5a507bbfa5c45bac85a63a61">FLUID_FAILED</a>)</div>
<div class="line">    {</div>
<div class="line">        puts(<span class="stringliteral">&quot;Loading the SoundFont failed!&quot;</span>);</div>
<div class="line">        <span class="keywordflow">goto</span> err;</div>
<div class="line">    }</div>
<div class="line"> </div>
<div class="line">    <span class="comment">/* Create the audio driver. The synthesizer starts playing as soon</span></div>
<div class="line"><span class="comment">       as the driver is created. */</span></div>
<div class="line">    adriver = <a name="a4"></a><a class="code" href="group__audio__driver.html#ga7c66ef86f0008807bdd955770fca6925">new_fluid_audio_driver</a>(settings, synth);</div>
<div class="line">    <span class="keywordflow">if</span>(adriver == NULL)</div>
<div class="line">    {</div>
<div class="line">        puts(<span class="stringliteral">&quot;Failed to create the audio driver!&quot;</span>);</div>
<div class="line">        <span class="keywordflow">goto</span> err;</div>
<div class="line">    }</div>
<div class="line"> </div>
<div class="line">    <span class="comment">/* Initialize the random number generator */</span></div>
<div class="line">    srand(getpid());</div>
<div class="line"> </div>
<div class="line">    <span class="keywordflow">for</span>(i = 0; i &lt; 12; i++)</div>
<div class="line">    {</div>
<div class="line">        <span class="comment">/* Generate a random key */</span></div>
<div class="line">        key = 60 + (int)(12.0f * rand() / (float) RAND_MAX);</div>
<div class="line"> </div>
<div class="line">        <span class="comment">/* Play a note */</span></div>
<div class="line">        <a name="a5"></a><a class="code" href="group__midi__messages.html#ga038a0f309e8004f39cb5491514bfac54">fluid_synth_noteon</a>(synth, 0, key, 80);</div>
<div class="line"> </div>
<div class="line">        <span class="comment">/* Sleep for 1 second */</span></div>
<div class="line">        sleep(1);</div>
<div class="line"> </div>
<div class="line">        <span class="comment">/* Stop the note */</span></div>
<div class="line">        <a name="a6"></a><a class="code" href="group__midi__messages.html#gae68ad5cca7a2c47be2f4b1c703ea9d46">fluid_synth_noteoff</a>(synth, 0, key);</div>
<div class="line">    }</div>
<div class="line"> </div>
<div class="line">err:</div>
<div class="line">    <span class="comment">/* Clean up */</span></div>
<div class="line">    <a name="a7"></a><a class="code" href="group__audio__driver.html#ga9c6f54ffa43a8ca482aca81582316f5a">delete_fluid_audio_driver</a>(adriver);</div>
<div class="line">    <a name="a8"></a><a class="code" href="group__synth.html#gab42ea6e25476be548deb428c839d7d2b">delete_fluid_synth</a>(synth);</div>
<div class="line">    <a name="a9"></a><a class="code" href="group__settings.html#gabd13a1e869bfaaaebfc58a72af5a66ac">delete_fluid_settings</a>(settings);</div>
<div class="line"> </div>
<div class="line">    <span class="keywordflow">return</span> 0;</div>
<div class="line">}</div>
<div class="ttc" id="agroup__Types_html_gaa363402d3c77333b0f070ba531d034ba"><div class="ttname"><a href="group__Types.html#gaa363402d3c77333b0f070ba531d034ba">fluid_settings_t</a></div><div class="ttdeci">struct _fluid_hashtable_t fluid_settings_t</div><div class="ttdoc">Configuration settings instance.</div><div class="ttdef"><b>Definition:</b> types.h:37</div></div>
<div class="ttc" id="agroup__Types_html_gac3706330ce49cac5b7dd079e90d376d8"><div class="ttname"><a href="group__Types.html#gac3706330ce49cac5b7dd079e90d376d8">fluid_audio_driver_t</a></div><div class="ttdeci">struct _fluid_audio_driver_t fluid_audio_driver_t</div><div class="ttdoc">Audio driver instance.</div><div class="ttdef"><b>Definition:</b> types.h:45</div></div>
<div class="ttc" id="agroup__Types_html_gae265f10ae174a13afe010de50d87e1a4"><div class="ttname"><a href="group__Types.html#gae265f10ae174a13afe010de50d87e1a4">fluid_synth_t</a></div><div class="ttdeci">struct _fluid_synth_t fluid_synth_t</div><div class="ttdoc">Synthesizer instance.</div><div class="ttdef"><b>Definition:</b> types.h:38</div></div>
<div class="ttc" id="agroup__audio__driver_html_ga7c66ef86f0008807bdd955770fca6925"><div class="ttname"><a href="group__audio__driver.html#ga7c66ef86f0008807bdd955770fca6925">new_fluid_audio_driver</a></div><div class="ttdeci">fluid_audio_driver_t * new_fluid_audio_driver(fluid_settings_t *settings, fluid_synth_t *synth)</div><div class="ttdoc">Create a new audio driver.</div><div class="ttdef"><b>Definition:</b> fluid_adriver.c:343</div></div>
<div class="ttc" id="agroup__audio__driver_html_ga9c6f54ffa43a8ca482aca81582316f5a"><div class="ttname"><a href="group__audio__driver.html#ga9c6f54ffa43a8ca482aca81582316f5a">delete_fluid_audio_driver</a></div><div class="ttdeci">void delete_fluid_audio_driver(fluid_audio_driver_t *driver)</div><div class="ttdoc">Deletes an audio driver instance.</div><div class="ttdef"><b>Definition:</b> fluid_adriver.c:442</div></div>
<div class="ttc" id="agroup__midi__messages_html_ga038a0f309e8004f39cb5491514bfac54"><div class="ttname"><a href="group__midi__messages.html#ga038a0f309e8004f39cb5491514bfac54">fluid_synth_noteon</a></div><div class="ttdeci">int fluid_synth_noteon(fluid_synth_t *synth, int chan, int key, int vel)</div><div class="ttdoc">Send a note-on event to a FluidSynth object.</div><div class="ttdef"><b>Definition:</b> fluid_synth.c:1421</div></div>
<div class="ttc" id="agroup__midi__messages_html_gae68ad5cca7a2c47be2f4b1c703ea9d46"><div class="ttname"><a href="group__midi__messages.html#gae68ad5cca7a2c47be2f4b1c703ea9d46">fluid_synth_noteoff</a></div><div class="ttdeci">int fluid_synth_noteoff(fluid_synth_t *synth, int chan, int key)</div><div class="ttdoc">Sends a note-off event to a FluidSynth object.</div><div class="ttdef"><b>Definition:</b> fluid_synth.c:1505</div></div>
<div class="ttc" id="agroup__misc_html_ga90e8bdbc5a507bbfa5c45bac85a63a61"><div class="ttname"><a href="group__misc.html#ga90e8bdbc5a507bbfa5c45bac85a63a61">FLUID_FAILED</a></div><div class="ttdeci">#define FLUID_FAILED</div><div class="ttdoc">Value that indicates failure, used by most libfluidsynth functions.</div><div class="ttdef"><b>Definition:</b> misc.h:64</div></div>
<div class="ttc" id="agroup__settings_html_ga7623af35fb3d1abace21ef7d5b4f4781"><div class="ttname"><a href="group__settings.html#ga7623af35fb3d1abace21ef7d5b4f4781">new_fluid_settings</a></div><div class="ttdeci">fluid_settings_t * new_fluid_settings(void)</div><div class="ttdoc">Create a new settings object.</div><div class="ttdef"><b>Definition:</b> fluid_settings.c:261</div></div>
<div class="ttc" id="agroup__settings_html_gabd13a1e869bfaaaebfc58a72af5a66ac"><div class="ttname"><a href="group__settings.html#gabd13a1e869bfaaaebfc58a72af5a66ac">delete_fluid_settings</a></div><div class="ttdeci">void delete_fluid_settings(fluid_settings_t *settings)</div><div class="ttdoc">Delete the provided settings object.</div><div class="ttdef"><b>Definition:</b> fluid_settings.c:285</div></div>
<div class="ttc" id="agroup__soundfont__management_html_ga0ba0bc9d4a19c789f9969cd22d22bf66"><div class="ttname"><a href="group__soundfont__management.html#ga0ba0bc9d4a19c789f9969cd22d22bf66">fluid_synth_sfload</a></div><div class="ttdeci">int fluid_synth_sfload(fluid_synth_t *synth, const char *filename, int reset_presets)</div><div class="ttdoc">Load a SoundFont file.</div><div class="ttdef"><b>Definition:</b> fluid_synth.c:5563</div></div>
<div class="ttc" id="agroup__synth_html_ga2aab8e0b82dc9fd086849efacb3c1b1b"><div class="ttname"><a href="group__synth.html#ga2aab8e0b82dc9fd086849efacb3c1b1b">new_fluid_synth</a></div><div class="ttdeci">fluid_synth_t * new_fluid_synth(fluid_settings_t *settings)</div><div class="ttdoc">Create new FluidSynth instance.</div><div class="ttdef"><b>Definition:</b> fluid_synth.c:711</div></div>
<div class="ttc" id="agroup__synth_html_gab42ea6e25476be548deb428c839d7d2b"><div class="ttname"><a href="group__synth.html#gab42ea6e25476be548deb428c839d7d2b">delete_fluid_synth</a></div><div class="ttdeci">void delete_fluid_synth(fluid_synth_t *synth)</div><div class="ttdoc">Delete a FluidSynth instance.</div><div class="ttdef"><b>Definition:</b> fluid_synth.c:1192</div></div>
</div><!-- fragment --> </div><!-- contents -->
</div><!-- doc-content -->
</body>
</html>