Chris@420: /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */
Chris@420: 
Chris@420: /*
Chris@420:     Sonic Visualiser
Chris@420:     An audio file viewer and annotation editor.
Chris@420:     Centre for Digital Music, Queen Mary, University of London.
Chris@420:     This file copyright 2006 Chris Cannam and QMUL.
Chris@420:     
Chris@420:     This program is free software; you can redistribute it and/or
Chris@420:     modify it under the terms of the GNU General Public License as
Chris@420:     published by the Free Software Foundation; either version 2 of the
Chris@420:     License, or (at your option) any later version.  See the file
Chris@420:     COPYING included with this distribution for more information.
Chris@420: */
Chris@420: 
Chris@420: #ifndef ALIGN_H
Chris@420: #define ALIGN_H
Chris@420: 
Chris@420: #include <QString>
Chris@423: #include <QObject>
Chris@423: #include <QProcess>
Chris@423: #include <set>
Chris@420: 
Chris@420: class Model;
Chris@423: class AlignmentModel;
Chris@665: class Document;
Chris@420: 
Chris@423: class Align : public QObject
Chris@420: {
Chris@423:     Q_OBJECT
Chris@423:     
Chris@420: public:
Chris@420:     Align() : m_error("") { }
Chris@420: 
Chris@423:     /**
Chris@423:      * Align the "other" model to the reference, attaching an
Chris@423:      * AlignmentModel to it. Alignment is carried out by the method
Chris@423:      * configured in the user preferences (either a plugin transform
Chris@423:      * or an external process) and is done asynchronously. 
Chris@423:      *
Chris@423:      * A single Align object may carry out many simultanous alignment
Chris@423:      * calls -- you do not need to create a new Align object each
Chris@423:      * time, nor to wait for an alignment to be complete before
Chris@423:      * starting a new one.
Chris@423:      * 
Chris@423:      * The Align object must survive after this call, for at least as
Chris@428:      * long as the alignment takes. The usual expectation is that the
Chris@428:      * Align object will simply share the process or document
Chris@428:      * lifespan.
Chris@423:      */
Chris@665:     bool alignModel(Document *doc,
Chris@665:                     Model *reference,
Chris@665:                     Model *other); // via user preference
Chris@422:     
Chris@665:     bool alignModelViaTransform(Document *doc,
Chris@665:                                 Model *reference,
Chris@665:                                 Model *other);
Chris@665: 
Chris@665:     bool alignModelViaProgram(Document *doc,
Chris@665:                               Model *reference,
Chris@665:                               Model *other,
Chris@665:                               QString program);
Chris@420: 
Chris@428:     /**
Chris@428:      * Return true if the alignment facility is available (relevant
Chris@428:      * plugin installed, etc).
Chris@428:      */
Chris@428:     static bool canAlign();
Chris@428:     
Chris@420:     QString getError() const { return m_error; }
Chris@428: 
Chris@428: signals:
Chris@428:     /**
Chris@428:      * Emitted when an alignment is successfully completed. The
Chris@428:      * reference and other models can be queried from the alignment
Chris@428:      * model.
Chris@428:      */
Chris@428:     void alignmentComplete(AlignmentModel *alignment);
Chris@428: 
Chris@423: private slots:
Chris@428:     void alignmentCompletionChanged();
Chris@423:     void alignmentProgramFinished(int, QProcess::ExitStatus);
Chris@423:     
Chris@420: private:
Chris@428:     static QString getAlignmentTransformName();
Chris@428:     
Chris@420:     QString m_error;
Chris@423:     std::map<QProcess *, AlignmentModel *> m_processModels;
Chris@420: };
Chris@420: 
Chris@420: #endif
Chris@420: