X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fsound_asset.h;h=799e671ce77726616a38d7017d8f4c3106036a2d;hb=b68a460c3ef877d95c0939b5ee02928f35e9f263;hp=914823a2a5db368f2fbe78e931ef85cf77abece0;hpb=d8c9cbec9d87f28da338350880b7618b94f4da81;p=libdcp.git diff --git a/src/sound_asset.h b/src/sound_asset.h index 914823a2..799e671c 100644 --- a/src/sound_asset.h +++ b/src/sound_asset.h @@ -1,92 +1,136 @@ /* - Copyright (C) 2012 Carl Hetherington + Copyright (C) 2012-2021 Carl Hetherington - This program is free software; you can redistribute it and/or modify + This file is part of libdcp. + + libdcp 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, + libdcp 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 libdcp. If not, see . + + In addition, as a special exception, the copyright holders give + permission to link the code of portions of this program with the + OpenSSL library under certain conditions as described in each + individual source file, and distribute linked combinations + including the two. + You must obey the GNU General Public License in all respects + for all of the code used other than OpenSSL. If you modify + file(s) with this exception, you may extend this exception to your + version of the file(s), but you are not obligated to do so. If you + do not wish to do so, delete this exception statement from your + version. If you delete this exception statement from all source + files in the program, then also delete it here. */ -#ifndef LIBDCP_SOUND_ASSET_H -#define LIBDCP_SOUND_ASSET_H /** @file src/sound_asset.h - * @brief An asset made up of WAV files + * @brief SoundAsset class */ -#include "asset.h" + +#ifndef LIBDCP_SOUND_ASSET_H +#define LIBDCP_SOUND_ASSET_H + + +#include "mxf.h" #include "types.h" +#include "language_tag.h" +#include "metadata.h" +#include "sound_frame.h" +#include "sound_asset_reader.h" -namespace libdcp + +namespace dcp { + class SoundAsset; +} + + +extern std::shared_ptr simple_sound ( + boost::filesystem::path path, std::string suffix, dcp::MXFMetadata mxf_meta, std::string language, int frames, int sample_rate + ); + + +namespace dcp { -/** @brief An asset made up of WAV files */ -class SoundAsset : public Asset + +class SoundAssetWriter; + + +/** @class SoundAsset + * @brief Representation of a sound asset + */ +class SoundAsset : public Asset, public MXF { public: - /** Construct a SoundAsset, generating the MXF from the WAV files. - * This may take some time; progress is indicated by emission of the Progress signal. - * @param files Pathnames of sound files, in the order Left, Right, Centre, Lfe (sub), Left surround, Right surround. - * @param mxf_path Pathname of MXF file to create. - * @param progress Signal to inform of progress. - * @param fps Frames per second. - * @param length Length in frames. - */ - SoundAsset ( - std::vector const & files, - std::string mxf_path, - sigc::signal1* progress, - int fps, - int length - ); + explicit SoundAsset (boost::filesystem::path file); + SoundAsset (Fraction edit_rate, int sampling_rate, int channels, LanguageTag language, Standard standard); - /** Construct a SoundAsset, generating the MXF from the WAV files. - * This may take some time; progress is indicated by emission of the Progress signal. - * @param get_path Functor which returns a WAV file path for a given channel. - * @param mxf_path Pathname of MXF file to create. - * @param progress Signal to inform of progress. - * @param fps Frames per second. - * @param length Length in frames. - * @param channels Number of audio channels. - */ - SoundAsset ( - sigc::slot get_path, - std::string mxf_path, - sigc::signal1* progress, - int fps, - int length, - int channels - ); + std::shared_ptr start_write (boost::filesystem::path file, bool atmos_sync = false); + std::shared_ptr start_read () const; - SoundAsset ( - std::string mxf_path, - int fps, - int length - ); - - /** Write details of this asset to a CPL stream. - * @param s Stream. - */ - void write_to_cpl (std::ostream& s) const; + bool equals ( + std::shared_ptr other, + EqualityOptions opt, + NoteHandler note + ) const override; + + /** @return number of channels */ + int channels () const { + return _channels; + } + + /** @return sampling rate in Hz */ + int sampling_rate () const { + return _sampling_rate; + } + + Fraction edit_rate () const { + return _edit_rate; + } + + int64_t intrinsic_duration () const { + return _intrinsic_duration; + } + + boost::optional language () const { + return _language; + } + + static bool valid_mxf (boost::filesystem::path); + static std::string static_pkl_type (Standard standard); private: - void construct (sigc::slot get_path); - std::string path_from_channel (Channel channel, std::vector const & files); + friend class SoundAssetWriter; + friend std::shared_ptr (::simple_sound) ( + boost::filesystem::path path, std::string suffix, dcp::MXFMetadata mxf_meta, std::string language, int frames, int sample_rate + ); - /** Number of channels in the asset */ - int _channels; + std::string pkl_type (Standard standard) const override { + return static_pkl_type (standard); + } + + Fraction _edit_rate; + /** The total length of this content in video frames. The amount of + * content presented may be less than this. + */ + int64_t _intrinsic_duration = 0; + int _channels = 0; ///< number of channels + int _sampling_rate = 0; ///< sampling rate in Hz + boost::optional _language; }; + } + #endif