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

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

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

revision 2932 by schoenebeck, Sat Jul 9 14:41:00 2016 UTC revision 3196 by schoenebeck, Sat May 20 14:27:01 2017 UTC
# Line 16  Line 16 
16        all layers.        all layers.
17      </p>      </p>
18      <p>      <p>
19        The volume changes set by calling function are always applied relatively to        Internally the sampler always fades the volume from its current value to
20          the new volume as requested, however that volume fade by default is so fast
21          that it sounds like its value jumps directly from its old to the new value,
22          it is yet slow enough though to avoid undesired click sounds. You may also
23          override that automated fade time explicitly by calling
24          <code lang="nksp">change_vol_time()</code> before calling the
25          <code lang="nksp">change_vol()</code> function.
26        </p>
27        <p>
28          The volume changes set by calling this function are always applied relatively to
29        the volume calculated by the synthesis model and sampler format. That means        the volume calculated by the synthesis model and sampler format. That means
30        the various sources of volume factors like MIDI CC #7, Amplitute Envelopes,        the various sources of volume factors like MIDI CC #7, Amplitute Envelopes,
31        Amplitutude LFOs and other volume factors that may be defined by the        Amplitutude LFOs and other volume factors that may be defined by the
# Line 50  change_vol(??note??, ??volume??, [??rela Line 59  change_vol(??note??, ??volume??, [??rela
59        </tr>        </tr>
60        <tr>        <tr>
61          <td><code>??note??</code></td>          <td><code>??note??</code></td>
62          <td>Note ID Number</td>          <td>Note ID Number or Note ID Array</td>
63          <td>All voices of this note will be modified.<br>          <td>All voices of this note will be modified.<br>
64              [required]</td>              [required]</td>
65        </tr>        </tr>
# Line 59  change_vol(??note??, ??volume??, [??rela Line 68  change_vol(??note??, ??volume??, [??rela
68          <td>Integer Number</td>          <td>Integer Number</td>
69          <td>Volume change in Milli dB.          <td>Volume change in Milli dB.
70              A positive value increases the volume,              A positive value increases the volume,
71              a negative value decreases the volume.</td>              a negative value decreases the volume.<br>
72                [required]</td>
73        </tr>        </tr>
74        <tr>        <tr>
75          <td><code>??relative??</code></td>          <td><code>??relative??</code></td>
# Line 79  change_vol(??note??, ??volume??, [??rela Line 89  change_vol(??note??, ??volume??, [??rela
89    
90      <h3>Examples</h3>      <h3>Examples</h3>
91      <p>None yet.<p>      <p>None yet.<p>
92        
93        <h3>See also</h3>
94        <p><code>change_vol_time()</code>, <code>fade_in()</code>, <code>fade_out()</code><p>
95    
96      <h3>Availabilty</h3>      <h3>Availability</h3>
97      <p>Since LinuxSampler 2.0.0.svn11.<p>      <p>Since LinuxSampler 2.0.0.svn11.<p>
98    
99        <note>
100          The third argument of this function <code>??relative??</code> is only
101          optional with NKSP. If you want to keep compatibility with KSP, then you
102          should always pass a value for that third argument of this function.
103        </note>
104    
105    </body>    </body>
106  </html>  </html>
Legend:
Removed from v.2932  
changed lines
  Added in v.3196
  ViewVC Help
Powered by ViewVC