X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Fasset.h;h=100303a1b76e3f9e2ad9ba0fa3036e5897144ed3;hb=8d56ea4bbff391dd72981f86001245a595fa9c62;hp=3dffa9abc3becc84b126d7ddeaf1dcfe64873711;hpb=938f413bb4ebecd51c805027e331cb7eb0ca9502;p=libdcp.git diff --git a/src/asset.h b/src/asset.h index 3dffa9ab..100303a1 100644 --- a/src/asset.h +++ b/src/asset.h @@ -1,143 +1,111 @@ /* - 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 "object.h" +#include "types.h" +#include "pkl.h" #include #include -#include -#include "types.h" - -namespace ASDCP { - class WriterInfo; -} +#include namespace xmlpp { - class Element; + 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 (std::string directory, std::string file_name = "", int edit_rate = 0, int intrinsic_duration = 0); - - virtual ~Asset() {} - - /** Write details of the asset to a CPL AssetList node. - * @param p Parent node. + Asset (); + explicit Asset (boost::filesystem::path file); + Asset (std::string id, boost::filesystem::path file); + + virtual bool equals ( + std::shared_ptr other, + EqualityOptions opt, + NoteHandler note + ) const; + + /** Write details of the asset to a ASSETMAP. + * @param node Parent node. */ - virtual void write_to_cpl (xmlpp::Node *) const = 0; + virtual void write_to_assetmap (xmlpp::Node* node, boost::filesystem::path root) const; - /** Write details of the asset to a PKL AssetList node. - * @param p Parent node. - */ - void write_to_pkl (xmlpp::Node *) const; + virtual void add_to_pkl (std::shared_ptr pkl, boost::filesystem::path root) const; - /** Write details of the asset to a ASSETMAP stream. - * @param s Stream. - */ - void write_to_assetmap (xmlpp::Node *) const; - - std::string uuid () const { - return _uuid; + /** @return the most recent disk file used to read or write this asset, if there is one */ + boost::optional file () const { + return _file; } - boost::filesystem::path path () const; + void set_file (boost::filesystem::path file) const; - void set_directory (std::string d) { - _directory = d; - } + /** @return the hash of this asset's file */ + std::string hash (boost::function progress = 0) const; - void set_file_name (std::string f) { - _file_name = f; - } + void set_hash (std::string hash); - int entry_point () const { - return _entry_point; - } +protected: - int duration () const { - return _duration; - } - - int intrinsic_duration () const { - return _intrinsic_duration; - } - - int edit_rate () const { - return _edit_rate; - } + /** The most recent disk file used to read or write this asset */ + mutable boost::optional _file; - void set_entry_point (int e) { - _entry_point = e; - } - - void set_duration (int d) { - _duration = d; - } + static void write_file_to_assetmap (xmlpp::Node* node, boost::filesystem::path root, boost::filesystem::path file, std::string id); - void set_intrinsic_duration (int d) { - _intrinsic_duration = d; - } +private: + friend struct ::asset_test; - virtual bool equals (boost::shared_ptr other, EqualityOptions opt, boost::function) const; + /** @return type string for PKLs for this asset */ + virtual std::string pkl_type (Standard standard) const = 0; -protected: - - std::string digest () 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; - /** The edit rate; this is normally equal to the number of video frames per second */ - int _edit_rate; - /** Start point to present in frames */ - int _entry_point; - /** Total length in frames */ - int _intrinsic_duration; - /** Length to present in frames */ - int _duration; - -private: - /** Digest of our MXF or XML file */ - mutable std::string _digest; + /** Hash of _file if it has been computed */ + mutable boost::optional _hash; }; }