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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2872 - (hide annotations) (download) (as text)
Sun Apr 10 18:42:55 2016 UTC (7 years, 11 months ago) by schoenebeck
File MIME type: text/html
File size: 2908 byte(s)
* NKSP docs: updated articles regarding recent development changes of
  the "wait()" and "play_note()" built-in script function
  implementations.

1 schoenebeck 2732 <html>
2     <head>
3     <meta name="author" content="Christian Schoenebeck">
4     <title>wait() function</title>
5     <meta name="description" content="Pauses execution for a certain amount of time.">
6     </head>
7     <body>
8     <h1>wait()</h1>
9     <p>
10     Suspends / pauses the current event handler instance for the requested
11     amount of microseconds.
12     </p>
13    
14     <h3>Function Prototype</h3>
15     <p/>
16 schoenebeck 2742 <code lang="nksp">
17 schoenebeck 2732 wait(??duration-us??)
18     </code>
19    
20     <h3>Arguments</h3>
21     <table>
22     <tr>
23     <th>Argument Name</th> <th>Data Type</th> <th>Description</th>
24     </tr>
25     <tr>
26     <td><code>??duration-us??</code></td>
27     <td>Integer Number</td>
28     <td>Amount of microseconds to pause execution.<br>
29     [required]</td>
30     </tr>
31     </table>
32    
33     <h3>Return Value</h3>
34     <p>None.</p>
35    
36     <h3>Examples</h3>
37     <p/>
38     <code>
39     on init
40     { The amount of notes to play }
41     declare const $delayNotes := 4
42     { Tempo with which the new notes will follow the orignal note }
43     declare const $bpm := 90
44     { Convert BPM to microseconds (duration between the notes) }
45     declare const $delayMicroSeconds := 60 * 1000000 / $bpm
46     { Just a working variable for being used with the while loop below }
47     declare polyphonic $i
48     { For each successive note we trigger, we will reduce the velocity a bit}
49     declare polyphonic $velocity
50     end on
51    
52     on note
53     { First initialize the variable $i with 4 each time we enter this event
54     handler, because each time we executed this handler, the variable will be 0 }
55     $i := $delayNotes
56    
57     { Loop which will be executed 4 times in a row }
58     while ($i)
59     { Calculate the velocity for the next note being triggered }
60     $velocity := 127 * $i / ($delayNotes + 1)
61     { Suspend this script for a short moment ... }
62     wait($delayMicroSeconds)
63     { ... and after that short break, trigger a new note. }
64     play_note($EVENT_NOTE, $velocity)
65     { Decrement loop counter $i by one }
66     $i := $i - 1
67     end while
68     end on
69     </code>
70    
71 schoenebeck 2872 <note>
72 schoenebeck 2732 Using the <code>wait()</code> function can lead to concurrency issues with
73     regular variables, which are global variables by default. You might need
74     to use <a href="nksp.html#polyphonic_variables">polyphonic variables</a>
75     in such cases.
76     </note>
77    
78 schoenebeck 2872 <note>
79     You need at least LinuxSampler 2.0.0.svn2 or higher for the
80     <code>wait()</code> function to fully work as expected. Versions
81     of LinuxSampler older than that will not resume the script at the
82     requested amount of time, instead those older version will resume
83     the script always at the beginning of the next audio fragment
84     cycle. So effectively a <code>wait()</code> call with a LinuxSampler
85     version older than 2.0.0.svn2 will pause your script for a few
86     miliseconds, no matter which function argument you provided.
87 schoenebeck 2732 </note>
88    
89     </body>
90     </html>

  ViewVC Help
Powered by ViewVC