X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=libs%2Fardour%2Fardour%2Fprocessor.h;h=85d466a169265434d859ba44da3aa4a7343d727e;hb=0622a0cc3068a06d328119e90b7d9c5f5a84df32;hp=3985306d0109f7ba577ef0b0f0e8b290123d9038;hpb=b5af3bb8e313e13166cc54c60a14e5492e674065;p=ardour.git diff --git a/libs/ardour/ardour/processor.h b/libs/ardour/ardour/processor.h index 3985306d01..85d466a169 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,88 +24,112 @@ #include #include -#include +#include "pbd/statefuldestructible.h" -#include - -#include -#include -#include -#include -#include -#include +#include "ardour/ardour.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; namespace ARDOUR { class Session; +class Route; -/* A mixer strip element - plugin, send, meter, etc. - */ -class Processor : public Automatable, public Latent +/** A mixer strip element - plugin, send, meter, etc */ +class LIBARDOUR_API Processor : public SessionObject, public Automatable, public Latent { public: - static const string state_node_name; + static const std::string state_node_name; + + Processor(Session&, const std::string& name); + Processor (const Processor& other); - Processor(Session&, const string& name, Placement p); // TODO: remove placement in favour of sort key - virtual ~Processor() { } - - static boost::shared_ptr clone (boost::shared_ptr); - - uint32_t sort_key() const { return _sort_key; } - void set_sort_key (uint32_t key); - - Placement placement() const { return _placement; } - void set_placement (Placement); - - bool active () const { return _active; } - void set_active (bool yn); - + + 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; } + + 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 (BufferSet& bufs, nframes_t start_frame, nframes_t end_frame, nframes_t nframes, nframes_t offset) = 0; - virtual void silence (nframes_t nframes, nframes_t offset) {} - - virtual void activate () { _active = true; ActiveChanged.emit(); } - virtual void deactivate () { _active = false; ActiveChanged.emit(); } - - virtual bool configure_io (ChanCount in, ChanCount out) { _configured_input = in; return (_configured = true); } - - /* Act as a pass through, if not overridden */ - virtual bool can_support_input_configuration (ChanCount in) const { return true; } - virtual ChanCount output_for_input_configuration (ChanCount in) const { return in; } - virtual ChanCount output_streams() const { return _configured_input; } + + virtual framecnt_t signal_latency() const { return 0; } + + 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*/, pframes_t /*nframes*/, bool /*result_required*/) {} + virtual void silence (framecnt_t /*nframes*/) {} + + virtual void activate () { _pending_active = true; ActiveChanged(); } + virtual void deactivate () { _pending_active = false; ActiveChanged(); } + virtual void flush() {} + + virtual bool configure_io (ChanCount in, ChanCount out); + + /* 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. + */ virtual XMLNode& state (bool full); - virtual XMLNode& get_state (void); - virtual int set_state (const XMLNode&); - - void *get_gui () const { return _gui; } - void set_gui (void *p) { _gui = p; } + XMLNode& get_state (void); + int set_state (const XMLNode&, int version); + + void set_pre_fader (bool); - static sigc::signal ProcessorCreated; + PBD::Signal0 ActiveChanged; + PBD::Signal2 ConfigurationChanged; - sigc::signal ActiveChanged; - sigc::signal PlacementChanged; + void set_ui (void*); + void* get_ui () const { return _ui_pointer; } + + 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; - Placement _placement; - uint32_t _sort_key; - void* _gui; /* generic, we don't know or care what this is */ + ChanCount _configured_output; + bool _display_to_user; + bool _pre_fader; ///< true if this processor is currently placed before the Amp, otherwise false + void* _ui_pointer; + SessionObject* _owner; }; } // namespace ARDOUR