X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=libs%2Fardour%2Fardour%2Fprocessor.h;h=095ab7fadf8c7321fa9276c6e38a1ad17f977a56;hb=79abf3dfa6d649fbf1fb6fd16cd489f434d0b909;hp=68fdb5c6a6d4dc55a619ecc2e132f0b34eb9cd7c;hpb=0569107ddc0d2a8df6ca0a2c8cc16ebe8f3dee99;p=ardour.git diff --git a/libs/ardour/ardour/processor.h b/libs/ardour/ardour/processor.h index 68fdb5c6a6..095ab7fadf 100644 --- a/libs/ardour/ardour/processor.h +++ b/libs/ardour/ardour/processor.h @@ -1,5 +1,5 @@ /* - Copyright (C) 2000 Paul Davis + Copyright (C) 2009-2010 Paul Davis This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -24,87 +24,88 @@ #include #include -#include "pbd/statefuldestructible.h" - -#include +#include "pbd/statefuldestructible.h" #include "ardour/ardour.h" -#include "ardour/automatable_controls.h" #include "ardour/buffer_set.h" #include "ardour/latent.h" #include "ardour/session_object.h" +#include "ardour/libardour_visibility.h" #include "ardour/types.h" +#include "ardour/automatable.h" class XMLNode; +class ProcessorWindowProxy; +class PluginPinWindowProxy; namespace ARDOUR { class Session; class Route; -/* A mixer strip element - plugin, send, meter, etc. - */ -class Processor : public SessionObject, public AutomatableControls, public Latent +/** A mixer strip element - plugin, send, meter, etc */ +class LIBARDOUR_API Processor : public SessionObject, public Automatable, public Latent { public: static const std::string state_node_name; Processor(Session&, const std::string& name); - - virtual ~Processor() { } - - /** Configuration of a processor on a bus - * (i.e. how to apply to a BufferSet) - */ - struct Mapping { - ChanCount in; - ChanCount out; - }; - - virtual bool visible() const { return true; } - - uint32_t sort_key() const { return _sort_key; } - void set_sort_key (uint32_t key); - - bool active () const { return _active; } - + Processor (const Processor& other); + + virtual ~Processor(); + + virtual std::string display_name() const { return SessionObject::name(); } + + virtual bool display_to_user() const { return _display_to_user; } + virtual void set_display_to_user (bool); + + bool active () const { return _pending_active; } ///< ardour hard bypass + virtual bool enabled () const { return _pending_active; } ///< processor enabled/bypass + virtual bool bypassable () const { return true; } ///< enable is not automated or locked + + virtual bool does_routing() const { return false; } + bool get_next_ab_is_active () const { return _next_ab_is_active; } void set_next_ab_is_active (bool yn) { _next_ab_is_active = yn; } - - virtual nframes_t signal_latency() const { return 0; } - - virtual void transport_stopped (nframes_t frame) {} - - virtual void set_block_size (nframes_t nframes) {} - - virtual void run_in_place (BufferSet& bufs, - sframes_t start_frame, sframes_t end_frame, - nframes_t nframes) { assert(is_in_place()); } - - virtual void run_out_of_place (BufferSet& input, BufferSet& output, - sframes_t start_frame, sframes_t end_frame, - nframes_t nframes) { assert(is_out_of_place()); } - - virtual void silence (nframes_t nframes) {} - - void activate () { _active = true; ActiveChanged(); } - void deactivate () { _active = false; ActiveChanged(); } - - virtual bool configure_io (ChanCount in, ChanCount out); - /* Derived classes should override these, or processor appears as an in-place pass-through */ + virtual framecnt_t signal_latency() const { return 0; } + + virtual void set_input_latency (framecnt_t); + framecnt_t input_latency () const { return _input_latency; } + + virtual int set_block_size (pframes_t /*nframes*/) { return 0; } + virtual bool requires_fixed_sized_buffers() const { return false; } + + /** @param result_required true if, on return from this method, @a bufs is required to contain valid data; + * if false, the method need not bother writing to @a bufs if it doesn't want to. + */ + virtual void run (BufferSet& /*bufs*/, framepos_t /*start_frame*/, framepos_t /*end_frame*/, double speed, pframes_t /*nframes*/, bool /*result_required*/) {} + virtual void silence (framecnt_t nframes, framepos_t start_frame) { automation_run (start_frame, nframes); } + + virtual void activate () { _pending_active = true; ActiveChanged(); } + virtual void deactivate () { _pending_active = false; ActiveChanged(); } + virtual void flush() {} - /** In-place processors implement run_in_place and modify thee input buffer parameter */ - virtual bool is_in_place () const { return true; } + virtual void enable (bool yn) { if (yn) { activate (); } else { deactivate (); } } - /* Out-Of-Place processors implement run_out_of_place, don't modify the input parameter - * and write to their output parameter */ - virtual bool is_out_of_place () const { return false; } + virtual bool configure_io (ChanCount in, ChanCount out); - virtual bool can_support_io_configuration (const ChanCount& in, ChanCount& out) const = 0; + /* Derived classes should override these, or processor appears as an in-place pass-through */ + + virtual bool can_support_io_configuration (const ChanCount& in, ChanCount& out) = 0; virtual ChanCount input_streams () const { return _configured_input; } virtual ChanCount output_streams() const { return _configured_output; } + virtual void realtime_handle_transport_stopped () {} + virtual void realtime_locate () {} + + /* most processors won't care about this, but plugins that + receive MIDI or similar data from an input source that + may suddenly go "quiet" because of monitoring changes + need to know about it. + */ + virtual void monitoring_changed() {} + /* note: derived classes should implement state(), NOT get_state(), to allow us to merge C++ inheritance and XML lack-of-inheritance reasonably smoothly. @@ -112,26 +113,46 @@ class Processor : public SessionObject, public AutomatableControls, public Laten virtual XMLNode& state (bool full); XMLNode& get_state (void); - int set_state (const XMLNode&); - - void *get_gui () const { return _gui; } - void set_gui (void *p) { _gui = p; } + int set_state (const XMLNode&, int version); - static sigc::signal ProcessorCreated; + virtual void set_pre_fader (bool); - sigc::signal ActiveChanged; - sigc::signal ConfigurationChanged; + PBD::Signal0 ActiveChanged; + PBD::Signal0 BypassableChanged; + PBD::Signal2 ConfigurationChanged; + + /* cross-thread signals. + * This allows control-surfaces to show/hide a plugin GUI. + */ + PBD::Signal0 ToggleUI; + PBD::Signal0 ShowUI; + PBD::Signal0 HideUI; + + ProcessorWindowProxy * window_proxy () const { return _window_proxy; } + void set_window_proxy (ProcessorWindowProxy* wp) { _window_proxy = wp; } + + PluginPinWindowProxy * pinmgr_proxy () const { return _pinmgr_proxy; } + void set_pingmgr_proxy (PluginPinWindowProxy* wp) { _pinmgr_proxy = wp ; } + + virtual void set_owner (SessionObject*); + SessionObject* owner() const; protected: + virtual int set_state_2X (const XMLNode&, int version); + int _pending_active; bool _active; bool _next_ab_is_active; bool _configured; ChanCount _configured_input; ChanCount _configured_output; - uint32_t _sort_key; - void* _gui; /* generic, we don't know or care what this is */ - Mapping _mapping; + bool _display_to_user; + bool _pre_fader; ///< true if this processor is currently placed before the Amp, otherwise false + void* _ui_pointer; + ProcessorWindowProxy *_window_proxy; + PluginPinWindowProxy *_pinmgr_proxy; + SessionObject* _owner; + framecnt_t _input_latency; }; } // namespace ARDOUR