summaryrefslogtreecommitdiff
path: root/opcodes/expsegb.xml
diff options
context:
space:
mode:
Diffstat (limited to 'opcodes/expsegb.xml')
-rw-r--r--opcodes/expsegb.xml105
1 files changed, 105 insertions, 0 deletions
diff --git a/opcodes/expsegb.xml b/opcodes/expsegb.xml
new file mode 100644
index 0000000..6a09575
--- /dev/null
+++ b/opcodes/expsegb.xml
@@ -0,0 +1,105 @@
+
+<refentry id="expsegb">
+<indexterm id="IndexExpsegb"><primary>expsegb</primary></indexterm>
+ <refentryinfo><title>Signal Generators:Linear and Exponential Generators</title></refentryinfo>
+ <refmeta>
+ <refentrytitle>expsegb</refentrytitle>
+ </refmeta>
+
+
+
+ <refnamediv>
+ <refname>expsegb</refname>
+ <refpurpose>
+ Trace a series of exponential segments between specified
+ absolute points.
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1>
+ <title>Description</title>
+ <para>
+ Trace a series of exponential segments between specified
+ absolute points.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Syntax</title>
+ <synopsis>ares <command>expsegb</command> ia, itim1, ib [, itim2] [, ic] [...]</synopsis>
+
+ <synopsis>kres <command>expsegb</command> ia, itim1, ib [, itim2] [, ic] [...]</synopsis>
+ </refsect1>
+
+ <refsect1>
+ <title>Initialization</title>
+ <para>
+ <emphasis>ia</emphasis> -- starting value. Zero is illegal for exponentials.
+ </para>
+
+ <para>
+ <emphasis>ib, ic</emphasis>, etc. -- value at <emphasis>tim1</emphasis> seconds, etc. For exponentials, must be non-zero and must agree in sign with <emphasis>ia</emphasis>.
+ </para>
+
+ <para>
+ <emphasis>itim1</emphasis> -- time in seconds of end of first segment.
+ </para>
+
+ <para>
+ <emphasis>itim2, itim3</emphasis>, etc. -- time in seconds of
+ subsequent ends of segments.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Performance</title>
+ <para>
+ These units generate control or audio signals whose values can pass through 2 or more specified points. The last <emphasis>tim</emphasis> value may or may not equal the instrument's performance time: a shorter performance will truncate the specified pattern, while a longer one will cause the last-defined segment to continue on in the same direction.
+ </para>
+
+ <para>
+ Note that the <emphasis>expsegb</emphasis> opcode does not operate correctly at audio rate when segments are shorter than a k-period. Try the <link linkend="expsegba"><citetitle>expsegba</citetitle></link> opcode instead.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+ <para>
+ Here is an example of the expsegb opcode. It uses the file <ulink url="examples/expsegb.csd"><citetitle>expsegb.csd</citetitle></ulink>.
+
+ <example>
+ <title>Example of the expsegb opcode.</title>
+
+
+
+ <para>See the sections <link linkend="UsingRealTime"><citetitle>Real-time Audio</citetitle></link> and <link linkend="CommandFlags"><citetitle>Command Line Flags</citetitle></link> for more information on using command line flags.</para>
+ <xi:include href="examples-xml/expsegb.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+ <para>
+ <link linkend="expon"><citetitle>expon</citetitle></link>,
+ <link linkend="expseg"><citetitle>expseg</citetitle></link>,
+ <link linkend="expsega"><citetitle>expsega</citetitle></link>,
+ <link linkend="expsegr"><citetitle>expsegr</citetitle></link>,
+ <link linkend="line"><citetitle>line</citetitle></link>,
+ <link linkend="linseg"><citetitle>linseg</citetitle></link>,
+ <link linkend="linsegr"><citetitle>linsegr</citetitle></link>
+ <link linkend="transeg"><citetitle>transeg</citetitle></link>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Credits</title>
+ <para>
+ <simplelist>
+ <member>Author: &namevictor;</member>
+ <member>June 2011 </member>
+ </simplelist>
+ </para>
+ <para>New in version 5.14</para>
+ </refsect1>
+</refentry>