23 |
namespace LinuxSampler { |
namespace LinuxSampler { |
24 |
|
|
25 |
/** |
/** |
26 |
|
* Native data type used by the script engine both internally, as well as |
27 |
|
* for all integer data types used by scripts (i.e. for all $foo variables |
28 |
|
* in NKSP scripts). Note that this is different from the original KSP which |
29 |
|
* is limited to 32 bit for integer variables in KSP scripts. |
30 |
|
*/ |
31 |
|
typedef int64_t vmint; |
32 |
|
|
33 |
|
/** |
34 |
|
* Native data type used internally by the script engine for all unsigned |
35 |
|
* integer types. This type is currently not exposed to scripts. |
36 |
|
*/ |
37 |
|
typedef uint64_t vmuint; |
38 |
|
|
39 |
|
/** |
40 |
|
* Native data type used by the script engine both internally for floating |
41 |
|
* point data, as well as for all @c real data types used by scripts (i.e. |
42 |
|
* for all ~foo variables in NKSP scripts). |
43 |
|
*/ |
44 |
|
typedef float vmfloat; |
45 |
|
|
46 |
|
/** |
47 |
* Identifies the type of a noteworthy issue identified by the script |
* Identifies the type of a noteworthy issue identified by the script |
48 |
* parser. That's either a parser error or parser warning. |
* parser. That's either a parser error or parser warning. |
49 |
*/ |
*/ |
65 |
INT_ARR_EXPR, ///< integer array expression |
INT_ARR_EXPR, ///< integer array expression |
66 |
STRING_EXPR, ///< string expression |
STRING_EXPR, ///< string expression |
67 |
STRING_ARR_EXPR, ///< string array expression |
STRING_ARR_EXPR, ///< string array expression |
68 |
|
REAL_EXPR, ///< floating point (scalar) expression |
69 |
|
REAL_ARR_EXPR, ///< floating point array expression |
70 |
}; |
}; |
71 |
|
|
72 |
/** @brief Result flags of a script statement or script function call. |
/** @brief Result flags of a script statement or script function call. |
104 |
* |
* |
105 |
* Identifies one of the possible event handler callback types defined by |
* Identifies one of the possible event handler callback types defined by |
106 |
* the NKSP script language. |
* the NKSP script language. |
107 |
|
* |
108 |
|
* IMPORTANT: this type is forced to be emitted as int32_t type ATM, because |
109 |
|
* that's the native size expected by the built-in instrument script |
110 |
|
* variable bindings (see occurrences of VMInt32RelPtr and DECLARE_VMINT |
111 |
|
* respectively. A native type mismatch between the two could lead to |
112 |
|
* undefined behavior! Background: By definition the C/C++ compiler is free |
113 |
|
* to choose a bit size for individual enums which it might find |
114 |
|
* appropriate, which is usually decided by the compiler according to the |
115 |
|
* biggest enum constant value defined (in practice it is usually 32 bit). |
116 |
*/ |
*/ |
117 |
enum VMEventHandlerType_t { |
enum VMEventHandlerType_t : int32_t { |
118 |
VM_EVENT_HANDLER_INIT, ///< Initilization event handler, that is script's "on init ... end on" code block. |
VM_EVENT_HANDLER_INIT, ///< Initilization event handler, that is script's "on init ... end on" code block. |
119 |
VM_EVENT_HANDLER_NOTE, ///< Note event handler, that is script's "on note ... end on" code block. |
VM_EVENT_HANDLER_NOTE, ///< Note event handler, that is script's "on note ... end on" code block. |
120 |
VM_EVENT_HANDLER_RELEASE, ///< Release event handler, that is script's "on release ... end on" code block. |
VM_EVENT_HANDLER_RELEASE, ///< Release event handler, that is script's "on release ... end on" code block. |
121 |
VM_EVENT_HANDLER_CONTROLLER, ///< Controller event handler, that is script's "on controller ... end on" code block. |
VM_EVENT_HANDLER_CONTROLLER, ///< Controller event handler, that is script's "on controller ... end on" code block. |
122 |
}; |
}; |
123 |
|
|
124 |
|
/** |
125 |
|
* All metric unit prefixes (actually just scale factors) supported by this |
126 |
|
* script engine. |
127 |
|
*/ |
128 |
|
enum MetricPrefix_t { |
129 |
|
VM_NO_PREFIX = 0, ///< = 1 |
130 |
|
VM_KILO, ///< = 10^3, short 'k' |
131 |
|
VM_HECTO, ///< = 10^2, short 'h' |
132 |
|
VM_DECA, ///< = 10, short 'da' |
133 |
|
VM_DECI, ///< = 10^-1, short 'd' |
134 |
|
VM_CENTI, ///< = 10^-2, short 'c' (this is also used for tuning "cents") |
135 |
|
VM_MILLI, ///< = 10^-3, short 'm' |
136 |
|
VM_MICRO, ///< = 10^-6, short 'u' |
137 |
|
}; |
138 |
|
|
139 |
|
/** |
140 |
|
* All measurement unit types supported by this script engine. |
141 |
|
* |
142 |
|
* @e Note: there is no standard unit "cents" here (for pitch/tuning), use |
143 |
|
* @c VM_CENTI for the latter instad. That's because the commonly cited |
144 |
|
* "cents" unit is actually no measurement unit type but rather a metric |
145 |
|
* unit prefix. |
146 |
|
* |
147 |
|
* @see MetricPrefix_t |
148 |
|
*/ |
149 |
|
enum StdUnit_t { |
150 |
|
VM_NO_UNIT = 0, ///< No unit used, the number is just an abstract number. |
151 |
|
VM_SECOND, ///< Measuring time. |
152 |
|
VM_HERTZ, ///< Measuring frequency. |
153 |
|
VM_BEL, ///< Measuring relation between two energy levels (in logarithmic scale). Since we are using it for accoustics, we are always referring to A-weighted Bels (i.e. dBA). |
154 |
|
}; |
155 |
|
|
156 |
// just symbol prototyping |
// just symbol prototyping |
157 |
class VMIntExpr; |
class VMIntExpr; |
158 |
|
class VMRealExpr; |
159 |
class VMStringExpr; |
class VMStringExpr; |
160 |
|
class VMScalarNumberExpr; |
161 |
class VMIntArrayExpr; |
class VMIntArrayExpr; |
162 |
|
class VMRealArrayExpr; |
163 |
class VMStringArrayExpr; |
class VMStringArrayExpr; |
164 |
class VMParserContext; |
class VMParserContext; |
165 |
|
|
166 |
|
/** @brief Virtual machine measuring unit. |
167 |
|
* |
168 |
|
* Abstract base class representing standard measurement units throughout |
169 |
|
* the script engine. These might be i.e. "dB" (deci Bel) for loudness, |
170 |
|
* "Hz" (Hertz) for frequencies or "s" for "seconds". |
171 |
|
* |
172 |
|
* Originally the script engine only supported abstract integer values for |
173 |
|
* controlling any synthesis parameter or built-in function argument or |
174 |
|
* variable. Under certain situations it makes sense though for an |
175 |
|
* instrument script author to provide values in real, standard measurement |
176 |
|
* units, for example setting the frequency of some LFO directly to "20Hz". |
177 |
|
* Hence support for standard units in scripts was added as an extension to |
178 |
|
* the NKSP script engine. |
179 |
|
*/ |
180 |
|
class VMUnit { |
181 |
|
public: |
182 |
|
/** |
183 |
|
* Returns the metric prefix of this unit. A metric prefix essentially |
184 |
|
* is just a mathematical scale factor that should be applied to the |
185 |
|
* number associated with the measurement unit. Usually a unit either |
186 |
|
* has exactly none or one prefix, but note that there might also be |
187 |
|
* units with more than one prefix, for example mdB (mili deci bel) |
188 |
|
* is used sometimes which has two prefixes. This is an exception though |
189 |
|
* and more than two prefixes is currently not supported by the script |
190 |
|
* engine. |
191 |
|
* |
192 |
|
* Start iterating over the prefixes of this unit by passing @c 0 as |
193 |
|
* argument to this method. The prefixes are terminated with return |
194 |
|
* value VM_NO_PREFIX being always the last element. |
195 |
|
* |
196 |
|
* @param i - index of prefix |
197 |
|
* @returns prefix of requested index or VM_NO_PREFIX otherwise |
198 |
|
* @see unitFactor() |
199 |
|
*/ |
200 |
|
virtual MetricPrefix_t unitPrefix(vmuint i) const = 0; |
201 |
|
|
202 |
|
/** |
203 |
|
* Conveniently returns the final mathematical factor that should be |
204 |
|
* multiplied against the number associated with this unit. This factor |
205 |
|
* results from the sequence of metric prefixes of this unit. |
206 |
|
* |
207 |
|
* @see unitPrefix() |
208 |
|
*/ |
209 |
|
vmfloat unitFactor() const; |
210 |
|
|
211 |
|
/** |
212 |
|
* This is the actual fundamental measuring unit base type of this unit, |
213 |
|
* which might be either Hertz, second or Bel. |
214 |
|
* |
215 |
|
* @returns standard unit type identifier or VM_NO_UNIT if no unit used |
216 |
|
*/ |
217 |
|
virtual StdUnit_t unitType() const = 0; |
218 |
|
|
219 |
|
/** |
220 |
|
* Returns the actual mathematical factor represented by the passed |
221 |
|
* @a prefix argument. |
222 |
|
*/ |
223 |
|
static vmfloat unitFactor(MetricPrefix_t prefix); |
224 |
|
|
225 |
|
/** |
226 |
|
* Returns the actual mathematical factor represented by the passed |
227 |
|
* two @a prefix1 and @a prefix2 arguments. |
228 |
|
*/ |
229 |
|
static vmfloat unitFactor(MetricPrefix_t prefix1, MetricPrefix_t prefix2); |
230 |
|
}; |
231 |
|
|
232 |
/** @brief Virtual machine expression |
/** @brief Virtual machine expression |
233 |
* |
* |
234 |
* This is the abstract base class for all expressions of scripts. |
* This is the abstract base class for all expressions of scripts. |
260 |
* if this expression is i.e. actually a string expression like "12", |
* if this expression is i.e. actually a string expression like "12", |
261 |
* calling asInt() will @b not cast that numerical string expression to |
* calling asInt() will @b not cast that numerical string expression to |
262 |
* an integer expression 12 for you, instead this method will simply |
* an integer expression 12 for you, instead this method will simply |
263 |
* return NULL! |
* return NULL! Same applies if this expression is actually a real |
264 |
|
* number expression: asInt() would return NULL in that case as well. |
265 |
* |
* |
266 |
* @see exprType() |
* @see exprType(), asReal(), asScalarNumberExpr() |
267 |
*/ |
*/ |
268 |
VMIntExpr* asInt() const; |
VMIntExpr* asInt() const; |
269 |
|
|
270 |
/** |
/** |
271 |
|
* In case this expression is a real number (floating point) expression, |
272 |
|
* then this method returns a casted pointer to that VMRealExpr object. |
273 |
|
* It returns NULL if this expression is not a real number expression. |
274 |
|
* |
275 |
|
* @b Note: type casting performed by this method is strict! That means |
276 |
|
* if this expression is i.e. actually a string expression like "12", |
277 |
|
* calling asReal() will @b not cast that numerical string expression to |
278 |
|
* a real number expression 12.0 for you, instead this method will |
279 |
|
* simply return NULL! Same applies if this expression is actually an |
280 |
|
* integer expression: asReal() would return NULL in that case as well. |
281 |
|
* |
282 |
|
* @see exprType(), asInt(), asScalarNumberExpr() |
283 |
|
*/ |
284 |
|
VMRealExpr* asReal() const; |
285 |
|
|
286 |
|
/** |
287 |
|
* In case this expression is a scalar number expression, that is either |
288 |
|
* an integer (scalar) expression or a real number (floating point |
289 |
|
* scalar) expression, then this method returns a casted pointer to that |
290 |
|
* VMScalarNumberExpr base class object. It returns NULL if this |
291 |
|
* expression is neither an integer (scalar), nor a real number (scalar) |
292 |
|
* expression. |
293 |
|
* |
294 |
|
* Since the methods asInt() and asReal() are very strict, this method |
295 |
|
* is provided as convenience access in case only very general |
296 |
|
* information (e.g. which standard measurement unit is being used or |
297 |
|
* whether final operator being effective to this expression) is |
298 |
|
* intended to be retrieved of this scalar number expression independent |
299 |
|
* from whether this expression is actually an integer or a real number |
300 |
|
* expression. |
301 |
|
* |
302 |
|
* @see exprType(), asInt(), asReal() |
303 |
|
*/ |
304 |
|
VMScalarNumberExpr* asScalarNumberExpr() const; |
305 |
|
|
306 |
|
/** |
307 |
* In case this expression is a string expression, then this method |
* In case this expression is a string expression, then this method |
308 |
* returns a casted pointer to that VMStringExpr object. It returns NULL |
* returns a casted pointer to that VMStringExpr object. It returns NULL |
309 |
* if this expression is not a string expression. |
* if this expression is not a string expression. |
324 |
* returns NULL if this expression is not an integer array expression. |
* returns NULL if this expression is not an integer array expression. |
325 |
* |
* |
326 |
* @b Note: type casting performed by this method is strict! That means |
* @b Note: type casting performed by this method is strict! That means |
327 |
* if this expression is i.e. an integer expression or a string |
* if this expression is i.e. an integer scalar expression, a real |
328 |
* expression, calling asIntArray() will @b not cast those scalar |
* number expression or a string expression, calling asIntArray() will |
329 |
* expressions to an array expression for you, instead this method will |
* @b not cast those expressions to an integer array expression for you, |
330 |
* simply return NULL! |
* instead this method will simply return NULL! |
331 |
* |
* |
332 |
* @b Note: this method is currently, and in contrast to its other |
* @b Note: this method is currently, and in contrast to its other |
333 |
* counter parts, declared as virtual method. Some deriving classes are |
* counter parts, declared as virtual method. Some deriving classes are |
342 |
virtual VMIntArrayExpr* asIntArray() const; |
virtual VMIntArrayExpr* asIntArray() const; |
343 |
|
|
344 |
/** |
/** |
345 |
|
* In case this expression is a real number (floating point) array |
346 |
|
* expression, then this method returns a casted pointer to that |
347 |
|
* VMRealArrayExpr object. It returns NULL if this expression is not a |
348 |
|
* real number array expression. |
349 |
|
* |
350 |
|
* @b Note: type casting performed by this method is strict! That means |
351 |
|
* if this expression is i.e. a real number scalar expression, an |
352 |
|
* integer expression or a string expression, calling asRealArray() will |
353 |
|
* @b not cast those scalar expressions to a real number array |
354 |
|
* expression for you, instead this method will simply return NULL! |
355 |
|
* |
356 |
|
* @b Note: this method is currently, and in contrast to its other |
357 |
|
* counter parts, declared as virtual method. Some deriving classes are |
358 |
|
* currently using this to override this default implementation in order |
359 |
|
* to implement an "evaluate now as real number array" behavior. This |
360 |
|
* has efficiency reasons, however this also currently makes this part |
361 |
|
* of the API less clean and should thus be addressed in future with |
362 |
|
* appropriate changes to the API. |
363 |
|
* |
364 |
|
* @see exprType() |
365 |
|
*/ |
366 |
|
virtual VMRealArrayExpr* asRealArray() const; |
367 |
|
|
368 |
|
/** |
369 |
* Returns true in case this expression can be considered to be a |
* Returns true in case this expression can be considered to be a |
370 |
* constant expression. A constant expression will retain the same |
* constant expression. A constant expression will retain the same |
371 |
* value throughout the entire life time of a script and the |
* value throughout the entire life time of a script and the |
396 |
bool isModifyable() const; |
bool isModifyable() const; |
397 |
}; |
}; |
398 |
|
|
399 |
|
/** @brief Virtual machine scalar number expression |
400 |
|
* |
401 |
|
* This is the abstract base class for integer (scalar) expressions and |
402 |
|
* real number (floating point scalar) expressions of scripts. |
403 |
|
*/ |
404 |
|
class VMScalarNumberExpr : virtual public VMExpr, virtual public VMUnit { |
405 |
|
public: |
406 |
|
/** |
407 |
|
* Returns @c true if the value of this expression should be applied |
408 |
|
* as final value to the respective destination synthesis chain |
409 |
|
* parameter. |
410 |
|
* |
411 |
|
* This property is somewhat special and dedicated for the purpose of |
412 |
|
* this expression's (integer or real number) value to be applied as |
413 |
|
* parameter to the synthesis chain of the sampler (i.e. for altering a |
414 |
|
* filter cutoff frequency). Now historically and by default all values |
415 |
|
* of scripts are applied relatively to the sampler's synthesis chain, |
416 |
|
* that is the synthesis parameter value of a script is multiplied |
417 |
|
* against other sources for the same synthesis parameter (i.e. an LFO |
418 |
|
* or a dedicated MIDI controller either hard wired in the engine or |
419 |
|
* defined by the instrument patch). So by default the resulting actual |
420 |
|
* final synthesis parameter is a combination of all these sources. This |
421 |
|
* has the advantage that it creates a very living and dynamic overall |
422 |
|
* sound. |
423 |
|
* |
424 |
|
* However sometimes there are requirements by script authors where this |
425 |
|
* is not what you want. Therefore the NKSP script engine added a |
426 |
|
* language extension by prefixing a value in scripts with a @c ! |
427 |
|
* character the value will be defined as being the "final" value of the |
428 |
|
* destination synthesis parameter, so that causes this value to be |
429 |
|
* applied exclusively, and the values of all other sources are thus |
430 |
|
* entirely ignored by the sampler's synthesis core as long as this |
431 |
|
* value is assigned by the script engine as "final" value for the |
432 |
|
* requested synthesis parameter. |
433 |
|
*/ |
434 |
|
virtual bool isFinal() const = 0; |
435 |
|
}; |
436 |
|
|
437 |
/** @brief Virtual machine integer expression |
/** @brief Virtual machine integer expression |
438 |
* |
* |
439 |
* This is the abstract base class for all expressions inside scripts which |
* This is the abstract base class for all expressions inside scripts which |
441 |
* abstract method evalInt() to return the actual integer result value of |
* abstract method evalInt() to return the actual integer result value of |
442 |
* the expression. |
* the expression. |
443 |
*/ |
*/ |
444 |
class VMIntExpr : virtual public VMExpr { |
class VMIntExpr : virtual public VMScalarNumberExpr { |
445 |
public: |
public: |
446 |
/** |
/** |
447 |
* Returns the result of this expression as integer (scalar) value. |
* Returns the result of this expression as integer (scalar) value. |
448 |
* This abstract method must be implemented by deriving classes. |
* This abstract method must be implemented by deriving classes. |
449 |
*/ |
*/ |
450 |
virtual int evalInt() = 0; |
virtual vmint evalInt() = 0; |
451 |
|
|
452 |
|
/** |
453 |
|
* Returns the result of this expression as integer (scalar) value and |
454 |
|
* thus behaves similar to the previous method, however this overridden |
455 |
|
* method automatically takes unit prefixes into account and returns a |
456 |
|
* value corresponding to the expected given unit @a prefix. |
457 |
|
* |
458 |
|
* @param prefix - default measurement unit prefix expected by caller |
459 |
|
*/ |
460 |
|
vmint evalInt(MetricPrefix_t prefix); |
461 |
|
|
462 |
|
/** |
463 |
|
* This method behaves like the previous method, just that it takes |
464 |
|
* a default measurement prefix with two elements (i.e. "milli cents" |
465 |
|
* for tuning). |
466 |
|
*/ |
467 |
|
vmint evalInt(MetricPrefix_t prefix1, MetricPrefix_t prefix2); |
468 |
|
|
469 |
/** |
/** |
470 |
* Returns always INT_EXPR for instances of this class. |
* Returns always INT_EXPR for instances of this class. |
472 |
ExprType_t exprType() const OVERRIDE { return INT_EXPR; } |
ExprType_t exprType() const OVERRIDE { return INT_EXPR; } |
473 |
}; |
}; |
474 |
|
|
475 |
|
/** @brief Virtual machine real number (floating point scalar) expression |
476 |
|
* |
477 |
|
* This is the abstract base class for all expressions inside scripts which |
478 |
|
* evaluate to a real number (floating point scalar) value. Deriving classes |
479 |
|
* implement the abstract method evalReal() to return the actual floating |
480 |
|
* point result value of the expression. |
481 |
|
*/ |
482 |
|
class VMRealExpr : virtual public VMScalarNumberExpr { |
483 |
|
public: |
484 |
|
/** |
485 |
|
* Returns the result of this expression as real number (floating point |
486 |
|
* scalar) value. This abstract method must be implemented by deriving |
487 |
|
* classes. |
488 |
|
*/ |
489 |
|
virtual vmfloat evalReal() = 0; |
490 |
|
|
491 |
|
/** |
492 |
|
* Returns the result of this expression as real number (floating point |
493 |
|
* scalar) value and thus behaves similar to the previous method, |
494 |
|
* however this overridden method automatically takes unit prefixes into |
495 |
|
* account and returns a value corresponding to the expected given unit |
496 |
|
* @a prefix. |
497 |
|
* |
498 |
|
* @param prefix - default measurement unit prefix expected by caller |
499 |
|
*/ |
500 |
|
vmfloat evalReal(MetricPrefix_t prefix); |
501 |
|
|
502 |
|
/** |
503 |
|
* This method behaves like the previous method, just that it takes |
504 |
|
* a default measurement prefix with two elements (i.e. "milli cents" |
505 |
|
* for tuning). |
506 |
|
*/ |
507 |
|
vmfloat evalReal(MetricPrefix_t prefix1, MetricPrefix_t prefix2); |
508 |
|
|
509 |
|
/** |
510 |
|
* Returns always REAL_EXPR for instances of this class. |
511 |
|
*/ |
512 |
|
ExprType_t exprType() const OVERRIDE { return REAL_EXPR; } |
513 |
|
}; |
514 |
|
|
515 |
/** @brief Virtual machine string expression |
/** @brief Virtual machine string expression |
516 |
* |
* |
517 |
* This is the abstract base class for all expressions inside scripts which |
* This is the abstract base class for all expressions inside scripts which |
546 |
* Returns amount of elements in this array. This abstract method must |
* Returns amount of elements in this array. This abstract method must |
547 |
* be implemented by deriving classes. |
* be implemented by deriving classes. |
548 |
*/ |
*/ |
549 |
virtual int arraySize() const = 0; |
virtual vmint arraySize() const = 0; |
550 |
}; |
}; |
551 |
|
|
552 |
/** @brief Virtual Machine Integer Array Expression |
/** @brief Virtual Machine Integer Array Expression |
564 |
* |
* |
565 |
* @param i - array element index (must be between 0 .. arraySize() - 1) |
* @param i - array element index (must be between 0 .. arraySize() - 1) |
566 |
*/ |
*/ |
567 |
virtual int evalIntElement(uint i) = 0; |
virtual vmint evalIntElement(vmuint i) = 0; |
568 |
|
|
569 |
/** |
/** |
570 |
* Changes the current value of an element (given by array element |
* Changes the current value of an element (given by array element |
573 |
* @param i - array element index (must be between 0 .. arraySize() - 1) |
* @param i - array element index (must be between 0 .. arraySize() - 1) |
574 |
* @param value - new integer scalar value to be assigned to that array element |
* @param value - new integer scalar value to be assigned to that array element |
575 |
*/ |
*/ |
576 |
virtual void assignIntElement(uint i, int value) = 0; |
virtual void assignIntElement(vmuint i, vmint value) = 0; |
577 |
|
|
578 |
/** |
/** |
579 |
* Returns always INT_ARR_EXPR for instances of this class. |
* Returns always INT_ARR_EXPR for instances of this class. |
581 |
ExprType_t exprType() const OVERRIDE { return INT_ARR_EXPR; } |
ExprType_t exprType() const OVERRIDE { return INT_ARR_EXPR; } |
582 |
}; |
}; |
583 |
|
|
584 |
|
/** @brief Virtual Machine Real Number Array Expression |
585 |
|
* |
586 |
|
* This is the abstract base class for all expressions inside scripts which |
587 |
|
* evaluate to an array of real numbers (floating point values). Deriving |
588 |
|
* classes implement the abstract methods arraySize(), evalRealElement() and |
589 |
|
* assignRealElement() to access the array's individual real numbers. |
590 |
|
*/ |
591 |
|
class VMRealArrayExpr : virtual public VMArrayExpr { |
592 |
|
public: |
593 |
|
/** |
594 |
|
* Returns the (scalar) real mumber (floating point value) of the array |
595 |
|
* element given by element index @a i. |
596 |
|
* |
597 |
|
* @param i - array element index (must be between 0 .. arraySize() - 1) |
598 |
|
*/ |
599 |
|
virtual vmfloat evalRealElement(vmuint i) = 0; |
600 |
|
|
601 |
|
/** |
602 |
|
* Changes the current value of an element (given by array element |
603 |
|
* index @a i) of this real number array. |
604 |
|
* |
605 |
|
* @param i - array element index (must be between 0 .. arraySize() - 1) |
606 |
|
* @param value - new real number value to be assigned to that array element |
607 |
|
*/ |
608 |
|
virtual void assignRealElement(vmuint i, vmfloat value) = 0; |
609 |
|
|
610 |
|
/** |
611 |
|
* Returns always REAL_ARR_EXPR for instances of this class. |
612 |
|
*/ |
613 |
|
ExprType_t exprType() const OVERRIDE { return REAL_ARR_EXPR; } |
614 |
|
}; |
615 |
|
|
616 |
/** @brief Arguments (parameters) for being passed to a built-in script function. |
/** @brief Arguments (parameters) for being passed to a built-in script function. |
617 |
* |
* |
618 |
* An argument or a set of arguments passed to a script function are |
* An argument or a set of arguments passed to a script function are |
627 |
* Returns the amount of arguments going to be passed to the script |
* Returns the amount of arguments going to be passed to the script |
628 |
* function. |
* function. |
629 |
*/ |
*/ |
630 |
virtual int argsCount() const = 0; |
virtual vmint argsCount() const = 0; |
631 |
|
|
632 |
/** |
/** |
633 |
* Returns the respective argument (requested by argument index @a i) of |
* Returns the respective argument (requested by argument index @a i) of |
637 |
* |
* |
638 |
* @param i - function argument index (indexed from left to right) |
* @param i - function argument index (indexed from left to right) |
639 |
*/ |
*/ |
640 |
virtual VMExpr* arg(int i) = 0; |
virtual VMExpr* arg(vmint i) = 0; |
641 |
}; |
}; |
642 |
|
|
643 |
/** @brief Result value returned from a call to a built-in script function. |
/** @brief Result value returned from a call to a built-in script function. |
693 |
/** |
/** |
694 |
* Script data type of the function's return value. If the function does |
* Script data type of the function's return value. If the function does |
695 |
* not return any value (void), then it returns EMPTY_EXPR here. |
* not return any value (void), then it returns EMPTY_EXPR here. |
696 |
|
* |
697 |
|
* Some functions may have a different return type depending on the |
698 |
|
* arguments to be passed to this function. That's what the @a args |
699 |
|
* parameter is for, so that the method implementation can look ahead |
700 |
|
* of what kind of parameters are going to be passed to the built-in |
701 |
|
* function later on in order to decide which return value type would |
702 |
|
* be used and returned by the function accordingly in that case. |
703 |
|
* |
704 |
|
* @param args - function arguments going to be passed for executing |
705 |
|
* this built-in function later on |
706 |
*/ |
*/ |
707 |
virtual ExprType_t returnType() = 0; |
virtual ExprType_t returnType(VMFnArgs* args) = 0; |
708 |
|
|
709 |
/** |
/** |
710 |
* Minimum amount of function arguments this function accepts. If a |
* Minimum amount of function arguments this function accepts. If a |
711 |
* script is calling this function with less arguments, the script |
* script is calling this function with less arguments, the script |
712 |
* parser will throw a parser error. |
* parser will throw a parser error. |
713 |
*/ |
*/ |
714 |
virtual int minRequiredArgs() const = 0; |
virtual vmint minRequiredArgs() const = 0; |
715 |
|
|
716 |
/** |
/** |
717 |
* Maximum amount of function arguments this functions accepts. If a |
* Maximum amount of function arguments this functions accepts. If a |
718 |
* script is calling this function with more arguments, the script |
* script is calling this function with more arguments, the script |
719 |
* parser will throw a parser error. |
* parser will throw a parser error. |
720 |
*/ |
*/ |
721 |
virtual int maxAllowedArgs() const = 0; |
virtual vmint maxAllowedArgs() const = 0; |
722 |
|
|
723 |
/** |
/** |
724 |
* Script data type of the function's @c iArg 'th function argument. |
* Script data type of the function's @c iArg 'th function argument. |
734 |
* @param iArg - index of the function argument in question |
* @param iArg - index of the function argument in question |
735 |
* (must be between 0 .. maxAllowedArgs() - 1) |
* (must be between 0 .. maxAllowedArgs() - 1) |
736 |
*/ |
*/ |
737 |
virtual ExprType_t argType(int iArg) const = 0; |
virtual ExprType_t argType(vmint iArg) const = 0; |
738 |
|
|
739 |
/** |
/** |
740 |
* This method is called by the parser to check whether arguments |
* This method is called by the parser to check whether arguments |
752 |
* @return true if the given data type would be accepted for the |
* @return true if the given data type would be accepted for the |
753 |
* respective function argument by the function |
* respective function argument by the function |
754 |
*/ |
*/ |
755 |
virtual bool acceptsArgType(int iArg, ExprType_t type) const = 0; |
virtual bool acceptsArgType(vmint iArg, ExprType_t type) const = 0; |
756 |
|
|
757 |
|
/** |
758 |
|
* This method is called by the parser to check whether arguments |
759 |
|
* passed in scripts to this function are accepted by this function. If |
760 |
|
* a script calls this function with an argument's measuremnt unit type |
761 |
|
* not accepted by this function, the parser will throw a parser error. |
762 |
|
* |
763 |
|
* This default implementation of this method does not accept any |
764 |
|
* measurement unit. Deriving subclasses would override this method |
765 |
|
* implementation in case they do accept any measurement unit for its |
766 |
|
* function arguments. |
767 |
|
* |
768 |
|
* @param iArg - index of the function argument in question |
769 |
|
* (must be between 0 .. maxAllowedArgs() - 1) |
770 |
|
* @param type - standard measurement unit data type used for this |
771 |
|
* function argument by currently parsed script |
772 |
|
* @return true if the given standard measurement unit type would be |
773 |
|
* accepted for the respective function argument by the function |
774 |
|
*/ |
775 |
|
virtual bool acceptsArgUnitType(vmint iArg, StdUnit_t type) const; |
776 |
|
|
777 |
|
/** |
778 |
|
* This method is called by the parser to check whether arguments |
779 |
|
* passed in scripts to this function are accepted by this function. If |
780 |
|
* a script calls this function with a metric unit prefix and metric |
781 |
|
* prefixes are not accepted for that argument by this function, then |
782 |
|
* the parser will throw a parser error. |
783 |
|
* |
784 |
|
* This default implementation of this method does not accept any |
785 |
|
* metric prefix. Deriving subclasses would override this method |
786 |
|
* implementation in case they do accept any metric prefix for its |
787 |
|
* function arguments. |
788 |
|
* |
789 |
|
* @param iArg - index of the function argument in question |
790 |
|
* (must be between 0 .. maxAllowedArgs() - 1) |
791 |
|
* @param type - standard measurement unit data type used for that |
792 |
|
* function argument by currently parsed script |
793 |
|
* |
794 |
|
* @return true if a metric prefix would be accepted for the respective |
795 |
|
* function argument by this function |
796 |
|
* |
797 |
|
* @see MetricPrefix_t |
798 |
|
*/ |
799 |
|
virtual bool acceptsArgUnitPrefix(vmint iArg, StdUnit_t type) const; |
800 |
|
|
801 |
|
/** |
802 |
|
* This method is called by the parser to check whether arguments |
803 |
|
* passed in scripts to this function are accepted by this function. If |
804 |
|
* a script calls this function with an argument that is declared to be |
805 |
|
* a "final" value and this is not accepted by this function, the parser |
806 |
|
* will throw a parser error. |
807 |
|
* |
808 |
|
* This default implementation of this method does not accept a "final" |
809 |
|
* value. Deriving subclasses would override this method implementation |
810 |
|
* in case they do accept a "final" value for its function arguments. |
811 |
|
* |
812 |
|
* @param iArg - index of the function argument in question |
813 |
|
* (must be between 0 .. maxAllowedArgs() - 1) |
814 |
|
* @return true if a "final" value would be accepted for the respective |
815 |
|
* function argument by the function |
816 |
|
* |
817 |
|
* @see VMIntExpr::isFinal() |
818 |
|
*/ |
819 |
|
virtual bool acceptsArgFinal(vmint iArg) const; |
820 |
|
|
821 |
/** |
/** |
822 |
* This method is called by the parser to check whether some arguments |
* This method is called by the parser to check whether some arguments |
831 |
* @param iArg - index of the function argument in question |
* @param iArg - index of the function argument in question |
832 |
* (must be between 0 .. maxAllowedArgs() - 1) |
* (must be between 0 .. maxAllowedArgs() - 1) |
833 |
*/ |
*/ |
834 |
virtual bool modifiesArg(int iArg) const = 0; |
virtual bool modifiesArg(vmint iArg) const = 0; |
835 |
|
|
836 |
/** |
/** |
837 |
* Implements the actual function execution. This exec() method is |
* Implements the actual function execution. This exec() method is |
865 |
|
|
866 |
/** @brief Virtual machine relative pointer. |
/** @brief Virtual machine relative pointer. |
867 |
* |
* |
868 |
* POD base of VMIntRelPtr and VMInt8RelPtr structures. Not intended to be |
* POD base of VMInt64RelPtr, VMInt32RelPtr and VMInt8RelPtr structures. Not |
869 |
* used directly. Use VMIntRelPtr or VMInt8RelPtr instead. |
* intended to be used directly. Use VMInt64RelPtr, VMInt32RelPtr, |
870 |
|
* VMInt8RelPtr instead. |
871 |
* |
* |
872 |
* @see VMIntRelPtr, VMInt8RelPtr |
* @see VMInt64RelPtr, VMInt32RelPtr, VMInt8RelPtr |
873 |
*/ |
*/ |
874 |
struct VMRelPtr { |
struct VMRelPtr { |
875 |
void** base; ///< Base pointer. |
void** base; ///< Base pointer. |
876 |
int offset; ///< Offset (in bytes) relative to base pointer. |
vmint offset; ///< Offset (in bytes) relative to base pointer. |
877 |
bool readonly; ///< Whether the pointed data may be modified or just be read. |
bool readonly; ///< Whether the pointed data may be modified or just be read. |
878 |
}; |
}; |
879 |
|
|
880 |
/** @brief Pointer to built-in VM integer variable (of C/C++ type int). |
/** @brief Pointer to built-in VM integer variable (interface class). |
881 |
|
* |
882 |
|
* This class acts as an abstract interface to all built-in integer script |
883 |
|
* variables, independent of their actual native size (i.e. some built-in |
884 |
|
* script variables are internally using a native int size of 64 bit or 32 |
885 |
|
* bit or 8 bit). The virtual machine is using this interface class instead |
886 |
|
* of its implementing descendants (VMInt64RelPtr, VMInt32RelPtr, |
887 |
|
* VMInt8RelPtr) in order for the virtual machine for not being required to |
888 |
|
* handle each of them differently. |
889 |
|
*/ |
890 |
|
struct VMIntPtr { |
891 |
|
virtual vmint evalInt() = 0; |
892 |
|
virtual void assign(vmint i) = 0; |
893 |
|
virtual bool isAssignable() const = 0; |
894 |
|
}; |
895 |
|
|
896 |
|
/** @brief Pointer to built-in VM integer variable (of C/C++ type int64_t). |
897 |
|
* |
898 |
|
* Used for defining built-in 64 bit integer script variables. |
899 |
|
* |
900 |
|
* @b CAUTION: You may only use this class for pointing to C/C++ variables |
901 |
|
* of type "int64_t" (thus being exactly 64 bit in size). If the C/C++ int |
902 |
|
* variable you want to reference is only 32 bit in size then you @b must |
903 |
|
* use VMInt32RelPtr instead! Respectively for a referenced native variable |
904 |
|
* with only 8 bit in size you @b must use VMInt8RelPtr instead! |
905 |
|
* |
906 |
|
* For efficiency reasons the actual native C/C++ int variable is referenced |
907 |
|
* by two components here. The actual native int C/C++ variable in memory |
908 |
|
* is dereferenced at VM run-time by taking the @c base pointer dereference |
909 |
|
* and adding @c offset bytes. This has the advantage that for a large |
910 |
|
* number of built-in int variables, only one (or few) base pointer need |
911 |
|
* to be re-assigned before running a script, instead of updating each |
912 |
|
* built-in variable each time before a script is executed. |
913 |
|
* |
914 |
|
* Refer to DECLARE_VMINT() for example code. |
915 |
|
* |
916 |
|
* @see VMInt32RelPtr, VMInt8RelPtr, DECLARE_VMINT() |
917 |
|
*/ |
918 |
|
struct VMInt64RelPtr : VMRelPtr, VMIntPtr { |
919 |
|
VMInt64RelPtr() { |
920 |
|
base = NULL; |
921 |
|
offset = 0; |
922 |
|
readonly = false; |
923 |
|
} |
924 |
|
VMInt64RelPtr(const VMRelPtr& data) { |
925 |
|
base = data.base; |
926 |
|
offset = data.offset; |
927 |
|
readonly = false; |
928 |
|
} |
929 |
|
vmint evalInt() OVERRIDE { |
930 |
|
return (vmint)*(int64_t*)&(*(uint8_t**)base)[offset]; |
931 |
|
} |
932 |
|
void assign(vmint i) OVERRIDE { |
933 |
|
*(int64_t*)&(*(uint8_t**)base)[offset] = (int64_t)i; |
934 |
|
} |
935 |
|
bool isAssignable() const OVERRIDE { return !readonly; } |
936 |
|
}; |
937 |
|
|
938 |
|
/** @brief Pointer to built-in VM integer variable (of C/C++ type int32_t). |
939 |
* |
* |
940 |
* Used for defining built-in 32 bit integer script variables. |
* Used for defining built-in 32 bit integer script variables. |
941 |
* |
* |
942 |
* @b CAUTION: You may only use this class for pointing to C/C++ variables |
* @b CAUTION: You may only use this class for pointing to C/C++ variables |
943 |
* of type "int" (which on most systems is 32 bit in size). If the C/C++ int |
* of type "int32_t" (thus being exactly 32 bit in size). If the C/C++ int |
944 |
* variable you want to reference is only 8 bit in size, then you @b must |
* variable you want to reference is 64 bit in size then you @b must use |
945 |
* use VMInt8RelPtr instead! |
* VMInt64RelPtr instead! Respectively for a referenced native variable with |
946 |
|
* only 8 bit in size you @b must use VMInt8RelPtr instead! |
947 |
* |
* |
948 |
* For efficiency reasons the actual native C/C++ int variable is referenced |
* For efficiency reasons the actual native C/C++ int variable is referenced |
949 |
* by two components here. The actual native int C/C++ variable in memory |
* by two components here. The actual native int C/C++ variable in memory |
955 |
* |
* |
956 |
* Refer to DECLARE_VMINT() for example code. |
* Refer to DECLARE_VMINT() for example code. |
957 |
* |
* |
958 |
* @see VMInt8RelPtr, DECLARE_VMINT() |
* @see VMInt64RelPtr, VMInt8RelPtr, DECLARE_VMINT() |
959 |
*/ |
*/ |
960 |
struct VMIntRelPtr : VMRelPtr { |
struct VMInt32RelPtr : VMRelPtr, VMIntPtr { |
961 |
VMIntRelPtr() { |
VMInt32RelPtr() { |
962 |
base = NULL; |
base = NULL; |
963 |
offset = 0; |
offset = 0; |
964 |
readonly = false; |
readonly = false; |
965 |
} |
} |
966 |
VMIntRelPtr(const VMRelPtr& data) { |
VMInt32RelPtr(const VMRelPtr& data) { |
967 |
base = data.base; |
base = data.base; |
968 |
offset = data.offset; |
offset = data.offset; |
969 |
readonly = false; |
readonly = false; |
970 |
} |
} |
971 |
virtual int evalInt() { return *(int*)&(*(uint8_t**)base)[offset]; } |
vmint evalInt() OVERRIDE { |
972 |
virtual void assign(int i) { *(int*)&(*(uint8_t**)base)[offset] = i; } |
return (vmint)*(int32_t*)&(*(uint8_t**)base)[offset]; |
973 |
|
} |
974 |
|
void assign(vmint i) OVERRIDE { |
975 |
|
*(int32_t*)&(*(uint8_t**)base)[offset] = (int32_t)i; |
976 |
|
} |
977 |
|
bool isAssignable() const OVERRIDE { return !readonly; } |
978 |
}; |
}; |
979 |
|
|
980 |
/** @brief Pointer to built-in VM integer variable (of C/C++ type int8_t). |
/** @brief Pointer to built-in VM integer variable (of C/C++ type int8_t). |
983 |
* |
* |
984 |
* @b CAUTION: You may only use this class for pointing to C/C++ variables |
* @b CAUTION: You may only use this class for pointing to C/C++ variables |
985 |
* of type "int8_t" (8 bit integer). If the C/C++ int variable you want to |
* of type "int8_t" (8 bit integer). If the C/C++ int variable you want to |
986 |
* reference is an "int" type (which is 32 bit on most systems), then you |
* reference is not exactly 8 bit in size then you @b must respectively use |
987 |
* @b must use VMIntRelPtr instead! |
* either VMInt32RelPtr for native 32 bit variables or VMInt64RelPtrl for |
988 |
|
* native 64 bit variables instead! |
989 |
* |
* |
990 |
* For efficiency reasons the actual native C/C++ int variable is referenced |
* For efficiency reasons the actual native C/C++ int variable is referenced |
991 |
* by two components here. The actual native int C/C++ variable in memory |
* by two components here. The actual native int C/C++ variable in memory |
997 |
* |
* |
998 |
* Refer to DECLARE_VMINT() for example code. |
* Refer to DECLARE_VMINT() for example code. |
999 |
* |
* |
1000 |
* @see VMIntRelPtr, DECLARE_VMINT() |
* @see VMIntRel32Ptr, VMIntRel64Ptr, DECLARE_VMINT() |
1001 |
*/ |
*/ |
1002 |
struct VMInt8RelPtr : VMIntRelPtr { |
struct VMInt8RelPtr : VMRelPtr, VMIntPtr { |
1003 |
VMInt8RelPtr() : VMIntRelPtr() {} |
VMInt8RelPtr() { |
1004 |
VMInt8RelPtr(const VMRelPtr& data) : VMIntRelPtr(data) {} |
base = NULL; |
1005 |
virtual int evalInt() OVERRIDE { |
offset = 0; |
1006 |
return *(uint8_t*)&(*(uint8_t**)base)[offset]; |
readonly = false; |
1007 |
|
} |
1008 |
|
VMInt8RelPtr(const VMRelPtr& data) { |
1009 |
|
base = data.base; |
1010 |
|
offset = data.offset; |
1011 |
|
readonly = false; |
1012 |
|
} |
1013 |
|
vmint evalInt() OVERRIDE { |
1014 |
|
return (vmint)*(uint8_t*)&(*(uint8_t**)base)[offset]; |
1015 |
} |
} |
1016 |
virtual void assign(int i) OVERRIDE { |
void assign(vmint i) OVERRIDE { |
1017 |
*(uint8_t*)&(*(uint8_t**)base)[offset] = i; |
*(uint8_t*)&(*(uint8_t**)base)[offset] = (uint8_t)i; |
1018 |
} |
} |
1019 |
|
bool isAssignable() const OVERRIDE { return !readonly; } |
1020 |
}; |
}; |
1021 |
|
|
1022 |
|
/** @brief Pointer to built-in VM integer variable (of C/C++ type vmint). |
1023 |
|
* |
1024 |
|
* Use this typedef if the native variable to be pointed to is using the |
1025 |
|
* typedef vmint. If the native C/C++ variable to be pointed to is using |
1026 |
|
* another C/C++ type then better use one of VMInt64RelPtr or VMInt32RelPtr |
1027 |
|
* instead. |
1028 |
|
*/ |
1029 |
|
typedef VMInt64RelPtr VMIntRelPtr; |
1030 |
|
|
1031 |
#if HAVE_CXX_EMBEDDED_PRAGMA_DIAGNOSTICS |
#if HAVE_CXX_EMBEDDED_PRAGMA_DIAGNOSTICS |
1032 |
# define COMPILER_DISABLE_OFFSETOF_WARNING \ |
# define COMPILER_DISABLE_OFFSETOF_WARNING \ |
1033 |
_Pragma("GCC diagnostic push") \ |
_Pragma("GCC diagnostic push") \ |
1040 |
#endif |
#endif |
1041 |
|
|
1042 |
/** |
/** |
1043 |
* Convenience macro for initializing VMIntRelPtr and VMInt8RelPtr |
* Convenience macro for initializing VMInt64RelPtr, VMInt32RelPtr and |
1044 |
* structures. Usage example: |
* VMInt8RelPtr structures. Usage example: |
1045 |
* @code |
* @code |
1046 |
* struct Foo { |
* struct Foo { |
1047 |
* uint8_t a; // native representation of a built-in integer script variable |
* uint8_t a; // native representation of a built-in integer script variable |
1048 |
* int b; // native representation of another built-in integer script variable |
* int64_t b; // native representation of another built-in integer script variable |
1049 |
* int c; // native representation of another built-in integer script variable |
* int64_t c; // native representation of another built-in integer script variable |
1050 |
* uint8_t d; // native representation of another built-in integer script variable |
* uint8_t d; // native representation of another built-in integer script variable |
1051 |
* }; |
* }; |
1052 |
* |
* |
1057 |
* Foo* pFoo; |
* Foo* pFoo; |
1058 |
* |
* |
1059 |
* VMInt8RelPtr varA = DECLARE_VMINT(pFoo, class Foo, a); |
* VMInt8RelPtr varA = DECLARE_VMINT(pFoo, class Foo, a); |
1060 |
* VMIntRelPtr varB = DECLARE_VMINT(pFoo, class Foo, b); |
* VMInt64RelPtr varB = DECLARE_VMINT(pFoo, class Foo, b); |
1061 |
* VMIntRelPtr varC = DECLARE_VMINT(pFoo, class Foo, c); |
* VMInt64RelPtr varC = DECLARE_VMINT(pFoo, class Foo, c); |
1062 |
* VMInt8RelPtr varD = DECLARE_VMINT(pFoo, class Foo, d); |
* VMInt8RelPtr varD = DECLARE_VMINT(pFoo, class Foo, d); |
1063 |
* |
* |
1064 |
* pFoo = &foo1; |
* pFoo = &foo1; |
1093 |
) \ |
) \ |
1094 |
|
|
1095 |
/** |
/** |
1096 |
* Same as DECLARE_VMINT(), but this one defines the VMIntRelPtr and |
* Same as DECLARE_VMINT(), but this one defines the VMInt64RelPtr, |
1097 |
* VMInt8RelPtr structures to be of read-only type. That means the script |
* VMInt32RelPtr and VMInt8RelPtr structures to be of read-only type. |
1098 |
* parser will abort any script at parser time if the script is trying to |
* That means the script parser will abort any script at parser time if the |
1099 |
* modify such a read-only built-in variable. |
* script is trying to modify such a read-only built-in variable. |
1100 |
* |
* |
1101 |
* @b NOTE: this is only intended for built-in read-only variables that |
* @b NOTE: this is only intended for built-in read-only variables that |
1102 |
* may change during runtime! If your built-in variable's data is rather |
* may change during runtime! If your built-in variable's data is rather |
1119 |
/** @brief Built-in VM 8 bit integer array variable. |
/** @brief Built-in VM 8 bit integer array variable. |
1120 |
* |
* |
1121 |
* Used for defining built-in integer array script variables (8 bit per |
* Used for defining built-in integer array script variables (8 bit per |
1122 |
* array element). Currently there is no support for any other kind of array |
* array element). Currently there is no support for any other kind of |
1123 |
* type. So all integer arrays of scripts use 8 bit data types. |
* built-in array type. So all built-in integer arrays accessed by scripts |
1124 |
|
* use 8 bit data types. |
1125 |
*/ |
*/ |
1126 |
struct VMInt8Array { |
struct VMInt8Array { |
1127 |
int8_t* data; |
int8_t* data; |
1128 |
int size; |
vmint size; |
1129 |
bool readonly; ///< Whether the array data may be modified or just be read. |
bool readonly; ///< Whether the array data may be modified or just be read. |
1130 |
|
|
1131 |
VMInt8Array() : data(NULL), size(0), readonly(false) {} |
VMInt8Array() : data(NULL), size(0), readonly(false) {} |
1133 |
|
|
1134 |
/** @brief Virtual machine script variable. |
/** @brief Virtual machine script variable. |
1135 |
* |
* |
1136 |
* Common interface for all variables accessed in scripts. |
* Common interface for all variables accessed in scripts, independent of |
1137 |
|
* their precise data type. |
1138 |
*/ |
*/ |
1139 |
class VMVariable : virtual public VMExpr { |
class VMVariable : virtual public VMExpr { |
1140 |
public: |
public: |
1155 |
*/ |
*/ |
1156 |
virtual void assignExpr(VMExpr* expr) = 0; |
virtual void assignExpr(VMExpr* expr) = 0; |
1157 |
}; |
}; |
1158 |
|
|
1159 |
/** @brief Dynamically executed variable (abstract base class). |
/** @brief Dynamically executed variable (abstract base class). |
1160 |
* |
* |
1161 |
* Interface for the implementation of a dynamically generated content of |
* Interface for the implementation of a dynamically generated content of |
1229 |
*/ |
*/ |
1230 |
class VMDynIntVar : virtual public VMDynVar, virtual public VMIntExpr { |
class VMDynIntVar : virtual public VMDynVar, virtual public VMIntExpr { |
1231 |
public: |
public: |
1232 |
|
MetricPrefix_t unitPrefix(vmuint i) const OVERRIDE { return VM_NO_PREFIX; } |
1233 |
|
StdUnit_t unitType() const OVERRIDE { return VM_NO_UNIT; } |
1234 |
|
bool isFinal() const OVERRIDE { return false; } |
1235 |
}; |
}; |
1236 |
|
|
1237 |
/** @brief Dynamically executed variable (of string data type). |
/** @brief Dynamically executed variable (of string data type). |
1293 |
* Returns a variable name indexed map of all built-in script variables |
* Returns a variable name indexed map of all built-in script variables |
1294 |
* which point to native "int" scalar (usually 32 bit) variables. |
* which point to native "int" scalar (usually 32 bit) variables. |
1295 |
*/ |
*/ |
1296 |
virtual std::map<String,VMIntRelPtr*> builtInIntVariables() = 0; |
virtual std::map<String,VMIntPtr*> builtInIntVariables() = 0; |
1297 |
|
|
1298 |
/** |
/** |
1299 |
* Returns a variable name indexed map of all built-in script integer |
* Returns a variable name indexed map of all built-in script integer |
1305 |
* Returns a variable name indexed map of all built-in constant script |
* Returns a variable name indexed map of all built-in constant script |
1306 |
* variables, which never change their value at runtime. |
* variables, which never change their value at runtime. |
1307 |
*/ |
*/ |
1308 |
virtual std::map<String,int> builtInConstIntVariables() = 0; |
virtual std::map<String,vmint> builtInConstIntVariables() = 0; |
1309 |
|
|
1310 |
/** |
/** |
1311 |
* Returns a variable name indexed map of all built-in dynamic variables, |
* Returns a variable name indexed map of all built-in dynamic variables, |
1354 |
* |
* |
1355 |
* @see ScriptVM::exec() |
* @see ScriptVM::exec() |
1356 |
*/ |
*/ |
1357 |
virtual int suspensionTimeMicroseconds() const = 0; |
virtual vmint suspensionTimeMicroseconds() const = 0; |
1358 |
|
|
1359 |
/** |
/** |
1360 |
* Causes all polyphonic variables to be reset to zero values. A |
* Causes all polyphonic variables to be reset to zero values. A |
1511 |
case EMPTY_EXPR: return "empty"; |
case EMPTY_EXPR: return "empty"; |
1512 |
case INT_EXPR: return "integer"; |
case INT_EXPR: return "integer"; |
1513 |
case INT_ARR_EXPR: return "integer array"; |
case INT_ARR_EXPR: return "integer array"; |
1514 |
|
case REAL_EXPR: return "real number"; |
1515 |
|
case REAL_ARR_EXPR: return "real number array"; |
1516 |
case STRING_EXPR: return "string"; |
case STRING_EXPR: return "string"; |
1517 |
case STRING_ARR_EXPR: return "string array"; |
case STRING_ARR_EXPR: return "string array"; |
1518 |
} |
} |
1519 |
return "invalid"; |
return "invalid"; |
1520 |
} |
} |
1521 |
|
|
1522 |
|
/** |
1523 |
|
* Convenience function used for retrieving the data type of a script |
1524 |
|
* variable name being passed to this function. |
1525 |
|
* |
1526 |
|
* @param name - some script variable name (e.g. "$foo") |
1527 |
|
* @return variable's data type (e.g. INT_EXPR for example above) |
1528 |
|
*/ |
1529 |
|
inline ExprType_t exprTypeOfVarName(const String& name) { |
1530 |
|
if (name.empty()) return (ExprType_t) -1; |
1531 |
|
const char prefix = name[0]; |
1532 |
|
switch (prefix) { |
1533 |
|
case '$': return INT_EXPR; |
1534 |
|
case '%': return INT_ARR_EXPR; |
1535 |
|
case '~': return REAL_EXPR; |
1536 |
|
case '?': return REAL_ARR_EXPR; |
1537 |
|
case '@': return STRING_EXPR; |
1538 |
|
case '!': return STRING_ARR_EXPR; |
1539 |
|
} |
1540 |
|
return (ExprType_t) -1; |
1541 |
|
} |
1542 |
|
|
1543 |
|
/** |
1544 |
|
* Returns @c true in case the passed data type is some array data type. |
1545 |
|
*/ |
1546 |
|
inline bool isArray(const ExprType_t& type) { |
1547 |
|
return type == INT_ARR_EXPR || type == REAL_ARR_EXPR || |
1548 |
|
type == STRING_ARR_EXPR; |
1549 |
|
} |
1550 |
|
|
1551 |
|
/** |
1552 |
|
* Returns @c true in case the passed data type is some scalar number type |
1553 |
|
* (i.e. not an array and not a string). |
1554 |
|
*/ |
1555 |
|
inline bool isScalarNumber(const ExprType_t& type) { |
1556 |
|
return type == INT_EXPR || type == REAL_EXPR; |
1557 |
|
} |
1558 |
|
|
1559 |
|
/** |
1560 |
|
* Convenience function used for converting an StdUnit_t constant to a |
1561 |
|
* string, i.e. for generating error message by the parser. |
1562 |
|
*/ |
1563 |
|
inline String unitTypeStr(const StdUnit_t& type) { |
1564 |
|
switch (type) { |
1565 |
|
case VM_NO_UNIT: return "none"; |
1566 |
|
case VM_SECOND: return "seconds"; |
1567 |
|
case VM_HERTZ: return "Hz"; |
1568 |
|
case VM_BEL: return "Bel"; |
1569 |
|
} |
1570 |
|
return "invalid"; |
1571 |
|
} |
1572 |
|
|
1573 |
/** @brief Virtual machine representation of a script. |
/** @brief Virtual machine representation of a script. |
1574 |
* |
* |
1575 |
* An instance of this abstract base class represents a parsed script, |
* An instance of this abstract base class represents a parsed script, |
1669 |
bool isStringLiteral() const; ///< Returns true in case this source token represents a string literal (i.e. "Some text"). |
bool isStringLiteral() const; ///< Returns true in case this source token represents a string literal (i.e. "Some text"). |
1670 |
bool isComment() const; ///< Returns true in case this source token represents a source code comment. |
bool isComment() const; ///< Returns true in case this source token represents a source code comment. |
1671 |
bool isPreprocessor() const; ///< Returns true in case this source token represents a preprocessor statement. |
bool isPreprocessor() const; ///< Returns true in case this source token represents a preprocessor statement. |
1672 |
|
bool isMetricPrefix() const; |
1673 |
|
bool isStdUnit() const; |
1674 |
bool isOther() const; ///< Returns true in case this source token represents anything else not covered by the token types mentioned above. |
bool isOther() const; ///< Returns true in case this source token represents anything else not covered by the token types mentioned above. |
1675 |
|
|
1676 |
// extended types |
// extended types |
1677 |
bool isIntegerVariable() const; ///< Returns true in case this source token represents an integer variable name (i.e. "$someIntVariable"). |
bool isIntegerVariable() const; ///< Returns true in case this source token represents an integer variable name (i.e. "$someIntVariable"). |
1678 |
|
bool isRealVariable() const; ///< Returns true in case this source token represents a floating point variable name (i.e. "~someRealVariable"). |
1679 |
bool isStringVariable() const; ///< Returns true in case this source token represents an string variable name (i.e. "\@someStringVariable"). |
bool isStringVariable() const; ///< Returns true in case this source token represents an string variable name (i.e. "\@someStringVariable"). |
1680 |
bool isArrayVariable() const; ///< Returns true in case this source token represents an array variable name (i.e. "%someArryVariable"). |
bool isIntArrayVariable() const; ///< Returns true in case this source token represents an integer array variable name (i.e. "%someArrayVariable"). |
1681 |
|
bool isRealArrayVariable() const; ///< Returns true in case this source token represents a real number array variable name (i.e. "?someArrayVariable"). |
1682 |
|
bool isArrayVariable() const DEPRECATED_API; ///< Returns true in case this source token represents an @b integer array variable name (i.e. "%someArrayVariable"). @deprecated This method will be removed, use isIntArrayVariable() instead. |
1683 |
bool isEventHandlerName() const; ///< Returns true in case this source token represents an event handler name (i.e. "note", "release", "controller"). |
bool isEventHandlerName() const; ///< Returns true in case this source token represents an event handler name (i.e. "note", "release", "controller"). |
1684 |
|
|
1685 |
VMSourceToken& operator=(const VMSourceToken& other); |
VMSourceToken& operator=(const VMSourceToken& other); |