Add a comment.
[dcpomatic.git] / src / lib / audio_mapping.h
index 9a507b550e958a8d0928adf2f1a9733eb79db708..51ab0e1e52e560723d706a62357a08f83d840db1 100644 (file)
@@ -1,70 +1,89 @@
 /*
-    Copyright (C) 2013 Carl Hetherington <cth@carlh.net>
+    Copyright (C) 2013-2021 Carl Hetherington <cth@carlh.net>
 
-    This program is free software; you can redistribute it and/or modify
+    This file is part of DCP-o-matic.
+
+    DCP-o-matic 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,
+    DCP-o-matic 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., 675 Mass Ave, Cambridge, MA 02139, USA.
+    along with DCP-o-matic.  If not, see <http://www.gnu.org/licenses/>.
 
 */
 
+
+/** @file  src/lib/audio_mapping.h
+ *  @brief AudioMapping class.
+ */
+
+
 #ifndef DCPOMATIC_AUDIO_MAPPING_H
 #define DCPOMATIC_AUDIO_MAPPING_H
 
-#include <list>
-#include <libdcp/types.h>
-#include <boost/shared_ptr.hpp>
+
+#include <dcp/types.h>
+#include <libcxml/cxml.h>
+#include <vector>
+
 
 namespace xmlpp {
        class Node;
 }
 
-namespace cxml {
-       class Node;
-}
+class AudioProcessor;
+
 
-/** A many-to-many mapping from some content channels to DCP channels.
- *  The number of content channels is set on construction and fixed,
- *  and then each of those content channels can be mapped to zero or
- *  more DCP channels.
+/** @class AudioMapping.
+ *  @brief A many-to-many mapping of audio channels.
  */
 class AudioMapping
 {
 public:
-       AudioMapping ();
-       AudioMapping (int);
-       AudioMapping (boost::shared_ptr<const cxml::Node>);
+       AudioMapping () {}
+       AudioMapping (int input_channels, int output_channels);
+       AudioMapping (cxml::ConstNodePtr, int);
 
        /* Default copy constructor is fine */
-       
+
        void as_xml (xmlpp::Node *) const;
 
-       void add (int, libdcp::Channel);
-       void make_default ();
+       void make_zero ();
+       void make_default (AudioProcessor const * processor, boost::optional<boost::filesystem::path> filename = boost::optional<boost::filesystem::path>());
+
+       void set (dcp::Channel input_channel, int output_channel, float);
+       void set (int input_channel, int output_channel, float);
+       void set (int input_channel, dcp::Channel output_channel, float);
+       float get (int input_channel, int output_channel) const;
+       float get (int input_channel, dcp::Channel output_channel) const;
 
-       std::list<int> dcp_to_content (libdcp::Channel) const;
-       std::list<std::pair<int, libdcp::Channel> > content_to_dcp () const {
-               return _content_to_dcp;
+       int input_channels () const {
+               return _input_channels;
        }
 
-       int content_channels () const {
-               return _content_channels;
+       int output_channels () const {
+               return _output_channels;
        }
-       
-       std::list<libdcp::Channel> content_to_dcp (int) const;
+
+       std::string digest () const;
+
+       std::list<int> mapped_output_channels () const;
+       void unmap_all ();
 
 private:
-       int _content_channels;
-       std::list<std::pair<int, libdcp::Channel> > _content_to_dcp;
+       void setup (int input_channels, int output_channels);
+
+       int _input_channels = 0;
+       int _output_channels = 0;
+       /** Linear gains */
+       std::vector<std::vector<float>> _gain;
 };
 
+
 #endif