summaryrefslogtreecommitdiff
path: root/scoregens/gen33.xml
diff options
context:
space:
mode:
Diffstat (limited to 'scoregens/gen33.xml')
-rw-r--r--scoregens/gen33.xml53
1 files changed, 25 insertions, 28 deletions
diff --git a/scoregens/gen33.xml b/scoregens/gen33.xml
index 361d8ec..adfd6e8 100644
--- a/scoregens/gen33.xml
+++ b/scoregens/gen33.xml
@@ -63,37 +63,34 @@ stra, pna, phsa, strb, pnb, phsb, ...
<emphasis>fmode</emphasis> (optional, default = 0) -- a non-zero value can be used to set frequency in Hz instead of partial numbers in the source table. The sample rate is assumed to be fmode if it is positive, or -(sr * fmode) if any negative value is specified.
</para>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
<para>
- <informalexample>
- <programlisting>
-<emphasis role="comment">; partials 1, 4, 7, 10, 13, 16, etc. with base frequency of 400 Hz</emphasis>
-
-ibsfrq <emphasis role="op">=</emphasis> 400
-<emphasis role="comment">; estimate number of partials</emphasis>
-inumh <emphasis role="op">=</emphasis> <emphasis role="opc">int</emphasis>(1.5 <emphasis role="op">+</emphasis> <emphasis role="ohdr">sr</emphasis> <emphasis role="op">*</emphasis> 0.5 <emphasis role="op">/</emphasis> (3 <emphasis role="op">*</emphasis> ibsfrq))
-<emphasis role="comment">; source table length</emphasis>
-isrcln <emphasis role="op">=</emphasis> <emphasis role="opc">int</emphasis>(0.5 <emphasis role="op">+</emphasis> <emphasis role="opc">exp</emphasis>(<emphasis role="opc">log</emphasis>(2) <emphasis role="op">*</emphasis> <emphasis role="opc">int</emphasis>(1.01 <emphasis role="op">+</emphasis> <emphasis role="opc">log</emphasis>(inumh <emphasis role="op">*</emphasis> 3) <emphasis role="op">/</emphasis> <emphasis role="opc">log</emphasis>(2))))
-<emphasis role="comment">; create empty source table</emphasis>
-itmp <emphasis role="opc">ftgen</emphasis> 1, 0, isrcln, <emphasis role="op">-</emphasis>2, 0
-ifpos = 0
-ifrq = ibsfrq
-inumh = 0
-<emphasis role="olabel">l1</emphasis>:
- <emphasis role="opc">tableiw</emphasis> ibsfrq <emphasis role="op">/</emphasis> ifrq, ifpos, 1 <emphasis role="comment">; amplitude</emphasis>
- <emphasis role="opc">tableiw</emphasis> ifrq, ifpos <emphasis role="op">+</emphasis> 1, 1 <emphasis role="comment">; frequency</emphasis>
- <emphasis role="opc">tableiw</emphasis> 0, ifpos <emphasis role="op">+</emphasis> 2, 1 <emphasis role="comment">; phase</emphasis>
-ifpos <emphasis role="op">=</emphasis> ifpos <emphasis role="op">+</emphasis> 3
-ifrq <emphasis role="op">=</emphasis> ifrq <emphasis role="op">+</emphasis> ibsfrq <emphasis role="op">*</emphasis> 3
-inumh <emphasis role="op">=</emphasis> inumh <emphasis role="op">+</emphasis> 1
- <emphasis role="octrl">if</emphasis> (ifrq <emphasis role="op">&lt;</emphasis> (<emphasis role="ohdr">sr</emphasis> <emphasis role="op">*</emphasis> 0.5)) <emphasis role="op">igoto</emphasis> <emphasis role="olabel">l1</emphasis>
-
-<emphasis role="comment">; store output in ftable 2 (size = 262144)</emphasis>
-
-itmp <emphasis role="opc">ftgen</emphasis> 2, 0, 262144, <emphasis role="op">-</emphasis>33, 1, inumh, 1, <emphasis role="op">-</emphasis>1</programlisting>
- </informalexample>
+ Here is an example of the GEN33 routine. It uses the file <ulink url="examples/gen33.csd"><citetitle>gen33.csd</citetitle></ulink>.
+ <example>
+ <title>Example of the gen33 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/gen33.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ </example>
+
+ <textobject>
+ <phrase>This is the diagram of the waveform generated by GEN33, as used in the example:</phrase>
+ </textobject>
+ <para>
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/gen33.png" format="PNG"/>
+ <textobject>
+ <phrase>f 2 0 262144 -33 1 inumh 1 -1</phrase>
+ </textobject>
+ </imageobject>
+
+ <caption>
+ <para>f 2 0 262144 -33 1 inumh 1 -1</para>
+ </caption>
+ </mediaobject>
</para>
</refsect1>