/[svn]/linuxsampler/trunk/src/engines/common/InstrumentScriptVM.cpp
ViewVC logotype

Annotation of /linuxsampler/trunk/src/engines/common/InstrumentScriptVM.cpp

Parent Directory Parent Directory | Revision Log Revision Log


Revision 3118 - (hide annotations) (download)
Fri Apr 21 13:33:03 2017 UTC (6 years, 11 months ago) by schoenebeck
File size: 15504 byte(s)
* NKSP: Fixed crash when using built-in script array variable "%ALL_EVENTS".
* NKSP: Added built-in function "change_amp_lfo_depth()".
* NKSP: Added built-in function "change_amp_lfo_freq()".
* NKSP: Added built-in function "change_pitch_lfo_depth()".
* NKSP: Added built-in function "change_pitch_lfo_freq()".
* Bumped version (2.0.0.svn44).

1 schoenebeck 2594 /*
2 schoenebeck 3073 * Copyright (c) 2014 - 2017 Christian Schoenebeck
3 schoenebeck 2594 *
4     * http://www.linuxsampler.org
5     *
6     * This file is part of LinuxSampler and released under the same terms.
7     * See README file for details.
8     */
9    
10 schoenebeck 3035 #include "../../common/global_private.h"
11 schoenebeck 2594 #include "InstrumentScriptVM.h"
12     #include "../AbstractEngineChannel.h"
13 schoenebeck 2600 #include "../../common/global_private.h"
14 schoenebeck 2611 #include "AbstractInstrumentManager.h"
15 schoenebeck 2613 #include "MidiKeyboardManager.h"
16 schoenebeck 2594
17     namespace LinuxSampler {
18    
19 schoenebeck 2611 ///////////////////////////////////////////////////////////////////////
20 schoenebeck 2630 // class 'EventGroup'
21    
22     void EventGroup::insert(int eventID) {
23     if (contains(eventID)) return;
24    
25     AbstractEngine* pEngine = m_script->pEngineChannel->pEngine;
26    
27     // before adding the new event ID, check if there are any dead events
28     // and remove them in that case, before otherwise we might run in danger
29     // to run out of free space on this group for event IDs if a lot of
30     // events die before being removed explicitly from the group by script
31     //
32     // NOTE: or should we do this "dead ones" check only once in a while?
33     int firstDead = -1;
34     for (int i = 0; i < size(); ++i) {
35     if (firstDead >= 0) {
36     if (pEngine->EventByID(eventID)) {
37     remove(firstDead, i - firstDead);
38     firstDead = -1;
39     }
40     } else {
41     if (!pEngine->EventByID(eventID)) firstDead = i;
42     }
43     }
44    
45     append(eventID);
46     }
47    
48     void EventGroup::erase(int eventID) {
49     int index = find(eventID);
50     remove(index);
51     }
52    
53     ///////////////////////////////////////////////////////////////////////
54 schoenebeck 2611 // class 'InstrumentScript'
55    
56 schoenebeck 2630 InstrumentScript::InstrumentScript(AbstractEngineChannel* pEngineChannel) {
57     parserContext = NULL;
58     bHasValidScript = false;
59     handlerInit = NULL;
60     handlerNote = NULL;
61     handlerRelease = NULL;
62     handlerController = NULL;
63     pEvents = NULL;
64 schoenebeck 2645 for (int i = 0; i < 128; ++i)
65     pKeyEvents[i] = NULL;
66 schoenebeck 2630 this->pEngineChannel = pEngineChannel;
67     for (int i = 0; i < INSTR_SCRIPT_EVENT_GROUPS; ++i)
68     eventGroups[i].setScript(this);
69     }
70    
71 schoenebeck 2645 InstrumentScript::~InstrumentScript() {
72     resetAll();
73     if (pEvents) {
74     for (int i = 0; i < 128; ++i) delete pKeyEvents[i];
75     delete pEvents;
76     }
77     }
78    
79 schoenebeck 2611 /** @brief Load real-time instrument script.
80     *
81     * Loads the real-time instrument script given by @a text on the engine
82     * channel this InstrumentScript object belongs to (defined by
83     * pEngineChannel member variable). The sampler engine's resource manager is
84     * used to allocate and share equivalent scripts on multiple engine
85     * channels.
86     *
87     * @param text - source code of script
88     */
89     void InstrumentScript::load(const String& text) {
90     dmsg(1,("Loading real-time instrument script ... "));
91    
92     // hand back old script reference and VM execution contexts
93     // (if not done already)
94 schoenebeck 2612 unload();
95 schoenebeck 2611
96 schoenebeck 2612 code = text;
97    
98 schoenebeck 2611 AbstractInstrumentManager* pManager =
99     dynamic_cast<AbstractInstrumentManager*>(pEngineChannel->pEngine->GetInstrumentManager());
100    
101     // get new script reference
102     parserContext = pManager->scripts.Borrow(text, pEngineChannel);
103     if (!parserContext->errors().empty()) {
104     std::vector<ParserIssue> errors = parserContext->errors();
105     std::cerr << "[ScriptVM] Could not load instrument script, there were "
106     << errors.size() << " parser errors:\n";
107     for (int i = 0; i < errors.size(); ++i)
108     errors[i].dump();
109     return; // stop here if there were any parser errors
110     }
111    
112     handlerInit = parserContext->eventHandlerByName("init");
113     handlerNote = parserContext->eventHandlerByName("note");
114     handlerRelease = parserContext->eventHandlerByName("release");
115     handlerController = parserContext->eventHandlerByName("controller");
116     bHasValidScript =
117     handlerInit || handlerNote || handlerRelease || handlerController;
118    
119     // amount of script handlers each script event has to execute
120     int handlerExecCount = 0;
121     if (handlerNote || handlerRelease || handlerController) // only one of these are executed after "init" handler
122     handlerExecCount++;
123    
124     // create script event pool (if it doesn't exist already)
125 schoenebeck 2645 if (!pEvents) {
126 schoenebeck 2611 pEvents = new Pool<ScriptEvent>(CONFIG_MAX_EVENTS_PER_FRAGMENT);
127 schoenebeck 2645 for (int i = 0; i < 128; ++i)
128     pKeyEvents[i] = new RTList<ScriptEvent>(pEvents);
129 schoenebeck 2948 // reset RTAVLNode's tree node member variables after nodes are allocated
130     // (since we can't use a constructor right now, we do that initialization here)
131     while (!pEvents->poolIsEmpty()) {
132     RTList<ScriptEvent>::Iterator it = pEvents->allocAppend();
133     it->reset();
134     }
135     pEvents->clear();
136 schoenebeck 2645 }
137 schoenebeck 2611
138     // create new VM execution contexts for new script
139     while (!pEvents->poolIsEmpty()) {
140     RTList<ScriptEvent>::Iterator it = pEvents->allocAppend();
141     it->execCtx = pEngineChannel->pEngine->pScriptVM->createExecContext(
142     parserContext
143     );
144     it->handlers = new VMEventHandler*[handlerExecCount+1];
145     }
146     pEvents->clear();
147    
148     dmsg(1,("Done\n"));
149     }
150    
151     /** @brief Unload real-time instrument script.
152     *
153     * Unloads the currently used real-time instrument script and frees all
154     * resources allocated for that script. The sampler engine's resource manager
155     * is used to share equivalent scripts among multiple sampler channels, and
156     * to deallocate the parsed script once not used on any engine channel
157     * anymore.
158 schoenebeck 2612 *
159 schoenebeck 2614 * Calling this method will however not clear the @c code member variable.
160 schoenebeck 2612 * Thus, the script can be parsed again afterwards.
161 schoenebeck 2611 */
162 schoenebeck 2612 void InstrumentScript::unload() {
163 schoenebeck 2618 //dmsg(1,("InstrumentScript::unload(this=0x%llx)\n", this));
164    
165 schoenebeck 2611 if (parserContext)
166 schoenebeck 2612 dmsg(1,("Unloading current instrument script.\n"));
167 schoenebeck 2611
168 schoenebeck 2871 resetEvents();
169    
170 schoenebeck 2611 // free allocated VM execution contexts
171     if (pEvents) {
172     pEvents->clear();
173     while (!pEvents->poolIsEmpty()) {
174     RTList<ScriptEvent>::Iterator it = pEvents->allocAppend();
175     if (it->execCtx) {
176     // free VM execution context object
177     delete it->execCtx;
178     it->execCtx = NULL;
179     // free C array of handler pointers
180     delete [] it->handlers;
181     }
182     }
183     pEvents->clear();
184     }
185     // hand back VM representation of script
186     if (parserContext) {
187     AbstractInstrumentManager* pManager =
188     dynamic_cast<AbstractInstrumentManager*>(pEngineChannel->pEngine->GetInstrumentManager());
189    
190     pManager->scripts.HandBack(parserContext, pEngineChannel);
191     parserContext = NULL;
192     handlerInit = NULL;
193     handlerNote = NULL;
194     handlerRelease = NULL;
195     handlerController = NULL;
196     }
197     bHasValidScript = false;
198     }
199    
200 schoenebeck 2612 /**
201     * Same as unload(), but this one also empties the @c code member variable
202     * to an empty string.
203     */
204     void InstrumentScript::resetAll() {
205     unload();
206     code.clear();
207     }
208 schoenebeck 2871
209     /**
210     * Clears all currently active script events. This should be called
211     * whenever the engine or engine channel was reset for some reason.
212     */
213     void InstrumentScript::resetEvents() {
214     for (int i = 0; i < INSTR_SCRIPT_EVENT_GROUPS; ++i)
215     eventGroups[i].clear();
216 schoenebeck 2612
217 schoenebeck 2871 for (int i = 0; i < 128; ++i)
218     if (pKeyEvents[i])
219     pKeyEvents[i]->clear();
220    
221     suspendedEvents.clear();
222    
223     if (pEvents) pEvents->clear();
224     }
225    
226 schoenebeck 2611 ///////////////////////////////////////////////////////////////////////
227     // class 'InstrumentScriptVM'
228    
229 schoenebeck 2596 InstrumentScriptVM::InstrumentScriptVM() :
230 schoenebeck 2600 m_event(NULL), m_fnPlayNote(this), m_fnSetController(this),
231 schoenebeck 2630 m_fnIgnoreEvent(this), m_fnIgnoreController(this), m_fnNoteOff(this),
232 schoenebeck 2931 m_fnSetEventMark(this), m_fnDeleteEventMark(this), m_fnByMarks(this),
233 schoenebeck 2935 m_fnChangeVol(this), m_fnChangeTune(this), m_fnChangePan(this),
234 schoenebeck 2953 m_fnChangeCutoff(this), m_fnChangeReso(this), m_fnChangeAttack(this),
235 schoenebeck 3118 m_fnChangeDecay(this), m_fnChangeRelease(this),
236     m_fnChangeAmpLFODepth(this), m_fnChangeAmpLFOFreq(this),
237     m_fnChangePitchLFODepth(this), m_fnChangePitchLFOFreq(this),
238     m_fnEventStatus(this), m_fnWait2(this), m_fnStopWait(this),
239 schoenebeck 3073 m_varEngineUptime(this), m_varCallbackID(this), m_varAllEvents(this)
240 schoenebeck 2596 {
241 schoenebeck 2595 m_CC.size = _MEMBER_SIZEOF(AbstractEngineChannel, ControllerTable);
242 schoenebeck 2598 m_CC_NUM = DECLARE_VMINT(m_event, class ScriptEvent, cause.Param.CC.Controller);
243 schoenebeck 2948 m_EVENT_ID = DECLARE_VMINT_READONLY(m_event, class ScriptEvent, id);
244 schoenebeck 2598 m_EVENT_NOTE = DECLARE_VMINT(m_event, class ScriptEvent, cause.Param.Note.Key);
245     m_EVENT_VELOCITY = DECLARE_VMINT(m_event, class ScriptEvent, cause.Param.Note.Velocity);
246 schoenebeck 2613 m_KEY_DOWN.size = 128;
247 schoenebeck 2948 m_NI_CALLBACK_TYPE = DECLARE_VMINT_READONLY(m_event, class ScriptEvent, handlerType);
248     m_NKSP_IGNORE_WAIT = DECLARE_VMINT(m_event, class ScriptEvent, ignoreAllWaitCalls);
249 schoenebeck 2594 }
250    
251     VMExecStatus_t InstrumentScriptVM::exec(VMParserContext* parserCtx, ScriptEvent* event) {
252     AbstractEngineChannel* pEngineChannel =
253     static_cast<AbstractEngineChannel*>(event->cause.pEngineChannel);
254    
255     // prepare built-in script variables for script execution
256 schoenebeck 2598 m_event = event;
257 schoenebeck 2594 m_CC.data = (int8_t*) &pEngineChannel->ControllerTable[0];
258 schoenebeck 2613 m_KEY_DOWN.data = &pEngineChannel->GetMidiKeyboardManager()->KeyDown[0];
259 schoenebeck 2594
260     // if script is in start condition, then do mandatory MIDI event
261     // preprocessing tasks, which essentially means updating i.e. controller
262     // table with new CC value in case of a controller event, because the
263     // script might access the new CC value
264     if (!event->executionSlices) {
265 schoenebeck 2598 switch (event->cause.Type) {
266 schoenebeck 2594 case Event::type_control_change:
267 schoenebeck 2598 pEngineChannel->ControllerTable[event->cause.Param.CC.Controller] =
268     event->cause.Param.CC.Value;
269 schoenebeck 2594 break;
270     case Event::type_channel_pressure:
271     pEngineChannel->ControllerTable[CTRL_TABLE_IDX_AFTERTOUCH] =
272 schoenebeck 2598 event->cause.Param.ChannelPressure.Value;
273 schoenebeck 2594 break;
274     case Event::type_pitchbend:
275     pEngineChannel->ControllerTable[CTRL_TABLE_IDX_PITCHBEND] =
276 schoenebeck 2598 event->cause.Param.Pitch.Pitch;
277 schoenebeck 2594 break;
278 schoenebeck 3054 default:
279     ; // noop
280 schoenebeck 2594 }
281     }
282    
283     // run the script handler(s)
284     VMExecStatus_t res = VM_EXEC_NOT_RUNNING;
285 schoenebeck 2596 for ( ; event->handlers[event->currentHandler]; event->currentHandler++) {
286 schoenebeck 2594 res = ScriptVM::exec(
287 schoenebeck 2596 parserCtx, event->execCtx, event->handlers[event->currentHandler]
288 schoenebeck 2594 );
289     event->executionSlices++;
290     if (res & VM_EXEC_SUSPENDED || res & VM_EXEC_ERROR) return res;
291     }
292    
293     return res;
294     }
295    
296     std::map<String,VMIntRelPtr*> InstrumentScriptVM::builtInIntVariables() {
297 schoenebeck 2942 // first get built-in integer variables of derived VM class
298 schoenebeck 2594 std::map<String,VMIntRelPtr*> m = ScriptVM::builtInIntVariables();
299    
300     // now add own built-in variables
301     m["$CC_NUM"] = &m_CC_NUM;
302 schoenebeck 2598 m["$EVENT_ID"] = &m_EVENT_ID;
303 schoenebeck 2594 m["$EVENT_NOTE"] = &m_EVENT_NOTE;
304     m["$EVENT_VELOCITY"] = &m_EVENT_VELOCITY;
305     // m["$POLY_AT_NUM"] = &m_POLY_AT_NUM;
306 schoenebeck 2948 m["$NI_CALLBACK_TYPE"] = &m_NI_CALLBACK_TYPE;
307     m["$NKSP_IGNORE_WAIT"] = &m_NKSP_IGNORE_WAIT;
308 schoenebeck 2594
309     return m;
310     }
311    
312     std::map<String,VMInt8Array*> InstrumentScriptVM::builtInIntArrayVariables() {
313 schoenebeck 2942 // first get built-in integer array variables of derived VM class
314 schoenebeck 2594 std::map<String,VMInt8Array*> m = ScriptVM::builtInIntArrayVariables();
315    
316     // now add own built-in variables
317     m["%CC"] = &m_CC;
318 schoenebeck 2613 m["%KEY_DOWN"] = &m_KEY_DOWN;
319 schoenebeck 2594 //m["%POLY_AT"] = &m_POLY_AT;
320    
321     return m;
322     }
323    
324     std::map<String,int> InstrumentScriptVM::builtInConstIntVariables() {
325 schoenebeck 2942 // first get built-in integer variables of derived VM class
326 schoenebeck 2594 std::map<String,int> m = ScriptVM::builtInConstIntVariables();
327    
328 schoenebeck 2935 m["$EVENT_STATUS_INACTIVE"] = EVENT_STATUS_INACTIVE;
329     m["$EVENT_STATUS_NOTE_QUEUE"] = EVENT_STATUS_NOTE_QUEUE;
330 schoenebeck 2594 m["$VCC_MONO_AT"] = CTRL_TABLE_IDX_AFTERTOUCH;
331     m["$VCC_PITCH_BEND"] = CTRL_TABLE_IDX_PITCHBEND;
332 schoenebeck 2630 for (int i = 0; i < INSTR_SCRIPT_EVENT_GROUPS; ++i) {
333     m["$MARK_" + ToString(i+1)] = i;
334     }
335 schoenebeck 2594
336     return m;
337     }
338    
339 schoenebeck 2942 std::map<String,VMDynVar*> InstrumentScriptVM::builtInDynamicVariables() {
340     // first get built-in dynamic variables of derived VM class
341     std::map<String,VMDynVar*> m = ScriptVM::builtInDynamicVariables();
342    
343 schoenebeck 3073 m["%ALL_EVENTS"] = &m_varAllEvents;
344 schoenebeck 2942 m["$ENGINE_UPTIME"] = &m_varEngineUptime;
345 schoenebeck 2948 m["$NI_CALLBACK_ID"] = &m_varCallbackID;
346 schoenebeck 2942
347     return m;
348     }
349    
350 schoenebeck 2596 VMFunction* InstrumentScriptVM::functionByName(const String& name) {
351     // built-in script functions of this class
352 schoenebeck 2598 if (name == "play_note") return &m_fnPlayNote;
353 schoenebeck 2600 else if (name == "set_controller") return &m_fnSetController;
354 schoenebeck 2598 else if (name == "ignore_event") return &m_fnIgnoreEvent;
355     else if (name == "ignore_controller") return &m_fnIgnoreController;
356 schoenebeck 2629 else if (name == "note_off") return &m_fnNoteOff;
357 schoenebeck 2630 else if (name == "set_event_mark") return &m_fnSetEventMark;
358     else if (name == "delete_event_mark") return &m_fnDeleteEventMark;
359     else if (name == "by_marks") return &m_fnByMarks;
360 schoenebeck 2931 else if (name == "change_vol") return &m_fnChangeVol;
361     else if (name == "change_tune") return &m_fnChangeTune;
362     else if (name == "change_pan") return &m_fnChangePan;
363 schoenebeck 2935 else if (name == "change_cutoff") return &m_fnChangeCutoff;
364     else if (name == "change_reso") return &m_fnChangeReso;
365 schoenebeck 2953 else if (name == "change_attack") return &m_fnChangeAttack;
366     else if (name == "change_decay") return &m_fnChangeDecay;
367     else if (name == "change_release") return &m_fnChangeRelease;
368 schoenebeck 3118 else if (name == "change_amp_lfo_depth") return &m_fnChangeAmpLFODepth;
369     else if (name == "change_amp_lfo_freq") return &m_fnChangeAmpLFOFreq;
370     else if (name == "change_pitch_lfo_depth") return &m_fnChangePitchLFODepth;
371     else if (name == "change_pitch_lfo_freq") return &m_fnChangePitchLFOFreq;
372 schoenebeck 2935 else if (name == "event_status") return &m_fnEventStatus;
373 schoenebeck 2948 else if (name == "wait") return &m_fnWait2; // override wait() core implementation
374     else if (name == "stop_wait") return &m_fnStopWait;
375 schoenebeck 2596
376     // built-in script functions of derived VM class
377     return ScriptVM::functionByName(name);
378     }
379    
380 schoenebeck 2594 } // namespace LinuxSampler

  ViewVC Help
Powered by ViewVC