X-Git-Url: https://git.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fasset.h;h=b6ab8fd26101fd48a41b628c59dceab8931266a8;hb=b651392d70d7e37ce5a8a20da81d86e5d19aadd8;hp=cc6fbcb7c374f7ec06ed98afd004fc2b3e875d1b;hpb=4aed3e564381267a36d8707b80f35cafba39fa98;p=libdcp.git diff --git a/src/asset.h b/src/asset.h index cc6fbcb7..b6ab8fd2 100644 --- a/src/asset.h +++ b/src/asset.h @@ -1,94 +1,112 @@ /* - 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 "pkl.h" +#include +#include +#include +#include -namespace ASDCP { - class WriterInfo; +namespace xmlpp { + class Node; } -namespace libdcp -{ +struct asset_test; -/** @brief Parent class for assets of DCPs +namespace dcp { + +/** @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, or empty to make one up based on UUID. + 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 = ""); - - virtual ~Asset() {} + virtual void write_to_assetmap (xmlpp::Node* node, boost::filesystem::path root) const; - /** Write details of the asset to a CPL stream. - * @param s Stream. - */ - virtual void write_to_cpl (std::ostream& s) const = 0; + virtual void add_to_pkl (boost::shared_ptr pkl, boost::filesystem::path root) 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, if there is one */ + boost::optional 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 */ + mutable boost::optional _file; + + static void write_file_to_assetmap (xmlpp::Node* node, boost::filesystem::path root, boost::filesystem::path file, std::string id); + +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; }; }