<?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>STKShakers</title> <link rel="stylesheet" type="text/css" href="csound.css" /> <link rel="stylesheet" type="text/css" href="syntax-highlighting.css" /> <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /> <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="STKSaxofony.html" title="STKSaxofony" /> <link rel="next" href="STKSimple.html" title="STKSimple" /> </head> <body> <div class="navheader"> <table width="100%" summary="Navigation header"> <tr> <th colspan="3" align="center">STKShakers</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="STKSaxofony.html">Prev</a> </td> <th width="60%" align="center">Orchestra Opcodes and Operators</th> <td width="20%" align="right"> <a accesskey="n" href="STKSimple.html">Next</a></td> </tr> </table> <hr /> </div> <div class="refentry"> <a id="STKShakers"></a> <div class="titlepage"></div> <a id="IndexStkshakers" class="indexterm"></a> <div class="refnamediv"> <h2> <span class="refentrytitle">STKShakers</span> </h2> <p>STKShakers — STKShakers is an instrument that simulates environmental sounds or collisions of multiple independent sound producing objects. </p> </div> <div class="refsect1"> <a id="idm281472884404408"></a> <h2>Description</h2> <p> STKShakers are a set of PhISEM and PhOLIES instruments: PhISEM (Physically Informed Stochastic Event Modeling) is an algorithmic approach for simulating collisions of multiple independent sound producing objects. It can simulate a Maraca, Sekere, Cabasa, Bamboo Wind Chimes, Water Drops, Tambourine, Sleighbells, and a Guiro. On <a class="ulink" href="http://soundlab.cs.princeton.edu/research/controllers/shakers/" target="_top">http://soundlab.cs.princeton.edu/research/controllers/shakers/</a> PhOLIES (Physically-Oriented Library of Imitated Environmental Sounds) there is a similar approach for the synthesis of environmental sounds. It simulates of breaking sticks, crunchy snow (or not), a wrench, sandpaper, and more..</p> </div> <div class="refsect1"> <a id="idm281472884399736"></a> <h2>Syntax</h2> <pre class="synopsis">asignal <span class="command"><strong>STKShakers</strong></span> ifrequency, iamplitude, [kenerg, kv1[, kdecay, kv2[, kshake, kv3[, knum, kv4[, kres, kv5[, kinstr, kv6]]]]]]</pre> </div> <div class="refsect1"> <a id="idm281472884397432"></a> <h2>Initialization</h2> <p> <span class="emphasis"><em>ifrequency</em></span> -- Frequency of note played, in Hertz. </p> <p> <span class="emphasis"><em>iamplitude</em></span> -- Amplitude of note played (range 0-1). </p> </div> <div class="refsect1"> <a id="idm281472884334840"></a> <h2>Performance</h2> <p><span class="emphasis"><em>kenerg</em></span> -- controller 2, shake energy. Value range of kv1 is 0-127.</p> <p><span class="emphasis"><em>kdecay</em></span> -- controller 4, system decay. Value range of kv2 is 0-127.</p> <p><span class="emphasis"><em>kshake</em></span> -- controller 128, shake energy. Value range of kv3 is 0-127.</p> <p><span class="emphasis"><em>knum</em></span> -- controller 11, number of objects. Value range of kv4 is 0-127.</p> <p><span class="emphasis"><em>kres</em></span> -- controller 1, resonance frequency. Value range of kv5 is 0-127.</p> <p><span class="emphasis"><em>kinstr</em></span> -- controller 1071, instrument selection (Maraca = 0, Cabasa = 1, Sekere = 2, Guiro = 3, Water Drops = 4, Bamboo Chimes = 5, Tambourine = 6, Sleigh Bells = 7, Sticks = 8, Crunch = 9, Wrench = 10, Sand Paper = 11, Coke Can = 12, Next Mug = 13, Penny + Mug = 14, Nickle + Mug = 15, Dime + Mug = 16, Quarter + Mug = 17, Franc + Mug = 18, Peso + Mug = 19, Big Rocks = 20, Little Rocks = 21, Tuned Bamboo Chimes = 22). Value range of kv6 is 0-22.</p> </div> <div class="refsect1"> <a id="idm281472884329144"></a> <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> <table border="0" summary="Note: Note"> <tr> <td rowspan="2" align="center" valign="top" width="25"> <img alt="[Note]" src="images/note.png" /> </td> <th align="left">Note</th> </tr> <tr> <td align="left" valign="top"> <p> The code for this opcode is taken directly from the Shakers class in the Synthesis Toolkit in C++ by Perry R. Cook and Gary P. Scavone. More on the STK classes can be found here: <a class="ulink" href="https://ccrma.stanford.edu/software/stk/classes.html" target="_top"><em class="citetitle">https://ccrma.stanford.edu/software/stk/classes.html</em></a> </p> <p> <span class="emphasis"><em>kc1, kv1, kc2, kv2, kc3, kv3, kc4, kv4, kc5, kv5, kc6, kv6, kc7, kv7, kc8, kv8</em></span> -- Up to 8 optional k-rate controller pairs for the STK opcodes. Each controller pair consists of a controller number (kc) followed by a controller value (kv). Both the controller numbers and the controller values are krate variables. However, during a performance, normally the controller numbers stay fixed while the corresponding controller values may change at any time. The order of the controller pair is arbitrary, as long as they are after <span class="emphasis"><em>iamplitude</em></span>. Also, it is not needed that all controller pairs are used. </p> </td> </tr> </table> </div> </div> <div class="refsect1"> <a id="idm281472884324760"></a> <h2>Examples</h2> <p> Here is an example of the STKShakers opcode. It uses the file <a class="ulink" href="examples/STKShakers.csd" target="_top"><em class="citetitle">STKShakerscsd</em></a>. </p> <div class="example"> <a id="idm281472884322904"></a> <p class="title"> <strong>Example 941. Example of the STKShakers opcode.</strong> </p> <div class="example-contents"> <div class="refsect1"> <a id="idm281472705882136"></a> <pre class="programlisting"> <span class="nt"><CsoundSynthesizer></span> <span class="nt"><CsOptions></span> <span class="c1">; Select audio/midi flags here according to platform</span> -odac <span class="c1">;;;realtime audio out</span> <span class="c1">;-iadc ;;;uncomment -iadc if RT audio input is needed too</span> <span class="c1">; For Non-realtime ouput leave only the line below:</span> <span class="c1">; -o STKShakers.wav -W ;;; for file output any platform</span> <span class="nt"></CsOptions></span> <span class="nt"><CsInstruments></span> <span class="vg">sr</span> <span class="o">=</span> <span class="mi">44100</span> <span class="vg">ksmps</span> <span class="o">=</span> <span class="mi">32</span> <span class="vg">nchnls</span> <span class="o">=</span> <span class="mi">2</span> <span class="vg">0dbfs</span> <span class="o">=</span> <span class="mi">1</span> <span class="kd">instr</span> <span class="nf">1</span> i<span class="n">frq</span> <span class="o">=</span> <span class="nb">p4</span> a<span class="n">sig</span> <span class="nb">STKShakers</span> <span class="nb">cpspch</span><span class="p">(</span><span class="nb">p4</span><span class="p">),</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span> <span class="mi">4</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span> <span class="mi">11</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">112</span><span class="p">,</span> <span class="mi">128</span><span class="p">,</span> <span class="mi">80</span><span class="p">,</span> <span class="mi">1071</span><span class="p">,</span> <span class="mi">5</span> a<span class="n">sig</span> <span class="o">=</span> a<span class="n">sig</span> <span class="o">*</span><span class="mi">2</span> <span class="c1">;amplify</span> <span class="nb">outs</span> a<span class="n">sig</span><span class="p">,</span> a<span class="n">sig</span> <span class="kd">endin</span> <span class="nt"></CsInstruments></span> <span class="nt"><CsScore></span> <span class="nb">i</span> <span class="mi">1</span> <span class="mf">0.2</span> <span class="mf">.5</span> <span class="mf">7.00</span> <span class="mi">75</span> <span class="mi">0</span> <span class="mi">20</span> <span class="nb">e</span> <span class="nt"></CsScore></span> <span class="nt"></CsoundSynthesizer></span> </pre> </div> </div> </div> <p><br class="example-break" /> </p> </div> <div class="refsect1"> <a id="idm281472884320984"></a> <h2>Credits</h2> <p> </p> <table border="0" summary="Simple list" class="simplelist"> <tr> <td>Author: Michael Gogins (after Georg Essl)</td> </tr> <tr> <td>Irreducible Productions</td> </tr> <tr> <td>New York, NY</td> </tr> </table> <p> </p> <p>New in Csound version 5.11</p> </div> </div> <div class="navfooter"> <hr /> <table width="100%" summary="Navigation footer"> <tr> <td width="40%" align="left"><a accesskey="p" href="STKSaxofony.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="STKSimple.html">Next</a></td> </tr> <tr> <td width="40%" align="left" valign="top">STKSaxofony </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> <td width="40%" align="right" valign="top"> STKSimple</td> </tr> </table> </div> </body> </html>