Chris@0: /* -*- c-basic-offset: 4 -*-  vi:set ts=8 sts=4 sw=4: */
Chris@0: 
Chris@0: /*
Chris@0:     A waveform viewer and audio annotation editor.
Chris@0:     Chris Cannam, Queen Mary University of London, 2005
Chris@0:    
Chris@0:     This is experimental software.  Not for distribution.
Chris@0: */
Chris@0: 
Chris@0: #ifndef _TRANSFORM_H_
Chris@0: #define _TRANSFORM_H_
Chris@0: 
Chris@0: #include <QThread>
Chris@0: 
Chris@0: #include "base/Model.h"
Chris@0: 
Chris@0: typedef QString TransformName;
Chris@0: 
Chris@0: /**
Chris@0:  * A Transform turns one data model into another.
Chris@0:  *
Chris@0:  * Typically in this application, a Transform might have a
Chris@0:  * DenseTimeValueModel as its input (e.g. an audio waveform) and a
Chris@0:  * SparseOneDimensionalModel (e.g. detected beats) as its output.
Chris@0:  *
Chris@0:  * The Transform typically runs in the background, as a separate
Chris@0:  * thread populating the output model.  The model is available to the
Chris@0:  * user of the Transform immediately, but may be initially empty until
Chris@0:  * the background thread has populated it.
Chris@0:  */
Chris@0: 
Chris@0: class Transform : public QThread
Chris@0: {
Chris@0: public:
Chris@0:     virtual ~Transform();
Chris@0: 
Chris@0:     Model *getInputModel()  { return m_input; }
Chris@0:     Model *getOutputModel() { return m_output; }
Chris@0:     Model *detachOutputModel() { m_detached = true; return m_output; }
Chris@0: 
Chris@0: protected:
Chris@0:     Transform(Model *m);
Chris@0: 
Chris@0:     Model *m_input; // I don't own this
Chris@0:     Model *m_output; // I own this, unless...
Chris@0:     bool m_detached; // ... this is true.
Chris@0:     bool m_deleting;
Chris@0: };
Chris@0: 
Chris@0: #endif