8 |
<h1>play_note()</h1> |
<h1>play_note()</h1> |
9 |
<p> |
<p> |
10 |
Triggers a new note to be played by the sampler. This is like generating |
Triggers a new note to be played by the sampler. This is like generating |
11 |
a new MIDI note-on event programmatically. |
a new MIDI note-on event programmatically, with the difference though |
12 |
|
that triggering a note programmatically this way does not cause a |
13 |
|
<code>note</code> event handler to be executed for the new note. |
14 |
</p> |
</p> |
15 |
|
|
16 |
<h3>Function Prototype</h3> |
<h3>Function Prototype</h3> |
47 |
<td>Integer Number</td> |
<td>Integer Number</td> |
48 |
<td>Length of the note to be played in microseconds.<br> |
<td>Length of the note to be played in microseconds.<br> |
49 |
-1: The note will be stopped when the event |
-1: The note will be stopped when the event |
50 |
handler's note stops.<br> |
handler's note stops (must only be used with |
51 |
|
<code>note</code> event handlers).<br> |
52 |
0: The entire note's sample will be played to its end.<br> |
0: The entire note's sample will be played to its end.<br> |
53 |
[optional, default: 0]</td> |
[optional, default: 0]</td> |
54 |
</tr> |
</tr> |
56 |
|
|
57 |
<note> |
<note> |
58 |
You need at least LinuxSampler 2.0.0.svn2 or higher for passing a value |
You need at least LinuxSampler 2.0.0.svn2 or higher for passing a value |
59 |
higher than <code>0</code> for <code>??duration-us??</code>. |
higher than <code>0</code> for <code>??duration-us??</code>, and you need |
60 |
|
at least LinuxSampler 2.0.0.svn3 or higher for passing <code>-1</code> for |
61 |
|
<code>??duration-us??</code>. |
62 |
</note> |
</note> |
63 |
|
|
64 |
<note class="important"> |
<note class="important"> |
65 |
Passing <code>-1</code> for <code>??duration-us??</code> is not |
Passing any other value than <code>0</code> for <code>??offset-us??</code> |
66 |
supported by LinuxSampler yet. |
is not supported by LinuxSampler yet. |
67 |
</note> |
</note> |
68 |
|
|
69 |
<h3>Return Value</h3> |
<h3>Return Value</h3> |