X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fsound_asset.h;h=717aab82b809eb77ef2671dd21dd858a5c1d5911;hb=refs%2Ftags%2Fv1.8.63;hp=d2e49bd1367b9eae62edc9c0d7a8be721eb9bfb9;hpb=39f0ae0efb3406357253d19bf7588f3832735d0b;p=libdcp.git diff --git a/src/sound_asset.h b/src/sound_asset.h index d2e49bd1..717aab82 100644 --- a/src/sound_asset.h +++ b/src/sound_asset.h @@ -1,128 +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 PCM audio data files + * @brief SoundAsset class */ -#include "mxf_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 -{ -class SoundFrame; -class SoundAsset; +namespace dcp { + class SoundAsset; +} -class SoundAssetWriter -{ -public: - void write (float const * const *, int); - void finalize (); -private: - friend class SoundAsset; - - SoundAssetWriter (SoundAsset *); - - /* no copy construction */ - SoundAssetWriter (SoundAssetWriter const &); - SoundAssetWriter& operator= (SoundAssetWriter const &); - - void write_current_frame (); - - /* do this with an opaque pointer so we don't have to include - ASDCP headers - */ - - struct ASDCPState; - boost::shared_ptr _state; - - SoundAsset* _asset; - bool _finalized; - int _frames_written; - int _frame_buffer_offset; -}; +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, boost::optional, int channels + ); -/** @brief An asset made up of WAV files */ -class SoundAsset : public MXFAsset + +namespace dcp { -public: - SoundAsset (boost::filesystem::path directory, boost::filesystem::path mxf_name); - void read (); - /** The following parameters must be set up (if required) before calling this: - * Interop mode (set_interop) - * Edit rate (set_edit_rate) - * MXF Metadata (set_metadata) - * Channels (set_channels) - * Intrinsic duration (set_intrinsic_duration) - */ - void create (std::vector const & files); - - /** The following parameters must be set up (if required) before calling this: - * Interop mode (set_interop) - * Edit rate (set_edit_rate) - * MXF Metadata (set_metadata) - * Channels (set_channels) - * Intrinsic duration (set_intrinsic_duration) - */ - void create (boost::function get_path); +class SoundAssetWriter; + - boost::shared_ptr start_write (); - - bool equals (boost::shared_ptr other, EqualityOptions opt, boost::function note) const; +/** @class SoundAsset + * @brief Representation of a sound asset + */ +class SoundAsset : public Asset, public MXF +{ +public: + explicit SoundAsset (boost::filesystem::path file); + SoundAsset (Fraction edit_rate, int sampling_rate, int channels, LanguageTag language, Standard standard); - boost::shared_ptr get_frame (int n) const; + std::shared_ptr start_write (boost::filesystem::path file, bool atmos_sync = false); + std::shared_ptr start_read () const; - void set_channels (int c) { - _channels = c; - } - + bool equals ( + std::shared_ptr other, + EqualityOptions opt, + NoteHandler note + ) const override; + + /** @return number of channels */ int channels () const { return _channels; } - void set_sampling_rate (int s) { - _sampling_rate = s; - } - + /** @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: - std::string key_type () const; - void construct (boost::function get_path); - boost::filesystem::path path_from_channel (Channel channel, std::vector const & files); - std::string cpl_node_name () const; - - /** Number of channels in the asset */ - int _channels; - int _sampling_rate; + 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, boost::optional, 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