reference/functions/nksp_change_velo_function.html

<html>
  <head>
    <meta name="author" content="Christian Schoenebeck">
    <title>change_velo() function</title>
    <meta name="description" content="Change MIDI velocity of note.">
  </head>
  <body>
    <h1>change_velo()</h1>
    <p>
      Changes the MIDI velocity of the requested note.
    </p>
    <p>
      Changing the velocity with this function only succeeds if the 
      respective note is new. That effectively means you should change the
      velocity before any <code lang="nksp">wait()</code> calls, and before
      entering any loops that may execute your script for a very long time.
      Because in both cases the sampler may suspend your script for a certain
      amount of time and once your script got resumed, the respective event
      and the resulting note may already have entered the sampler's regular
      event processing chain and thus the note's velocity can no longer be
      changed.
    </p>

    <h3>Function Prototype</h3>
    <p/>
    <code>
change_velo(??event-id??, ??velocity??)
    </code>

    <h3>Arguments</h3>
    <table>
      <tr>
        <th>Argument Name</th> <th>Data Type</th> <th>Description</th>
      </tr>
      <tr>
        <td><code>??event-id??</code></td>
        <td>Event ID Number</td>
        <td>Event ID of the note to change.<br>
            [required]</td>
      </tr>
      <tr>
        <td><code>??velocity??</code></td>
        <td>Integer Number</td>
        <td>New MIDI velocity (<code>1</code> to <code>127</code>).<br>
            [required]</td>
      </tr>
    </table>
    
    <h3>Return Value</h3>
    <p>None.</p>
    
    <h3>Examples</h3>
    <p>None yet.</p>

    <h3>See also</h3>
    <p><code>set_event_par()</code>, <code>change_note()</code><p>

    <h3>Availability</h3>
    <p>Since LinuxSampler 2.0.0.svn49.<p>

  </body>
</html>
1	schoenebeck	3215	<html>
2			<head>
3			<meta name="author" content="Christian Schoenebeck">
4			<title>change_velo() function</title>
5			<meta name="description" content="Change MIDI velocity of note.">
6			</head>
7			<body>
8			<h1>change_velo()</h1>
9			<p>
10			Changes the MIDI velocity of the requested note.
11			</p>
12			<p>
13			Changing the velocity with this function only succeeds if the
14			respective note is new. That effectively means you should change the
15			velocity before any <code lang="nksp">wait()</code> calls, and before
16			entering any loops that may execute your script for a very long time.
17			Because in both cases the sampler may suspend your script for a certain
18			amount of time and once your script got resumed, the respective event
19			and the resulting note may already have entered the sampler's regular
20			event processing chain and thus the note's velocity can no longer be
21			changed.
22			</p>
23
24			<h3>Function Prototype</h3>
25			<p/>
26			<code>
27			change_velo(??event-id??, ??velocity??)
28			</code>
29
30			<h3>Arguments</h3>
31			<table>
32			<tr>
33			<th>Argument Name</th> <th>Data Type</th> <th>Description</th>
34			</tr>
35			<tr>
36			<td><code>??event-id??</code></td>
37			<td>Event ID Number</td>
38			<td>Event ID of the note to change.<br>
39			[required]</td>
40			</tr>
41			<tr>
42			<td><code>??velocity??</code></td>
43			<td>Integer Number</td>
44			<td>New MIDI velocity (<code>1</code> to <code>127</code>).<br>
45			[required]</td>
46			</tr>
47			</table>
48
49			<h3>Return Value</h3>
50			<p>None.</p>
51
52			<h3>Examples</h3>
53			<p>None yet.</p>
54
55			<h3>See also</h3>
56			<p><code>set_event_par()</code>, <code>change_note()</code><p>
57
58			<h3>Availability</h3>
59			<p>Since LinuxSampler 2.0.0.svn49.<p>
60
61			</body>
62			</html>