/[svn]/linuxsampler/trunk/src/scriptvm/ScriptVM.h

Diff of /linuxsampler/trunk/src/scriptvm/ScriptVM.h

Parent Directory | Revision Log | View Patch Patch

-revision 2885 by schoenebeck,
Fri Apr 22 15:37:45 2016 UTC
+revision 3590 by schoenebeck,
Mon Sep  2 09:03:31 2019 UTC
 Line 1
  /*
-  * Copyright (c) 2014-2016 Christian Schoenebeck
+  * Copyright (c) 2014-2019 Christian Schoenebeck
   *
   * http://www.linuxsampler.org
   *
 Line 20 
 namespace LinuxSampler {
      class ParserContext;
      class ExecContext;
-     class CoreVMFunction_message;
-     class CoreVMFunction_exit;
-     class CoreVMFunction_wait;
-     class CoreVMFunction_abs;
-     class CoreVMFunction_random;
-     class CoreVMFunction_num_elements;
      /** @brief Core virtual machine for real-time instrument scripts.
       *
-Line 72 
 namespace LinuxSampler {
+Line 66 
 namespace LinuxSampler {
           * parser errors, you may pass the VMParserContext object to method
           * exec() for actually executing the script.
           *
+          * It is your responsibility to free the returned VMParserContext
+          * object once you don't need it anymore.
+          *
           * @param s - entire source code of the script to be loaded
           * @returns parsed representation of the script
           */
