2 Copyright (C) 2012-2021 Carl Hetherington <cth@carlh.net>
4 This file is part of libdcp.
6 libdcp is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 libdcp is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with libdcp. If not, see <http://www.gnu.org/licenses/>.
19 In addition, as a special exception, the copyright holders give
20 permission to link the code of portions of this program with the
21 OpenSSL library under certain conditions as described in each
22 individual source file, and distribute linked combinations
25 You must obey the GNU General Public License in all respects
26 for all of the code used other than OpenSSL. If you modify
27 file(s) with this exception, you may extend this exception to your
28 version of the file(s), but you are not obligated to do so. If you
29 do not wish to do so, delete this exception statement from your
30 version. If you delete this exception statement from all source
31 files in the program, then also delete it here.
35 /** @file src/picture_asset.h
36 * @brief PictureAsset class
40 #ifndef LIBDCP_PICTURE_ASSET_H
41 #define LIBDCP_PICTURE_ASSET_H
51 struct PictureDescriptor;
59 class MonoPictureFrame;
60 class StereoPictureFrame;
61 class PictureAssetWriter;
64 /** @class PictureAsset
65 * @brief An asset made up of JPEG2000 data
67 class PictureAsset : public Asset, public MXF
70 /** Load a PictureAsset from a file */
71 explicit PictureAsset (boost::filesystem::path file);
73 /** Create a new PictureAsset with a given edit rate and standard */
74 PictureAsset(Fraction edit_rate, Standard standard);
76 enum class Behaviour {
81 virtual std::shared_ptr<PictureAssetWriter> start_write (
82 boost::filesystem::path file,
90 void set_size (Size s) {
94 Fraction frame_rate () const {
98 void set_frame_rate (Fraction r) {
102 Fraction screen_aspect_ratio () const {
103 return _screen_aspect_ratio;
106 void set_screen_aspect_ratio (Fraction r) {
107 _screen_aspect_ratio = r;
110 Fraction edit_rate () const {
114 int64_t intrinsic_duration () const {
115 return _intrinsic_duration;
118 static std::string static_pkl_type (Standard standard);
121 friend class MonoPictureAssetWriter;
122 friend class StereoPictureAssetWriter;
124 bool frame_buffer_equals (
125 int frame, EqualityOptions const& opt, NoteHandler note,
126 uint8_t const * data_A, unsigned int size_A, uint8_t const * data_B, unsigned int size_B
129 bool descriptor_equals (
130 ASDCP::JP2K::PictureDescriptor const & a,
131 ASDCP::JP2K::PictureDescriptor const & b,
135 void read_picture_descriptor (ASDCP::JP2K::PictureDescriptor const &);
138 /** The total length of this content in video frames. The amount of
139 * content presented may be less than this.
141 int64_t _intrinsic_duration = 0;
142 /** picture size in pixels */
144 Fraction _frame_rate;
145 Fraction _screen_aspect_ratio;
148 std::string pkl_type (Standard standard) const override;