/[svn]/doc/docbase/instrument_scripts/nksp/reference/functions/nksp_change_tune_function.html
ViewVC logotype

Diff of /doc/docbase/instrument_scripts/nksp/reference/functions/nksp_change_tune_function.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2933 by schoenebeck, Sat Jul 9 15:58:09 2016 UTC revision 3233 by schoenebeck, Sun May 28 16:09:56 2017 UTC
# Line 16  Line 16 
16        all layers.        all layers.
17      </p>      </p>
18      <p>      <p>
19          Internally the sampler always fades the tuning from its current value to
20          the new tuning as requested, however that tuning fade by default is so fast
21          that it sounds like its value jumps directly from its old to the new value.
22          You may also override that automated fade time explicitly by calling
23          <code lang="nksp">change_tune_time()</code> before calling the
24          <code lang="nksp">change_tune()</code> function.
25        </p>
26        <p>
27        The tuning changes set by calling this function are always applied relatively to        The tuning changes set by calling this function are always applied relatively to
28        the tuning/pitch calculated by the synthesis model and sampler format. That means        the tuning/pitch calculated by the synthesis model and sampler format. That means
29        the various sources of tuning/pitch factors like MIDI pitch bend wheel, Pitch Envelopes,        the various sources of tuning/pitch factors like MIDI pitch bend wheel, Pitch Envelopes,
# Line 50  change_tune(??note??, ??tuning??, [??rel Line 58  change_tune(??note??, ??tuning??, [??rel
58        </tr>        </tr>
59        <tr>        <tr>
60          <td><code>??note??</code></td>          <td><code>??note??</code></td>
61          <td>Note ID Number</td>          <td>Note ID Number or Note ID Array</td>
62          <td>All voices of this note will be modified.<br>          <td>All voices of this note will be modified.<br>
63              [required]</td>              [required]</td>
64        </tr>        </tr>
# Line 59  change_tune(??note??, ??tuning??, [??rel Line 67  change_tune(??note??, ??tuning??, [??rel
67          <td>Integer Number</td>          <td>Integer Number</td>
68          <td>Tuning change in milli cents.          <td>Tuning change in milli cents.
69              A positive value increases the tuning,              A positive value increases the tuning,
70              a negative value decreases the tuning.</td>              a negative value decreases the tuning.<br>
71                [required]</td>
72        </tr>        </tr>
73        <tr>        <tr>
74          <td><code>??relative??</code></td>          <td><code>??relative??</code></td>
75          <td>Integer Number</td>          <td>Integer Number</td>
76          <td>Whether change_tune() calls should be relative to each other.<br>          <td>Whether change_tune() calls should be relative to each other.<br>
77              0: A call to <code>change_tune()</code> upon the same note will              <code>0</code>: A call to <code>change_tune()</code> upon the same note will
78                 replace the tuning change value set by previous                 replace the tuning change value set by previous
79                 <code>change_tune()</code> calls upon the same note.<br>                 <code>change_tune()</code> calls upon the same note.<br>
80              1: Successive calls to <code>change_tune()</code> upon the same              <code>1</code>: Successive calls to <code>change_tune()</code> upon the same
81                 note will be relatively applied against each other.<br>                 note will be relatively applied against each other.<br>
82              [optional, default: 0]</td>              [optional, default: <code>0</code>]</td>
83        </tr>        </tr>
84      </table>      </table>
85    
# Line 80  change_tune(??note??, ??tuning??, [??rel Line 89  change_tune(??note??, ??tuning??, [??rel
89      <h3>Examples</h3>      <h3>Examples</h3>
90      <p>None yet.<p>      <p>None yet.<p>
91    
92      <h3>Availabilty</h3>      <h3>See also</h3>
93        <p><code>change_tune_time()</code><p>
94    
95        <h3>Availability</h3>
96      <p>Since LinuxSampler 2.0.0.svn11.<p>      <p>Since LinuxSampler 2.0.0.svn11.<p>
97    
98        <note>
99          The third argument of this function <code>??relative??</code> is only
100          optional with NKSP. If you want to keep compatibility with KSP, then you
101          should always pass a value for that third argument of this function.
102        </note>
103        
104    </body>    </body>
105  </html>  </html>
Legend:
Removed from v.2933  
changed lines
  Added in v.3233
  ViewVC Help
Powered by ViewVC