/[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 3252 - (hide annotations) (download) (as text)
Mon May 29 22:42:46 2017 UTC (6 years, 10 months ago) by schoenebeck
File MIME type: text/html
File size: 2128 byte(s)
* NKSP: Updated play_note() function.

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 schoenebeck 2940 a call to this function will only release one single note instead,
13 schoenebeck 2941 a call to this function does not cause a <code lang="nksp">release</code>
14 schoenebeck 2940 event handler to be executed, nor will any MIDI specific note-off handling
15     be done (i.e. it will have no effect on the status of built-in array variable
16     <code>%KEY_DOWN[]</code>).
17 schoenebeck 2732 </p>
18    
19     <h3>Function Prototype</h3>
20     <p/>
21     <code>
22     note_off(??event-id??, [??velocity??])
23     </code>
24    
25     <h3>Arguments</h3>
26     <table>
27     <tr>
28     <th>Argument Name</th> <th>Data Type</th> <th>Description</th>
29     </tr>
30     <tr>
31     <td><code>??event-id??</code></td>
32     <td>Event ID Number or Event ID Array</td>
33 schoenebeck 2940 <td>Note ID(s) of the note(s) to be released.<br>
34 schoenebeck 2732 [required]</td>
35     </tr>
36     <tr>
37     <td><code>??velocity??</code></td>
38     <td>Integer Number</td>
39     <td>MIDI note off velocity value.<br>
40 schoenebeck 3235 [optional, default: <code>127</code>]</td>
41 schoenebeck 2732 </tr>
42     </table>
43    
44     <h3>Return Value</h3>
45     <p>None.</p>
46    
47     <h3>Examples</h3>
48     <p>None yet.<p>
49    
50 schoenebeck 3252 <h3>See also</h3>
51     <p><code>ignore_event()</code>, <code>play_note()</code>, <code>set_controller()</code><p>
52    
53     <h3>Availability</h3>
54     <p>Since LinuxSampler 2.0.0<p>
55    
56 schoenebeck 2732 <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