/[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 2742 - (hide annotations) (download) (as text)
Wed Apr 29 00:22:59 2015 UTC (8 years, 11 months ago) by schoenebeck
File MIME type: text/html
File size: 2137 byte(s)
- Fixed code lang attribute in all NKSP reference articles.

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 schoenebeck 2742 caused this current <code lang="nksp">controller</code> event handler to be executed.
18 schoenebeck 2732 </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