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

Annotation of /doc/docbase/instrument_scripts/nksp/reference/functions/nksp_note_off_function.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2732 - (hide annotations) (download) (as text)
Sun Apr 26 20:54:00 2015 UTC (8 years, 11 months ago) by schoenebeck
File MIME type: text/html
File size: 2125 byte(s)
* Initial import of doc.linuxsampler.org.

1 schoenebeck 2732 <html>
2     <head>
3     <meta name="author" content="Christian Schoenebeck">
4     <title>note_off() function</title>
5     <meta name="description" content="Releases the requested note.">
6     </head>
7     <body>
8     <h1>note_off()</h1>
9     <p>
10     Releases a note by passing the note's event ID to this function.
11     This is almost like sending a MIDI note off event programmatically, however
12     a call to this function will only affect one single note instead.
13     </p>
14     <p>
15     The argument this function takes is optional. If you omit passing an
16     argument to this function, then the controller event ID will be used that
17     caused this current <code>controller</code> event handler to be executed.
18     </p>
19     <p>
20     There is also an <code>ignore_event()</code> function. With
21     NKSP the two functions are both doing the same thing though.
22     The two exist merely due to compatibility reasons with KSP.
23     </p>
24    
25     <h3>Function Prototype</h3>
26     <p/>
27     <code>
28     note_off(??event-id??, [??velocity??])
29     </code>
30    
31     <h3>Arguments</h3>
32     <table>
33     <tr>
34     <th>Argument Name</th> <th>Data Type</th> <th>Description</th>
35     </tr>
36     <tr>
37     <td><code>??event-id??</code></td>
38     <td>Event ID Number or Event ID Array</td>
39     <td>Event ID(s) of the note(s) to be released.<br>
40     [required]</td>
41     </tr>
42     <tr>
43     <td><code>??velocity??</code></td>
44     <td>Integer Number</td>
45     <td>MIDI note off velocity value.<br>
46     [optional, default: 127]</td>
47     </tr>
48     </table>
49    
50     <h3>Return Value</h3>
51     <p>None.</p>
52    
53     <h3>Examples</h3>
54     <p>None yet.<p>
55    
56     <note>
57     Passing an array of event IDs is only supported by NKSP. If you want
58     to keep compatibility to KSP, then you should only pass a single
59     event ID to this function.
60     </note>
61    
62     <note>
63     The second argument of this function <code>??velocity??</code> is only
64     supported by NKSP. If you want to keep compatibility with KSP, then you
65     should only pass one argument to this function.
66     </note>
67    
68     </body>
69     </html>

  ViewVC Help
Powered by ViewVC