← Back to branch summary

~ubuntu-branches/ubuntu/trusty/csound-manual/trusty-proposed

« back to all changes in this revision

Viewing changes to opcodes/tabmorphi.xml

  • Committer: Bazaar Package Importer
  • Author(s): Felipe Sateler
  • Date: 2011-08-01 22:21:58 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20110801222158-90kslkp5ujci2f5d
Tags: 1:5.13~dfsg-1
* New upstream release
 - Add Menno Knevel to the copyright file
 - Refresh patch 2000-stripped-opcodes.diff
 - Update copyright hints file
* Update Vcs-* headers
* Bump Standards-Version

Show diffs side-by-side

added added

removed removed

Lines of Context:
opcodes/tabmorphi.xml
23
23
  <refsect1>
24
24
    <title>Syntax</title>
25
25
    <synopsis>kout <command>tabmorphi</command> kindex, kweightpoint, ktabnum1, ktabnum2, \
26
 
      ifn1, ifn2 [, ifn3, ifn4, ... ifnN]</synopsis>
 
26
      ifn1, ifn2 [, ifn3, ifn4, ..., ifnN]</synopsis>
27
27
  </refsect1>
28
28
 
29
29
  <refsect1>
30
30
    <title>Initialization</title>
31
31
    <para>
32
 
      <emphasis>ifn1, ifn2 [, ifn3, ifn4,…ifnN]</emphasis> - function table numbers. This is a set of chosen tables the user want to use in the morphing. All tables must have the same length. Be aware that only two of these tables can be chosen for the morphing at one time. Since it is possible to use non-integer numbers for the <emphasis>ktabnum1</emphasis> and <emphasis>ktabnum2</emphasis> arguments, the morphing is the result from the interpolation between adjacent consecutive tables of the set.
 
32
      <emphasis>ifn1, ifn2 [, ifn3, ifn4, ..., ifnN]</emphasis> - function table numbers. This is a set of chosen tables the user want to use in the morphing. All tables must have the same length. Be aware that only two of these tables can be chosen for the morphing at one time. Since it is possible to use non-integer numbers for the <emphasis>ktabnum1</emphasis> and <emphasis>ktabnum2</emphasis> arguments, the morphing is the result from the interpolation between adjacent consecutive tables of the set.
33
33
    </para>
34
34
  </refsect1>
35
35
 
51
51
      <emphasis>ktabnum2</emphasis> - the second table chosen for the morphing. This number doesn’t express the table number directly, but the position of the table in the set sequence (starting from 0 to N-1). If this number is an integer, corresponding table will be chosen unaltered. If it contains fractional values, then an interpolation with the next adjacent table will result.
52
52
    </para>
53
53
    <para>
54
 
      The <emphasis>tabmorphi</emphasis> family of opcodes is similar to the <link linkend="table"><citetitle>table</citetitle></link> family, but allows morphing between two tables chosen into a set of tables. Firstly the user has to provide a set of tables of equal length (ifn2 [, ifn3, ifn4,…ifnN]). Then he can choose a pair of tables in the set in order to perform the morphing: <emphasis>ktabnum1</emphasis> and <emphasis>ktabnum2</emphasis> are filled with numbers (zero represents the first table in the set, 1 the second, 2 the third and so on). Then determine the morphing between the two chosen tables with the <emphasis>kweightpoint</emphasis> parameter. After that the resulting table can be indexed with the <emphasis>kindex</emphasis> parameter like a normal table opcode. If the value of this parameter surpasses the length of tables (which must be the same for all tables), then it is wrapped around.
 
54
      The <emphasis>tabmorphi</emphasis> family of opcodes is similar to the <link linkend="table"><citetitle>table</citetitle></link> family, but allows morphing between two tables chosen into a set of tables. Firstly the user has to provide a set of tables of equal length (ifn2 [, ifn3, ifn4, ..., ifnN]). Then he can choose a pair of tables in the set in order to perform the morphing: <emphasis>ktabnum1</emphasis> and <emphasis>ktabnum2</emphasis> are filled with numbers (zero represents the first table in the set, 1 the second, 2 the third and so on). Then determine the morphing between the two chosen tables with the <emphasis>kweightpoint</emphasis> parameter. After that the resulting table can be indexed with the <emphasis>kindex</emphasis> parameter like a normal <emphasis>table</emphasis> opcode. If the value of this parameter surpasses the length of tables (which must be the same for all tables), then it is wrapped around.
55
55
    </para>
56
56
    <para>
57
57
      <emphasis>tabmorphi</emphasis> is identical to <link linkend="tabmorph"><citetitle>tabmorph</citetitle></link>, but it performs linear interpolation for non-integer values of <emphasis>kindex</emphasis>, much like <link linkend="tablei"><citetitle>tablei</citetitle></link>.