root/branches/transport_redesign/libs/hydrogen/include/hydrogen/Pattern.h @ 872

/*
 * Hydrogen
 * Copyright(c) 2002-2008 by Alex >Comix< Cominu [comix@users.sourceforge.net]
 *
 * http://www.hydrogen-music.org
 *
 * 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; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 */

#ifndef H2CORE_PATTERN_H
#define H2CORE_PATTERN_H

#include <hydrogen/globals.h>
#include <hydrogen/Object.h>

namespace H2Core
{

class Note;
class Instrument;

///
/// The Pattern is a Note container.
///
class Pattern : public Object
{
public:
        typedef std::multimap <int, Note*> note_map_t;
        note_map_t note_map;

        Pattern( const QString& name, const QString& category, unsigned length = MAX_NOTES );
        ~Pattern();

        /**
          Delete notes that pertain to instrument I.
          The function is thread safe (it locks the audio data while deleting notes)
        */
        void purge_instrument( Instrument * I );
        
        /**
          Check if there are any notes pertaining to I
        */
        bool references_instrument( Instrument * I );
        
        static Pattern* get_empty_pattern();
        Pattern* copy();

        void debug_dump();

        unsigned get_length() {
                return __length;
        }
        void set_length( unsigned length ) {
                __length = length;
        }

        void set_name( const QString& name ) {
                __name = name;
        }
        const QString& get_name() const {
                return __name;
        }

        void set_category( const QString& category ) {
                __category = category;
        }
        const QString& get_category() const {
                return __category;
        }

private:
        unsigned __length;
        QString __name;
        QString __category;
};


/// Pattern List
class PatternList : public Object
{
public:
        PatternList();
        ~PatternList();

        void add( Pattern* new_pattern );
        Pattern* get( int pos );
        unsigned int get_size();
        void clear();

        void replace( Pattern* new_pattern, unsigned pos );
        int index_of( Pattern* pattern );

        /// Remove a pattern from the list (every instance in the list), the pattern is not deleted!!!
        /// Returns NULL if the pattern is not in the list
        Pattern * del( Pattern *pattern ); 

        /// Remove one pattern from the list, the pattern is not deleted!!!
        void del( unsigned index );

private:
        std::vector<Pattern*> list;
};

};

#endif // H2CORE_PATTERN_H