Selection.h

Go to the documentation of this file.

/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */

/*
    Sonic Visualiser
    An audio file viewer and annotation editor.
    Centre for Digital Music, Queen Mary, University of London.
    This file copyright 2006 Chris Cannam.
    
    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 SV_SELECTION_H
#define SV_SELECTION_H

#include <cstddef>
#include <set>

#include "XmlExportable.h"
#include "BaseTypes.h"

class Selection
{
public:
    Selection();
    Selection(sv_frame_t startFrame, sv_frame_t endFrame);
    Selection(const Selection &);
    Selection &operator=(const Selection &);
    virtual ~Selection();

    bool isEmpty() const;
    sv_frame_t getStartFrame() const;
    sv_frame_t getEndFrame() const;
    sv_frame_t getDuration() const { return getEndFrame() - getStartFrame(); }
    bool contains(sv_frame_t frame) const;

    bool operator<(const Selection &) const;
    bool operator==(const Selection &) const;
    
protected:
    sv_frame_t m_startFrame;
    sv_frame_t m_endFrame;
};

class MultiSelection : public XmlExportable
{
public:
    MultiSelection();
    virtual ~MultiSelection();

    typedef std::set<Selection> SelectionList;

    const SelectionList &getSelections() const;
    void setSelection(const Selection &selection);
    void addSelection(const Selection &selection);
    void removeSelection(const Selection &selection);
    void clearSelections();

    void getExtents(sv_frame_t &startFrame, sv_frame_t &endFrame) const;
    
    Selection getContainingSelection(sv_frame_t frame,
                                     bool defaultToFollowing) const;

    void toXml(QTextStream &stream, QString indent = "",
               QString extraAttributes = "") const override;

    // Debug only, not interop
    QString toString() const;
    
protected:
    SelectionList m_selections;
};
    

#endif