Imported Upstream version 5.13~dfsg

1 files changed, 93 insertions, 0 deletions

diff --git a/opcodes/STKSaxofony.xml b/opcodes/STKSaxofony.xml
new file mode 100755
index 0000000..ae93bf2
--- /dev/null
+++ b/opcodes/STKSaxofony.xml
@@ -0,0 +1,93 @@
+<refentry id="STKSaxofony">
+  <indexterm id="IndexStksaxofony"><primary>STKSaxofony</primary></indexterm>
+  <refentryinfo><title>Signal Generators:STK Opcodes</title></refentryinfo>
+  <refmeta>
+    <refentrytitle>STKSaxofony</refentrytitle>
+  </refmeta>
+ 
+  <refnamediv>
+    <refname>STKSaxofony</refname>
+    <refpurpose>
+      STKSaxofony is a faux conical bore reed instrument.    </refpurpose>
+  </refnamediv>
+ 
+  <refsect1>
+    <title>Description</title>
+    <para>
+      STKSaxofony is a faux conical bore reed instrument.
+      This opcode uses a "hybrid" digital waveguide instrument that can generate a variety of wind-like sounds. It has also been referred to as the "blowed string" model. 
+      The waveguide section is essentially that of a string, with one rigid and one lossy termination. The non-linear function is a reed table. 
+      The string can be "blown" at any point between the terminations, though just as with strings, it is impossible to excite the system at either end. 
+      If the excitation is placed at the string mid-point, the sound is that of a clarinet. At points closer to the "bridge", the sound is closer to that of a saxophone.</para>
+  </refsect1>
+ 
+  <refsect1>
+    <title>Syntax</title>
+    <synopsis>asignal <command>STKSaxofony</command> ifrequency, iamplitude, [kc1, kv1[, kc2, kv2[, kc3, kv3[, kc4, kv4[, kc5, kv5[, kc6, kv6[, kc7, kv7]]]]]]]</synopsis>
+  </refsect1>
+ 
+  <refsect1>
+    <title>Initialization</title>
+    <para>
+      <emphasis>ifrequency</emphasis> -- Frequency of note played, in Hertz.
+    </para>
+   
+    <para>
+      <emphasis>iamplitude</emphasis> -- Amplitude of note played (range 0-1).
+    </para>
+  </refsect1>
+ 
+  <refsect1>
+    <title>Performance</title>
+    <para>
+      <emphasis>kc1, kv1, kc2, kv2, kc3, kv3, kc4, kv4, kc5, kv5, kc6, kv6, kc7, kv7, kc8, kv8</emphasis> -- 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). The 7 controller numbers and values that work for STKSaxofony are:
+      <itemizedlist>
+        <listitem><para><emphasis>kc, kv</emphasis> -- 2,   stiffness of reed.</para></listitem>
+        <listitem><para><emphasis>kc, kv</emphasis> -- 26,  .reed aperture</para></listitem>
+        <listitem><para><emphasis>kc, kv</emphasis> -- 11,  blow position </para></listitem>
+        <listitem><para><emphasis>kc, kv</emphasis> -- 4,   noise gain.</para></listitem>
+        <listitem><para><emphasis>kc, kv</emphasis> -- 29,  speed of low-frequency oscillator.</para></listitem>
+        <listitem><para><emphasis>kc, kv</emphasis> -- 1,   depth of low-frequency oscillator.</para></listitem>
+        <listitem><para><emphasis>kc, kv</emphasis> -- 128, breath pressure </para></listitem>
+      </itemizedlist>
+    </para>
+  </refsect1>
+ 
+    <refsect1>
+    <note>
+      <title>Note</title>
+      <para>
+        The code for this opcode is taken directly from the Saxofony class in the Synthesis Toolkit in C++ by Perry R. Cook and Gary P. Scavone. More on the STK classes can be found here:  
+<ulink url="https://ccrma.stanford.edu/software/stk/classes.html"><citetitle>https://ccrma.stanford.edu/software/stk/classes.html</citetitle></ulink>
+</para>
+    </note>
+  </refsect1>
+  
+  <refsect1>
+    <title>Examples</title>
+    <para>
+      Here is an example of the STKSaxofony opcode. It uses the file <ulink url="examples/STKSaxofony.csd"><citetitle>STKSaxofony.csd</citetitle></ulink>,
+     
+      <example>
+        <title>Example of the STKSaxofony opcode.</title>
+        <xi:include href="examples-xml/STKSaxofony.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+      </example>
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>Credits</title>
+    <para>
+      <simplelist>
+        <member>Author: &namemichael; (after Georg Essl)</member>
+        <member>Irreducible Productions</member>
+        <member>New York, NY</member>
+      </simplelist>
+    </para>
+    <para>New in Csound version 5.11</para>
+  </refsect1>
+</refentry>
+
+
+