2 Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #ifndef LIBDCP_SOUND_ASSET_H
21 #define LIBDCP_SOUND_ASSET_H
23 /** @file src/sound_asset.h
24 * @brief An asset made up of PCM audio data files
28 #include "mxf_asset.h"
38 class SoundAssetWriter
43 void write (float const * const *, int);
47 friend class SoundAsset;
49 SoundAssetWriter (SoundAsset *);
50 void write_current_frame ();
55 int _frame_buffer_offset;
56 ASDCP::PCM::MXFWriter _mxf_writer;
57 ASDCP::PCM::FrameBuffer _frame_buffer;
58 ASDCP::WriterInfo _writer_info;
59 ASDCP::PCM::AudioDescriptor _audio_desc;
62 /** @brief An asset made up of WAV files */
63 class SoundAsset : public MXFAsset
66 /** Construct a SoundAsset, generating the MXF from some WAV files.
67 * This may take some time; progress is indicated by emission of the Progress signal.
68 * @param files Pathnames of sound files, in the order Left, Right, Centre, Lfe (sub), Left surround, Right surround.
69 * @param directory Directory in which to create MXF file.
70 * @param mxf_name Name of MXF file to create.
71 * @param progress Signal to inform of progress.
72 * @param fps Frames per second.
73 * @param intrinsic_duration Length of the whole asset in frames.
74 * @param start_frame Frame in the source to start writing from.
75 * Note that this is different to entry_point in that the asset will contain no data before start_frame.
78 std::vector<std::string> const & files,
79 std::string directory,
81 boost::signals2::signal<void (float)>* progress,
83 int intrinsic_duration,
87 /** Construct a SoundAsset, generating the MXF from some WAV files.
88 * This may take some time; progress is indicated by emission of the Progress signal.
89 * @param get_path Functor which returns a WAV file path for a given channel.
90 * @param directory Directory in which to create MXF file.
91 * @param mxf_name Name of MXF file to create.
92 * @param progress Signal to inform of progress.
93 * @param fps Frames per second.
94 * @param intrinsic_duration Length of the whole asset in frames.
95 * @param start_frame Frame in the source to start writing from.
96 * Note that this is different to entry_point in that the asset will contain no data before start_frame.
97 * @param channels Number of audio channels.
100 boost::function<std::string (Channel)> get_path,
101 std::string directory,
102 std::string mxf_name,
103 boost::signals2::signal<void (float)>* progress,
105 int intrinsic_duration,
111 std::string directory,
116 std::string directory,
117 std::string mxf_name,
123 boost::shared_ptr<SoundAssetWriter> start_write ();
125 /** Write details of this asset to a CPL stream.
128 void write_to_cpl (std::ostream& s) const;
130 bool equals (boost::shared_ptr<const Asset> other, EqualityOptions opt, std::list<std::string>& notes) const;
132 boost::shared_ptr<const SoundFrame> get_frame (int n) const;
134 int channels () const {
138 int sampling_rate () const {
139 return _sampling_rate;
143 void construct (boost::function<std::string (Channel)> get_path);
144 std::string path_from_channel (Channel channel, std::vector<std::string> const & files);
146 /** Number of channels in the asset */