add a simple method to return "the instrument" associated with a Route. see the comments about the semantics of this, which do not preclude 0..N "instruments" in a single route

git-svn-id: svn://localhost/ardour2/branches/3.0@12027 d708f5d6-7413-0410-9779-e7cbd77b26cf

1 files changed, 9 insertions, 0 deletions

diff --git a/libs/ardour/ardour/route.h b/libs/ardour/ardour/route.h
index 89a0cac214..bdda941a97 100644
--- a/libs/ardour/ardour/route.h
+++ b/libs/ardour/ardour/route.h
@@ -397,6 +397,15 @@ class Route : public SessionObject, public Automatable, public RouteGroupMember,
 	boost::shared_ptr<AutomationControl> gain_control() const;
 	boost::shared_ptr<Pannable> pannable() const;
 
+	/**
+	   Return the first processor that accepts has at least one MIDI input
+	   and at least one audio output. In the vast majority of cases, this
+	   will be "the instrument". This does not preclude other MIDI->audio
+	   processors later in the processing chain, but that would be a
+	   special case not covered by this utility function.
+	*/
+	boost::shared_ptr<Processor> the_instrument() const;
+
 	void automation_snapshot (framepos_t now, bool force=false);
 	void protect_automation ();