summaryrefslogtreecommitdiff
path: root/scoregens
diff options
context:
space:
mode:
authorFelipe Sateler <fsateler@debian.org>2018-09-16 09:27:21 -0300
committerFelipe Sateler <fsateler@debian.org>2018-09-16 09:27:21 -0300
commitf8ededc4b74b3ee118a32d540c529371f549c63a (patch)
tree1c09ff295fdc0571e5e20bc75f34d6a925d63502 /scoregens
parentc5abb66cdfda502bb36b772aac89781cc56aa80d (diff)
New upstream version 6.11.0~dfsg
Diffstat (limited to 'scoregens')
-rw-r--r--scoregens/gen01.xml27
-rw-r--r--scoregens/gen53.xml69
-rw-r--r--scoregens/top.xml7
3 files changed, 94 insertions, 9 deletions
diff --git a/scoregens/gen01.xml b/scoregens/gen01.xml
index 7012bd1..b805ea5 100644
--- a/scoregens/gen01.xml
+++ b/scoregens/gen01.xml
@@ -43,16 +43,24 @@
</para>
<para>
- <emphasis>format</emphasis> -- specifies the audio data-file format:
+ <emphasis>format</emphasis> -- for raw files specifies the audio
+ data-file format:
<literallayout>
-1 - 8-bit signed character 4 - 16-bit short integers
-2 - 8-bit A-law bytes 5 - 32-bit long integers
-3 - 8-bit U-law bytes 6 - 32-bit floats
- </literallayout>
+ 1 - 8-bit signed character
+ 2 - 8-bit A-law bytes
+ 3 - 8-bit U-law bytes
+ 4 - 16-bit short integers
+ 5 - 32-bit long integers
+ 6 - 32-bit floats
+ 7 - 8-bit unsigned character
+ 8 - 24-bit integers
+ 9 - 64-bit doubles</literallayout>
</para>
-
+ <note><para>This list is not the same as in <link
+ linkend="diskin"><citetitle>diskin2</citetitle></link></para></note>
<para>
- If <emphasis>format</emphasis> = 0 the sample format is taken from the soundfile header, or by default from the CSound <link linkend="FlagsMinusLowerO"><citetitle>-o</citetitle></link> command-line flag.
+ If <emphasis>format</emphasis> = 0 the sample format is taken
+ from the soundfile header.
</para>
<note>
@@ -141,6 +149,9 @@
<refsect1>
<title>Credits</title>
- <para>September 2003. Thanks goes to Dr. Richard Boulanger for pointing out the references to the AIFF file format.</para>
+ <para>September 2003. Thanks goes to Dr. Richard Boulanger for
+ pointing out the references to the AIFF file format.</para>
+ <para>Revised in v6.11 to clarify status of headers and raw files,
+ and to add three more sample formats.</para>
</refsect1>
</refentry>
diff --git a/scoregens/gen53.xml b/scoregens/gen53.xml
new file mode 100644
index 0000000..4756446
--- /dev/null
+++ b/scoregens/gen53.xml
@@ -0,0 +1,69 @@
+
+<refentry id="GEN53">
+ <indexterm id="IndexGEN53"><primary>GEN53</primary></indexterm>
+ <refmeta>
+ <refentrytitle>GEN53</refentrytitle>
+ </refmeta>
+
+ <refnamediv>
+ <refname>GEN53</refname>
+ <refpurpose>
+ Creates a linear-phase or minimum-phase impulse response table
+ from a source table containing a frequency response or an
+ impulse response.
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1>
+ <title>Description</title>
+ <para>
+ GEN53 creates an impulse response function table with either a
+ linear-phase or a minimum-phase characteristic. The source for
+ this can either be a frequency response or an impulse response,
+ stored in an existing table. Optionally, another function table can be used to
+ window the input and/or the output of the process.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Syntax</title>
+ <synopsis><command>f</command> # time size 53 fsrc
+ [mode fwin]</synopsis>
+
+ <para>
+ fsrc - source function table. If this is an impulse response, the
+ size must match the created function table size. If a frequency
+ response is used, then the created function size needs to be twice
+ the size of this source. Power-of-two is required.
+ </para>
+
+ <para>
+ mode - optional, the operation mode, a sum of
+ (a) input, frequency response (0) or impulse respone (1); (b)
+ output, linear phase (0) or minimum-phase (2); (c) windowing,
+ none (0), input (4) and/or output (8). The default mode (0) is
+ frequency response input, linear-phase output, no windowing.
+ </para>
+
+ <para>
+ fwin - window function table, power-of-two size is required, but
+ does not need to match the created function table size.
+ </para>
+
+ </refsect1>
+ <refsect1>
+ <title>Example</title>
+ <para>
+ Here is a complete example of the GEN53 generator. It uses the file <ulink url="examples/gen53.csd"><citetitle>gen53.csd</citetitle></ulink>.
+ <example>
+ <title>Example of the GEN53 generator.</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/gen53.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>Credits</title>
+ <para>Author: &nameistvan;</para>
+ </refsect1>
+</refentry>
diff --git a/scoregens/top.xml b/scoregens/top.xml
index bf9f784..ce65dff 100644
--- a/scoregens/top.xml
+++ b/scoregens/top.xml
@@ -18,6 +18,10 @@
automatic carry of p-args
</para></listitem>
<listitem><para>
+ <link linkend="d"><citetitle>d</citetitle></link> - Deletes
+ an infinite instrument
+ </para></listitem>
+ <listitem><para>
<link linkend="e"><citetitle>e</citetitle></link> - Marks the end of the last section of the score
</para></listitem>
<listitem><para>
@@ -59,7 +63,7 @@
</para></listitem>
<listitem><para>
<link linkend="rightbrace"><citetitle>}</citetitle></link> - Ends a non-sectional, nestable loop
- </para></listitem>
+ </para></listitem>
</itemizedlist>
</para>
@@ -340,6 +344,7 @@
&scoregensgen49;
&scoregensgen51;
&scoregensgen52;
+ &scoregensgen53;
&scoregenstanh;
&scoregensexp;
&scoregenssone;