X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fasset.h;h=214cc227e930385b5b9311727e4866392d01ff80;hb=3652809182f2ff89e552a519658cba2afc57ce28;hp=32fd93aee759837637a80451ddc6ecf2db999dc6;hpb=8fca5499789ae1deb2dbcad8d3501a8f42fb95f0;p=libdcp.git diff --git a/src/asset.h b/src/asset.h index 32fd93ae..214cc227 100644 --- a/src/asset.h +++ b/src/asset.h @@ -1,92 +1,113 @@ /* - Copyright (C) 2012 Carl Hetherington + Copyright (C) 2014 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. */ /** @file src/asset.h - * @brief Parent class for assets of DCPs. + * @brief Asset class. */ #ifndef LIBDCP_ASSET_H #define LIBDCP_ASSET_H -#include -#include -#include +#include "object.h" #include "types.h" +#include +#include +#include +#include -namespace ASDCP { - class WriterInfo; +namespace xmlpp { + class Node; } -namespace libdcp -{ +struct asset_test; + +namespace dcp { -/** @brief Parent class for assets of DCPs +/** @class Asset + * @brief Parent class for DCP assets, i.e. picture, sound, subtitles, CPLs, fonts. * - * These are collections of pictures or sound. + * Note that this class is not used for ReelAssets; those are just for the metadata + * that gets put into <Reel>s. */ -class Asset +class Asset : public Object { public: - /** Construct an Asset. - * @param directory Directory where our XML or MXF file is. - * @param file_name Name of our file within directory. + Asset (); + explicit Asset (boost::filesystem::path file); + Asset (std::string id, boost::filesystem::path file); + + virtual bool equals ( + boost::shared_ptr other, + EqualityOptions opt, + NoteHandler note + ) const; + + /** Write details of the asset to a ASSETMAP. + * @param node Parent node. */ - Asset (std::string directory, std::string file_name); + void write_to_assetmap (xmlpp::Node* node, boost::filesystem::path root) const; - /** Write details of the asset to a CPL stream. - * @param s Stream. + /** Write details of the asset to a PKL AssetList node. + * @param node Parent node. + * @param standard Standard to use. */ - virtual void write_to_cpl (std::ostream& s) const = 0; + void write_to_pkl (xmlpp::Node* node, boost::filesystem::path root, Standard standard) const; - /** Write details of the asset to a PKL stream. - * @param s Stream. - */ - void write_to_pkl (std::ostream& s) const; + /** @return the most recent disk file used to read or write this asset; may be empty */ + boost::filesystem::path file () const { + return _file; + } - /** Write details of the asset to a ASSETMAP stream. - * @param s Stream. - */ - void write_to_assetmap (std::ostream& s) const; + void set_file (boost::filesystem::path file) const; - std::string uuid () const { - return _uuid; - } + /** @return the hash of this asset's file */ + std::string hash (boost::function progress = 0) const; - virtual bool equals (boost::shared_ptr other, EqualityOptions opt, std::list& notes) const = 0; + void set_hash (std::string hash); protected: - friend class PictureAsset; - friend class SoundAsset; - - std::string digest () const; - boost::filesystem::path path () const; - - /** Directory that our MXF or XML file is in */ - std::string _directory; - /** Name of our MXF or XML file */ - std::string _file_name; - /** Our UUID */ - std::string _uuid; - -private: - /** Digest of our MXF or XML file */ - mutable std::string _digest; + + /** The most recent disk file used to read or write this asset; may be empty */ + mutable boost::filesystem::path _file; + +private: + friend struct ::asset_test; + + /** @return type string for PKLs for this asset */ + virtual std::string pkl_type (Standard standard) const = 0; + + /** Hash of _file if it has been computed */ + mutable boost::optional _hash; }; }