2 Copyright (C) 2009 Paul Davis
3 Author: David Robillard
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #ifndef __ardour_chan_mapping_h__
21 #define __ardour_chan_mapping_h__
28 #include "ardour/data_type.h"
29 #include "ardour/chan_count.h"
34 /** A mapping from one set of channels to another
35 * (e.g. how to 'connect' two BufferSets).
37 * for plugins the form is "pin" -> "buffer"
39 class LIBARDOUR_API ChanMapping {
42 ChanMapping(ARDOUR::ChanCount identity);
43 ChanMapping(const ChanMapping&);
45 uint32_t get(DataType t, uint32_t from, bool* valid);
47 /** get buffer mapping for given data type and pin
48 * @param type data type
50 * @returns mapped buffer number (or ChanMapping::Invalid)
52 uint32_t get(DataType t, uint32_t from) { return get (t, from, NULL); }
53 /** set buffer mapping for given data type
54 * @param type data type
58 void set(DataType t, uint32_t from, uint32_t to);
59 void offset_from(DataType t, int32_t delta);
60 void offset_to(DataType t, int32_t delta);
62 typedef std::map<uint32_t, uint32_t> TypeMapping;
63 typedef std::map<DataType, TypeMapping> Mappings;
65 Mappings mappings() { return _mappings; }
66 const Mappings mappings() const { return _mappings; }
68 bool operator==(const ChanMapping& other) const {
69 return (_mappings == other._mappings);
72 bool operator!=(const ChanMapping& other) const {
73 return ! (*this == other);
82 std::ostream& operator<<(std::ostream& o, const ARDOUR::ChanMapping& m);
84 #endif // __ardour_chan_mapping_h__