PatternStore.h

Go to the documentation of this file.

/*
 * PatternStore.h - model-component of Pattern Editor
 *
 * Copyright (c) 2004-2014 Tobias Doerffel <tobydox/at/users.sourceforge.net>
 *
 * This file is part of LMMS - https://lmms.io
 *
 * 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.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public
 * License along with this program (see COPYING); if not, write to the
 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301 USA.
 *
 */
 
#ifndef LMMS_PATTERN_STORE_H
#define LMMS_PATTERN_STORE_H
 
#include "TrackContainer.h"
#include "ComboBoxModel.h"
 
namespace lmms
{
 
namespace gui
{
    class PatternEditorWindow;
}
 
/*
 * PatternStore is the backend of Pattern Editor:
 *
 * +----------------------------------+
 * | PatternStore (TrackContainer)    |
 * |                                  |
 * | +------------------------------+ |
 * | | Track 1   [Clip A]  [Clip B] | |
 * | +------------------------------+ |
 * |                                  |
 * | +------------------------------+ |
 * | | Track 2   [Clip C]  [Clip D] | |
 * | +------------------------------+ |
 * +----------------------------------+
 *
 * There is only one PatternStore which holds all patterns, and it's very similar to the Song Editor.
 * Think of it as a table - tracks are rows, bars are columns and clips are cells.
 * With this logic a "pattern" is a column, i.e. all clips on the same bar.
 * In the Pattern Editor you can select which pattern (column) you want to see, using the combo box at the top.
 * In the illustration above, Clip A and Clip C start on bar 1, thus they are "Pattern 1".
 *
 * Do not confuse tracks and clips in the PatternStore with PatternTracks and PatternClips.
 * - PatternTracks are used in the Song Editor. Each one reference a "pattern" in the PatternStore.
 * - PatternClips are stored inside PatternTracks. They are just empty placeholders.
 */
class LMMS_EXPORT PatternStore : public TrackContainer
{
    Q_OBJECT
    mapPropertyFromModel(int, currentPattern, setCurrentPattern, m_patternComboBoxModel);
public:
    PatternStore();
    ~PatternStore() override = default;
 
    virtual bool play(TimePos start, const f_cnt_t frames, const f_cnt_t frameBase, int clipNum = -1);
 
    void updateAfterTrackAdd() override;
 
    inline QString nodeName() const override
    {
        return "patternstore";
    }
 
    bar_t lengthOfPattern(int pattern) const;
    inline bar_t lengthOfCurrentPattern()
    {
        return lengthOfPattern(currentPattern());
    }
    int numOfPatterns() const;
    void removePattern(int pattern);
 
    void swapPattern(int p1, int p2);
 
    void updatePatternTrack(Clip* clip);
    void fixIncorrectPositions();
    void createClipsForPattern(int pattern);
 
    AutomatedValueMap automatedValuesAt(TimePos time, int clipNum) const override;
 
public slots:
    void play();
    void stop();
    void updateComboBox();
 
signals:
    void trackUpdated();
 
private:
    ComboBoxModel m_patternComboBoxModel;
 
 
    // Where the pattern selection combo box is
    friend class gui::PatternEditorWindow;
 
} ;
 
 
} // namespace lmms
 
#endif // LMMS_PATTERN_STORE_H