-Line 176 
 namespace LinuxSampler {
+Line 173 
 namespace LinuxSampler {
          VMFunction* functionByName(const String& name) OVERRIDE;
          /**
+          * Whether the passed built-in function is disabled and should thus be
+          * ignored by the parser at the passed parser context (parser state
+          * where the built-in function call occurs).
+          *
+          * @param fn - built-in function to be checked
+          * @param ctx - parser context at the position where the built-in
+          *              function call is located within the script
+          */
+         bool isFunctionDisabled(VMFunction* fn, VMParserContext* ctx) OVERRIDE;
+         /**
           * Returns all built-in integer script variables. This method returns a
           * STL map, where the map's key is the variable name and the map's value
           * is the native pointer to the actual built-in variable.
-Line 183 
 namespace LinuxSampler {
+Line 191 
 namespace LinuxSampler {
           * This method is re-implemented by deriving classes to add more use
           * case specific built-in variables.
           */
-         std::map<String,VMIntRelPtr*> builtInIntVariables() OVERRIDE;
+         std::map<String,VMIntPtr*> builtInIntVariables() OVERRIDE;
          /**
           * Returns all built-in (8 bit) integer array script variables. This
-Line 197 
 namespace LinuxSampler {
+Line 205 
 namespace LinuxSampler {
          std::map<String,VMInt8Array*> builtInIntArrayVariables() OVERRIDE;
          /**
-          * Returns all built-in constant integer script variables, which can
+          * Returns all built-in constant integer script variables, which are
-          * only be read, but not be altered by scripts. This method returns a
+          * constant and their final data is already available at parser time
-          * STL map, where the map's key is the variable name and the map's value
+          * and won't change during runtime. Providing your built-in constants
-          * is the native pointer to the actual built-in constant variable.
+          * this way may lead to performance benefits compared to using other
+          * ways of providing built-in variables, because the script parser
+          * can perform optimizations when the script is refering to such
+          * constants.
+          *
+          * This type of built-in variable can only be read, but not be altered
+          * by scripts. This method returns a STL map, where the map's key is
+          * the variable name and the map's value is the final constant data.
           *
           * This method is re-implemented by deriving classes to add more use
           * case specific built-in constant integers.
           *
-          * @b Note: the term "constant" is a bit misleading here, since
+          * @b Note: In case your built-in variable should be read-only but its
-          * built-in constant integer variables may indeed change, i.e. for
+          * value is not already available at parser time (i.e. because its
-          * built-in constant integers which i.e. reflect some kind of status of
+          * value may change at runtime), then you should add it to
-          * the sampler. So rather see them as "read only" variables, not as
+          * builtInIntVariables() instead and use the macro
-          * being actually consistent in time.
+          * DECLARE_VMINT_READONLY() to define the variable for read-only
+          * access by scripts.
+          */
+         std::map<String,vmint> builtInConstIntVariables() OVERRIDE;
+         /**
+          * Returns all built-in constant real number (floating point) script
+          * variables, which are constant and their final data is already
+          * available at parser time and won't change during runtime. Providing
+          * your built-in constants this way may lead to performance benefits
+          * compared to using other ways of providing built-in variables, because
+          * the script parser can perform optimizations when the script is
+          * refering to such constants.
+          *
+          * This type of built-in variable can only be read, but not be altered
+          * by scripts. This method returns a STL map, where the map's key is
+          * the variable name and the map's value is the final constant data.
+          *
+          * This method is re-implemented by deriving classes to add more use
+          * case specific built-in constant real numbers.
+          */
+         std::map<String,vmfloat> builtInConstRealVariables() OVERRIDE;
+         /**
+          * Returns all built-in dynamic variables. This method returns a STL
+          * map, where the map's key is the dynamic variable's name and the
+          * map's value is the pointer to the actual object implementing the
+          * behavior which is actually generating the content of the dynamic
+          * variable.
+          *
+          * This method is re-implemented by deriving classes to add more use
+          * case specific built-in dynamic variables.
+          */
+         std::map<String,VMDynVar*> builtInDynamicVariables() OVERRIDE;
+         /**
+          * Enables or disables automatic suspension of scripts by the VM.
+          * If automatic suspension is enabled then scripts are monitored
+          * regarding their execution time and in case they are execution
+          * for too long, then they are automatically suspended by the VM for
+          * a certain amount of time in order to avoid any RT instablity
+          * issues caused by bugs in the script, i.e. endless while() loops
+          * or very large scripts.
+          *
+          * Automatic suspension is enabled by default due to the aimed
+          * real-time context of this virtual machine.
+          *
+          * @param b - true: enable auto suspension [default],
+          *            false: disable auto suspension
+          */
+         void setAutoSuspendEnabled(bool b = true);
+         /**
+          * Returns true in case automatic suspension of scripts by the VM is
+          * enabled. See setAutoSuspendEnabled() for details.
+          *
+          * Automatic suspension is enabled by default due to the aimed
+          * real-time context of this virtual machine.
+          */
+         bool isAutoSuspendEnabled() const;
+         /**
+          * By default (i.e. in production use) the built-in exit() function
+          * prohibits any arguments to be passed to its function by scripts. So
+          * by default, scripts trying to pass any arguments to the built-in
+          * exit() function will yield in a parser error.
+          *
+          * By calling this method the built-in exit() function will optionally
+          * accept one argument to be passed to its function call by scripts. The
+          * value of that function argument will become available by calling
+          * VMExecContext::exitResult() after execution of the script.
+          *
+          * @see VMExecContext::exitResult()
+          */
+         void setExitResultEnabled(bool b = true);
+         /**
+          * Returns @c true if the built-in exit() function optionally accepts
+          * a function argument by scripts.
+          *
+          * @see setExitResultEnabled()
           */
-         std::map<String,int> builtInConstIntVariables() OVERRIDE;
+         bool isExitResultEnabled() const;
          VMEventHandler* currentVMEventHandler(); //TODO: should be protected (only usable during exec() calls, intended only for VMFunctions)
          VMParserContext* currentVMParserContext(); //TODO: should be protected (only usable during exec() calls, intended only for VMFunctions)
-Line 220 
 namespace LinuxSampler {
+Line 315 
 namespace LinuxSampler {
      protected:
          VMEventHandler* m_eventHandler;
          ParserContext* m_parserContext;
-         CoreVMFunction_message* m_fnMessage;
+         bool m_autoSuspend;
-         CoreVMFunction_exit* m_fnExit;
+         bool m_acceptExitRes;
-         CoreVMFunction_wait* m_fnWait;
+         class CoreVMFunction_message* m_fnMessage;
-         CoreVMFunction_abs* m_fnAbs;
+         class CoreVMFunction_exit* m_fnExit;
-         CoreVMFunction_random* m_fnRandom;
+         class CoreVMFunction_wait* m_fnWait;
-         CoreVMFunction_num_elements* m_fnNumElements;
+         class CoreVMFunction_abs* m_fnAbs;
+         class CoreVMFunction_random* m_fnRandom;
+         class CoreVMFunction_num_elements* m_fnNumElements;
+         class CoreVMFunction_inc* m_fnInc;
+         class CoreVMFunction_dec* m_fnDec;
+         class CoreVMFunction_in_range* m_fnInRange;
+         class CoreVMFunction_sh_left* m_fnShLeft;
+         class CoreVMFunction_sh_right* m_fnShRight;
+         class CoreVMFunction_min* m_fnMin;
+         class CoreVMFunction_max* m_fnMax;
+         class CoreVMFunction_array_equal* m_fnArrayEqual;
+         class CoreVMFunction_search* m_fnSearch;
+         class CoreVMFunction_sort* m_fnSort;
+         class CoreVMFunction_int_to_real* m_fnIntToReal;
+         class CoreVMFunction_real_to_int* m_fnRealToInt;
+         class CoreVMFunction_round* m_fnRound;
+         class CoreVMFunction_ceil* m_fnCeil;
+         class CoreVMFunction_floor* m_fnFloor;
+         class CoreVMFunction_sqrt* m_fnSqrt;
+         class CoreVMFunction_log* m_fnLog;
+         class CoreVMFunction_log2* m_fnLog2;
+         class CoreVMFunction_log10* m_fnLog10;
+         class CoreVMFunction_exp* m_fnExp;
+         class CoreVMFunction_pow* m_fnPow;
+         class CoreVMFunction_sin* m_fnSin;
+         class CoreVMFunction_cos* m_fnCos;
+         class CoreVMFunction_tan* m_fnTan;
+         class CoreVMFunction_asin* m_fnAsin;
+         class CoreVMFunction_acos* m_fnAcos;
+         class CoreVMFunction_atan* m_fnAtan;
+         class CoreVMDynVar_NKSP_REAL_TIMER* m_varRealTimer;
+         class CoreVMDynVar_NKSP_PERF_TIMER* m_varPerfTimer;
      };
  } // namespace LinuxSampler

 Legend:



Removed from v.2885
 


changed lines


 
Added in v.3590
 Legend:



Removed from v.2885
 


changed lines


 
Added in v.3590
-Removed from v.2885
+Added in v.3590

	ViewVC Help
Powered by ViewVC