/[svn]/linuxsampler/trunk/src/engines/sfz/sfz.h
ViewVC logotype

Diff of /linuxsampler/trunk/src/engines/sfz/sfz.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2529 by schoenebeck, Tue Mar 4 20:41:47 2014 UTC revision 3082 by schoenebeck, Mon Jan 9 18:39:35 2017 UTC
# Line 3  Line 3 
3   *   LinuxSampler - modular, streaming capable sampler                     *   *   LinuxSampler - modular, streaming capable sampler                     *
4   *                                                                         *   *                                                                         *
5   *   Copyright (C) 2008 Anders Dahnielson <anders@dahnielson.com>          *   *   Copyright (C) 2008 Anders Dahnielson <anders@dahnielson.com>          *
6   *   Copyright (C) 2009 - 2013 Anders Dahnielson and Grigor Iliev          *   *   Copyright (C) 2009 - 2016 Anders Dahnielson and Grigor Iliev          *
7   *                                                                         *   *                                                                         *
8   *   This program is free software; you can redistribute it and/or modify  *   *   This program is free software; you can redistribute it and/or modify  *
9   *   it under the terms of the GNU General Public License as published by  *   *   it under the terms of the GNU General Public License as published by  *
# Line 27  Line 27 
27  #include <fstream>  #include <fstream>
28  #include <iostream>  #include <iostream>
29  #include <vector>  #include <vector>
30    #include <stack>
31  #include <string>  #include <string>
32  #include <stdexcept>  #include <stdexcept>
33    
34  #include "../common/SampleFile.h"  #include "../common/SampleFile.h"
35  #include "../common/SampleManager.h"  #include "../common/SampleManager.h"
36  #include "../../common/ArrayList.h"  #include "../../common/ArrayList.h"
37    #include "../../common/optional.h"
38    #include "../../common/Exception.h"
39    #include "../../common/Path.h"
40    
41  #define TRIGGER_ATTACK  ((unsigned char) (1 << 0)) // 0x01  #define TRIGGER_ATTACK  ((unsigned char) (1 << 0)) // 0x01
42  #define TRIGGER_RELEASE ((unsigned char) (1 << 1)) // 0x02  #define TRIGGER_RELEASE ((unsigned char) (1 << 1)) // 0x02
43  #define TRIGGER_FIRST   ((unsigned char) (1 << 2)) // 0x04  #define TRIGGER_FIRST   ((unsigned char) (1 << 2)) // 0x04
44  #define TRIGGER_LEGATO  ((unsigned char) (1 << 3)) // 0x08  #define TRIGGER_LEGATO  ((unsigned char) (1 << 3)) // 0x08
45    
46    #define optional LinuxSampler::optional
47    
48  namespace sfz  namespace sfz
49  {  {
50      // Forward declarations      // Forward declarations
# Line 50  namespace sfz Line 56  namespace sfz
56      class LookupTable;      class LookupTable;
57      class SampleManager;      class SampleManager;
58    
59        class Exception : public LinuxSampler::Exception {
60        public:
61        };
62    
63      class Sample : public LinuxSampler::SampleFileBase<Region> {      class Sample : public LinuxSampler::SampleFileBase<Region> {
64          private:          private:
65              int  End;              int  End;
# Line 79  namespace sfz Line 89  namespace sfz
89              friend class SampleManager;              friend class SampleManager;
90      };      };
91    
92        /** @brief Real-time instrument script (sfz format extension).
93         *
94         * Real-time instrument scripts are user supplied small programs which can
95         * be used by instrument designers to create custom behaviors and features
96         * not available in the stock sampler engine. Features which might be very
97         * exotic or specific for the respective instrument.
98         *
99         * This is an extension of the sfz format, thus a feature which is currently
100         * only supported by LinuxSampler. Scripts will not load with other sfz
101         * players right now. The dedicated sfz opcode for this purpose is:
102         * @code
103         * script=path/to/scriptfile
104         * @endcode
105         * This opcode is recommended to appear in the sfz file's global section,
106         * however ATM the precise location of the opcode is simply ignored.
107         * Currently there may only be one @c script opcode per instrument. Further
108         * @c script opcodes will currently simply be ignored. In future using
109         * multiple @c script opcodes will be supported as well, the scripts will
110         * then be executed by the sampler in the order in which their opcodes
111         * appeared in their sfz file.
112         *
113         * You find more informations about Instrument Scripts on the LinuxSampler
114         * documentation site:
115         *
116         * - <a href="http://doc.linuxsampler.org/Instrument_Scripts/">About Instrument Scripts in General</a>
117         * - <a href="http://doc.linuxsampler.org/Instrument_Scripts/NKSP_Language">Introduction to the NKSP Script Language</a>
118         * - <a href="http://doc.linuxsampler.org/Instrument_Scripts/NKSP_Language/Reference/">NKSP Reference Manual</a>
119         */
120        class Script {
121            public:
122                enum Language_t {
123                    LANGUAGE_NKSP = 0 ///< NKSP stands for "Is Not KSP" (default). Refer to the <a href="http://doc.linuxsampler.org/Instrument_Scripts/NKSP_Language/Reference/">NKSP Reference Manual</a> for details about this script language.
124                };
125    
126                Script(LinuxSampler::Path path);
127                Script(String path);
128                virtual ~Script();
129    
130                String     Name() const;    ///< Name of the script (currently returns the file's file name without its path).
131                Language_t Language();      ///< Programming language and dialect the script was written in (currently always returns LANGUAGE_NKSP).
132                String     GetSourceCode(); ///< Reads the script's source code from its script file and returns the entire source code as String.
133            private:
134                LinuxSampler::Path m_path;
135        };
136    
137      // Enumerations      // Enumerations
138      enum sw_vel_t    { VEL_CURRENT, VEL_PREVIOUS };      enum sw_vel_t    { VEL_CURRENT, VEL_PREVIOUS };
139      enum off_mode_t  { OFF_FAST, OFF_NORMAL };      enum off_mode_t  { OFF_FAST, OFF_NORMAL };
# Line 141  namespace sfz Line 196  namespace sfz
196      };      };
197    
198      /////////////////////////////////////////////////////////////      /////////////////////////////////////////////////////////////
     // class Exception  
   
     class Exception :  
         public std::runtime_error  
     {  
         public:  
         Exception(const std::string& msg) :  
             runtime_error(msg)  
         {  
         }  
   
         std::string Message()  
         {  
             return what();  
         }  
   
         void PrintMessage()  
         {  
             std::cerr << what() << std::endl << std::flush;  
         }  
     };  
   
     /////////////////////////////////////////////////////////////  
     // class optional  
   
     //  Handy class nicked from LinuxSampler...  
     //  Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck  
     //  Copyright (C) 2005, 2006 Christian Schoenebeck  
   
     class optional_base  
     {  
         public:  
         class nothing_t { public: nothing_t() {} };  
         static const nothing_t nothing;  
     };  
   
     template<class T>  
     class optional :  
         public optional_base  
     {  
         public:  
         optional()  
         {  
             initialized = false;  
         }  
   
         optional(T data)  
         {  
             this->data  = data;  
             initialized = true;  
         }  
   
         optional(nothing_t)  
         {  
             initialized = false;  
         }  
   
         template <class T_inner>  
         optional(T_inner data)  
         {  
             this->data  = T(data);  
             initialized = true;  
         }  
   
         const T& get() const throw (Exception)  
         {  
             if (!initialized) throw Exception("optional variable not initialized");  
             return data;  
         }  
   
         T& get() throw (Exception)  
         {  
             if (!initialized) throw Exception("optional variable not initialized");  
             return data;  
         }  
   
         void unset()  
         {  
             initialized = false;  
         }  
   
         optional& operator =(const optional& arg) throw (Exception)  
         {  
             if (!arg.initialized) {  
                             initialized = false;  
                         } else {  
                             this->data  = arg.data;  
                             initialized = true;  
                         }  
             return *this;  
         }  
   
         optional& operator =(const T& arg)  
         {  
             this->data  = arg;  
             initialized = true;  
             return *this;  
         }  
   
         const T& operator *() const throw (Exception) { return get(); }  
         T&       operator *()       throw (Exception) { return get(); }  
   
         const T* operator ->() const throw (Exception)  
         {  
             if (!initialized) throw Exception("optional variable not initialized");  
             return &data;  
         }  
   
         T* operator ->() throw (Exception)  
         {  
             if (!initialized) throw Exception("optional variable not initialized");  
             return &data;  
         }  
   
         operator bool()   const { return initialized; }  
         bool operator !() const { return !initialized; }  
   
         protected:  
         T    data;  
         bool initialized;  
     };  
   
     /////////////////////////////////////////////////////////////  
