You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
113 lines
3.5 KiB
113 lines
3.5 KiB
/*
|
|
Rosegarden
|
|
A sequencer and musical notation editor.
|
|
|
|
This program is Copyright 2000-2008
|
|
Guillaume Laurent <glaurent@telegraph-road.org>,
|
|
Chris Cannam <cannam@all-day-breakfast.com>,
|
|
Richard Bown <bownie@bownie.com>
|
|
|
|
The moral right of the authors to claim authorship of this work
|
|
has been asserted.
|
|
|
|
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 the Free Software Foundation; either version 2 of the
|
|
License, or (at your option) any later version. See the file
|
|
COPYING included with this distribution for more information.
|
|
*/
|
|
|
|
#ifndef _RUNNABLE_PLUGIN_INSTANCE_H_
|
|
#define _RUNNABLE_PLUGIN_INSTANCE_H_
|
|
|
|
#include <tqstring.h>
|
|
#include <tqstringlist.h>
|
|
#include <vector>
|
|
|
|
#include "RealTime.h"
|
|
|
|
namespace Rosegarden
|
|
{
|
|
|
|
class PluginFactory;
|
|
|
|
/**
|
|
* RunnablePluginInstance is a very trivial interface that an audio
|
|
* process can use to refer to an instance of a plugin without needing
|
|
* to know what type of plugin it is.
|
|
*
|
|
* The audio code calls run() on an instance that has been passed to
|
|
* it, and assumes that the passing code has already initialised the
|
|
* plugin, connected its inputs and outputs and so on, and that there
|
|
* is an understanding in place about the sizes of the buffers in use
|
|
* by the plugin. All of this depends on the subclass implementation.
|
|
*/
|
|
|
|
class RunnablePluginInstance
|
|
{
|
|
public:
|
|
typedef float sample_t;
|
|
|
|
virtual ~RunnablePluginInstance();
|
|
|
|
virtual bool isOK() const = 0;
|
|
|
|
virtual TQString getIdentifier() const = 0;
|
|
|
|
/**
|
|
* Run for one block, starting at the given time. The start time
|
|
* may be of interest to synths etc that may have queued events
|
|
* waiting. Other plugins can ignore it.
|
|
*/
|
|
virtual void run(const RealTime &blockStartTime) = 0;
|
|
|
|
virtual size_t getBufferSize() = 0;
|
|
|
|
virtual size_t getAudioInputCount() = 0;
|
|
virtual size_t getAudioOutputCount() = 0;
|
|
|
|
virtual sample_t **getAudioInputBuffers() = 0;
|
|
virtual sample_t **getAudioOutputBuffers() = 0;
|
|
|
|
virtual TQStringList getPrograms() { return TQStringList(); }
|
|
virtual TQString getCurrentProgram() { return TQString(); }
|
|
virtual TQString getProgram(int /* bank */, int /* program */) { return TQString(); }
|
|
virtual unsigned long getProgram(TQString /* name */) { return 0; } // bank << 16 + program
|
|
virtual void selectProgram(TQString) { }
|
|
|
|
virtual void setPortValue(unsigned int port, float value) = 0;
|
|
virtual float getPortValue(unsigned int port) = 0;
|
|
|
|
virtual TQString configure(TQString /* key */, TQString /* value */) { return TQString(); }
|
|
|
|
virtual void sendEvent(const RealTime & /* eventTime */,
|
|
const void * /* event */) { }
|
|
|
|
virtual bool isBypassed() const = 0;
|
|
virtual void setBypassed(bool value) = 0;
|
|
|
|
// This should be called after setup, but while not actually playing.
|
|
virtual size_t getLatency() = 0;
|
|
|
|
virtual void silence() = 0;
|
|
virtual void discardEvents() { }
|
|
virtual void setIdealChannelCount(size_t channels) = 0; // must also silence(); may also re-instantiate
|
|
|
|
void setFactory(PluginFactory *f) { m_factory = f; } // ew
|
|
|
|
protected:
|
|
RunnablePluginInstance(PluginFactory *factory, TQString identifier) :
|
|
m_factory(factory), m_identifier(identifier) { }
|
|
|
|
PluginFactory *m_factory;
|
|
TQString m_identifier;
|
|
|
|
friend class PluginFactory;
|
|
};
|
|
|
|
typedef std::vector<RunnablePluginInstance *> RunnablePluginInstances;
|
|
|
|
}
|
|
|
|
#endif
|