<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://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/html; charset=UTF-8" />
<title>fluidControl</title>
<link rel="stylesheet" href="csound.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
<link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
<link rel="prev" href="fluidCCk.html" title="fluidCCk" />
<link rel="next" href="fluidEngine.html" title="fluidEngine" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">fluidControl</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="fluidCCk.html">Prev</a> </td>
<th width="60%" align="center">Orchestra Opcodes and Operators</th>
<td width="20%" align="right"> <a accesskey="n" href="fluidEngine.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="fluidControl">
<a id="fluidControl"></a>
<div class="titlepage"></div>
<a id="IndexFluidControl" class="indexterm"></a>
<div class="refnamediv">
<h2>
<span class="refentrytitle">fluidControl</span>
</h2>
<p>fluidControl —
Sends MIDI note on, note off, and other messages to a SoundFont preset.
</p>
</div>
<div class="refsect1" title="Syntax">
<a id="id2897576"></a>
<h2>Syntax</h2>
<pre class="synopsis"><span class="command"><strong>fluidControl</strong></span> ienginenum, kstatus, kchannel, kdata1, kdata2</pre>
</div>
<div class="refsect1" title="Description">
<a id="id2897601"></a>
<h2>Description</h2>
<p>The fluid opcodes provide a simple
Csound opcode wrapper around Peter Hanappe's Fluidsynth SoundFont2
synthesizer. This implementation accepts any MIDI note on, note
off, controller, pitch bend, or program change message at
k-rate. Maximum polyphony is 4096 simultaneously sounding
voices. Any number of SoundFonts may be loaded and played
simultaneously.
</p>
</div>
<div class="refsect1" title="Initialization">
<a id="id2897621"></a>
<h2>Initialization</h2>
<p><span class="emphasis"><em>ienginenum </em></span> -- engine number assigned from
fluidEngine</p>
</div>
<div class="refsect1" title="Performance">
<a id="id2897636"></a>
<h2>Performance</h2>
<p><span class="emphasis"><em>kstatus </em></span> -- MIDI channel message status byte: 128 for
note off, 144 for note on, 176 for control change, 192 for program change, or
224 for pitch bend. </p>
<p><span class="emphasis"><em>kchannel </em></span> -- MIDI channel number to which the
Fluidsynth program is assigned: from 0 to 255. MIDI channels numbered 16 or
higher are virtual channels.</p>
<p><span class="emphasis"><em>kdata1 </em></span> -- For note on, MIDI key number: from 0
(lowest) to 127 (highest), where 60 is middle C. For continuous controller
messages, controller number.</p>
<p><span class="emphasis"><em>kdata2 </em></span> -- For note on, MIDI key velocity: from 0 (no
sound) to 127 (loudest). For continous controller messages, controller
value.</p>
<p>Invoke fluidControl in instrument definitions that actually play
notes and send control messages. Each instrument definition must
consistently use one MIDI channel that was assigned to a Fluidsynth
program using fluidLoad.</p>
<p>In this implementation, SoundFont effects such as chorus or
reverb are used if and only if they are defaults for the preset. There
is no means of turning such effects on or off, or of changing their
parameters, from Csound.</p>
</div>
<div class="refsect1" title="See Also">
<a id="id2898424"></a>
<h2>See Also</h2>
<p><a class="link" href="fluidEngine.html" title="fluidEngine"><em class="citetitle">fluidEngine</em></a>, <a class="link" href="fluidNote.html" title="fluidNote"><em class="citetitle">fluidNote</em></a>, <a class="link" href="fluidLoad.html" title="fluidLoad"><em class="citetitle">fluidLoad</em></a></p>
</div>
<div class="refsect1" title="Credits">
<a id="id2898459"></a>
<h2>Credits</h2>
<p>Opcodes by Michael Gogins (gogins at pipeline dot
com). Thanks to Peter Hanappe for Fluidsynth, and to Steven Yi for
seeing that it is necessary to break up the Fluidsynth into several
different Csound opcodes.</p>
<p>New in Csound5.00</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="fluidCCk.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="OpcodesTop.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="fluidEngine.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">fluidCCk </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> fluidEngine</td>
</tr>
</table>
</div>
</body>
</html>
