convert codebase to use Temporal for various time types
[ardour.git] / libs / ardour / ardour / lua_api.h
index 7578fab03e41cdc3aca1db365bc7546de5c38aa4..6d1deeb5aa2656055decb4f5a8336407d998cd97 100644 (file)
 #include <boost/shared_ptr.hpp>
 #include <vamp-hostsdk/Plugin.h>
 
+#include "evoral/Note.hpp"
+
 #include "ardour/libardour_visibility.h"
 
+#include "ardour/midi_model.h"
 #include "ardour/processor.h"
 #include "ardour/session.h"
 
@@ -97,6 +100,15 @@ namespace ARDOUR { namespace LuaAPI {
         */
        float get_processor_param (boost::shared_ptr<Processor> proc, uint32_t which, bool &ok);
 
+       /** reset a processor to its default values (only works for plugins )
+        *
+        * This is a wrapper which looks up the Processor by plugin-insert.
+        *
+        * @param proc Plugin-Insert
+        * @returns true on success, false when the processor is not a plugin
+        */
+       bool reset_processor_to_default (boost::shared_ptr<Processor> proc);
+
        /** set a plugin control-input parameter value
         *
         * This is a wrapper around set_processor_param which looks up the Processor by plugin-insert.
@@ -155,13 +167,56 @@ namespace ARDOUR { namespace LuaAPI {
         */
        int hsla_to_rgba (lua_State *lua);
 
-       /* Creates a filename from a series of elements using the correct separator for filenames.
+       /**
+        * A convenience function to expand RGBA parameters from an integer
+        *
+        * convert a Canvas::Color (uint32_t 0xRRGGBBAA) into
+        * double RGBA values which can be passed as parameters to
+        * Cairo::Context::set_source_rgba
+        *
+        * Example:
+        * @code
+        * local r, g, b, a = ARDOUR.LuaAPI.color_to_rgba (0x88aa44ff)
+        * cairo_ctx:set_source_rgba (ARDOUR.LuaAPI.color_to_rgba (0x11336699)
+        * @endcode
+        * @returns 4 parameters: red, green, blue, alpha (in range 0..1)
+        */
+       int color_to_rgba (lua_State *lua);
+
+       /**
+        * Creates a filename from a series of elements using the correct separator for filenames.
         *
         * No attempt is made to force the resulting filename to be an absolute path.
         * If the first element is a relative path, the result will be a relative path.
         */
        int build_filename (lua_State *lua);
 
+       /**
+        * Generic conversion from audio sample count to timecode.
+        * (TimecodeType, sample-rate, sample-pos)
+        */
+       int sample_to_timecode (lua_State *L);
+
+       /**
+        * Generic conversion from timecode to audio sample count.
+        * (TimecodeType, sample-rate, hh, mm, ss, ff)
+        */
+       int timecode_to_sample (lua_State *L);
+
+       /**
+        * Use current session settings to convert
+        * audio-sample count into hh, mm, ss, ff
+        * timecode (this include session pull up/down).
+        */
+       int sample_to_timecode_lua (lua_State *L);
+
+       /**
+        * Use current session settings to convert
+        * timecode (hh, mm, ss, ff) to audio-sample
+        * count (this include session pull up/down).
+        */
+       int timecode_to_sample_lua (lua_State *L);
+
        class Vamp {
        /** Vamp Plugin Interface
         *
@@ -176,29 +231,37 @@ namespace ARDOUR { namespace LuaAPI {
                public:
                        Vamp (const std::string&, float sample_rate);
                        ~Vamp ();
+
+                       /** Search for all available available Vamp plugins.
+                        * @returns list of plugin-keys
+                        */
+                       static std::vector<std::string> list_plugins ();
+
                        ::Vamp::Plugin* plugin () { return _plugin; }
 
-                       /* high-level abstraction to process a single channel of the given Readable.
+                       /** high-level abstraction to process a single channel of the given Readable.
                         *
                         * If the plugin is not yet initialized, initialize() is called.
                         *
                         * if @cb is not nil, it is called with the immediate
                         * Vamp::Plugin::Features on every process call.
                         *
-                        * @r readable
-                        * @channel channel to process
-                        * @cb lua callback function
+                        * @param r readable
+                        * @param channel channel to process
+                        * @param fn lua callback function
                         * @return 0 on success
                         */
-                       int analyze (boost::shared_ptr<ARDOUR::Readable>, uint32_t channel, luabridge::LuaRef fn);
+                       int analyze (boost::shared_ptr<ARDOUR::Readable> r, uint32_t channel, luabridge::LuaRef fn);
 
                        /** call plugin():reset() and clear intialization flag */
                        void reset ();
 
                        /** initialize the plugin for use with analyze().
                         *
-                        * This is equivalent to plugin():initialise (1, 8192, 8192)
+                        * This is equivalent to plugin():initialise (1, ssiz, bsiz)
                         * and prepares a plugin for analyze.
+                        * (by preferred step and block sizes are used. if the plugin
+                        * does not specify them or they're larger than 8K, both are set to 1024)
                         *
                         * Manual initialization is only required to set plugin-parameters
                         * which depend on prior initialization of the plugin.
@@ -206,7 +269,7 @@ namespace ARDOUR { namespace LuaAPI {
                         * @code
                         * vamp:reset ()
                         * vamp:initialize ()
-                        * vamp:plugin():setParameter (0, 1.5)
+                        * vamp:plugin():setParameter (0, 1.5, nil)
                         * vamp:analyze (r, 0)
                         * @endcode
                         */
@@ -214,14 +277,33 @@ namespace ARDOUR { namespace LuaAPI {
 
                        bool initialized () const { return _initialized; }
 
+                       /** process given array of audio-samples.
+                        *
+                        * This is a lua-binding for vamp:plugin():process ()
+                        *
+                        * @param d audio-data, the vector must match the configured channel count
+                        *    and hold a complete buffer for every channel as set during
+                        *    plugin():initialise()
+                        * @param rt timestamp matching the provided buffer.
+                        * @returns features extracted from that data (if the plugin is causal)
+                        */
+                       ::Vamp::Plugin::FeatureSet process (const std::vector<float*>& d, ::Vamp::RealTime rt);
+
                private:
                        ::Vamp::Plugin* _plugin;
                        float           _sample_rate;
-                       framecnt_t      _bufsize;
+                       samplecnt_t      _bufsize;
+                       samplecnt_t      _stepsize;
                        bool            _initialized;
 
        };
 
+       boost::shared_ptr<Evoral::Note<Temporal::Beats> >
+               new_noteptr (uint8_t, Temporal::Beats, Temporal::Beats, uint8_t, uint8_t);
+
+       std::list<boost::shared_ptr< Evoral::Note<Temporal::Beats> > >
+               note_list (boost::shared_ptr<ARDOUR::MidiModel>);
+
 } } /* namespace */
 
 namespace ARDOUR { namespace LuaOSC {