199      // class Articulation      // class Articulation
200    
201      // Articulation containing all performance parameters for synthesis      // Articulation containing all performance parameters for synthesis
# Line 713  namespace sfz Line 645  namespace sfz
645          /// List of Regions belonging to this Instrument          /// List of Regions belonging to this Instrument
646          std::vector<Region*> regions;          std::vector<Region*> regions;
647          ::LinuxSampler::ArrayList<Curve> curves;          ::LinuxSampler::ArrayList<Curve> curves;
648            std::vector<Script> scripts;
649    
650          friend class File;          friend class File;
651          friend class Query;          friend class Query;
# Line 727  namespace sfz Line 660  namespace sfz
660      };      };
661    
662      /////////////////////////////////////////////////////////////      /////////////////////////////////////////////////////////////
663      // class Group      // class ContainerDefinition
664        
665      /// A Group act just as a template containing Region default values      ///A ContainerDefinition is any section of the SFZ files that contains other Definitions (global, master, and group).
666      class Group :      class ContainerDefinition :
667          public Definition          public Definition
668      {      {
669      public:      public:
670          Group();          enum section_type {GROUP = 0, MASTER, GLOBAL};
671          virtual ~Group();          
672            ContainerDefinition(section_type type);
673          /// Reset Group to default values          virtual ~ContainerDefinition();
674            
675            /// Reset all properties to default values
676          void Reset();          void Reset();
677            
678          /// Create a new Region          /// Copy all properties of this object to another Definition
679          Region* RegionFactory();          void CopyValuesToDefinition(Definition* definition);
680            
681          // id counter          section_type level;
         int id;  
   
682      };      };
683    
684      /////////////////////////////////////////////////////////////      /////////////////////////////////////////////////////////////
# Line 784  namespace sfz Line 717  namespace sfz
717          Instrument* _instrument;          Instrument* _instrument;
718    
719          // state variables          // state variables
720          enum section_t { UNKNOWN, GROUP, REGION, CONTROL, CURVE };          enum section_t { UNKNOWN, REGION, GROUP, MASTER, GLOBAL, CONTROL, CURVE };
721          section_t _current_section;          section_t _current_section;
722          Region* _current_region;          Region* _current_region;
723          Group* _current_group;          std::stack<ContainerDefinition*> _current_containers;
724            
725            static const std::string MACRO_NAME_CHARS;
726            static const std::string MACRO_VALUE_CHARS;
727            std::map<std::string, std::string> _defined_macros;
728            
729          Curve* _current_curve;          Curve* _current_curve;
730          Definition* pCurDef;          Definition* pCurDef;
731            int id;
732    
733          // control header directives          // control header directives
734          std::string default_path;          std::string default_path;
Legend:
Removed from v.2529  
changed lines
  Added in v.3082
  ViewVC Help
Powered by ViewVC