2 Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 /** @file src/picture_asset.cc
21 * @brief An asset made up of JPEG2000 files
29 #include <boost/filesystem.hpp>
30 #include <boost/lexical_cast.hpp>
32 #include <libxml++/nodes/element.h>
34 #include "KM_fileio.h"
35 #include "picture_asset.h"
37 #include "exceptions.h"
38 #include "picture_frame.h"
39 #include "xyz_frame.h"
40 #include "picture_asset_writer.h"
47 using std::stringstream;
52 using boost::shared_ptr;
53 using boost::dynamic_pointer_cast;
54 using boost::lexical_cast;
55 using namespace libdcp;
57 PictureAsset::PictureAsset (string directory, string mxf_name, boost::signals2::signal<void (float)>* progress, int fps, int intrinsic_duration, bool encrypted, Size size)
58 : MXFAsset (directory, mxf_name, progress, fps, intrinsic_duration, encrypted)
64 PictureAsset::PictureAsset (string directory, string mxf_name)
65 : MXFAsset (directory, mxf_name)
71 MonoPictureAsset::cpl_node_name () const
77 MonoPictureAsset::edit_rate_factor () const
83 StereoPictureAsset::cpl_node_name () const
85 return "MainStereoscopicPicture";
89 StereoPictureAsset::cpl_node_namespace (bool interop) const
92 return "http://www.digicine.com/schemas/437-Y/2007/Main-Stereo-Picture-CPL";
94 return "http://www.smpte-ra.org/schemas/429-10/2008/Main-Stereo-Picture-CPL";
101 StereoPictureAsset::edit_rate_factor () const
107 PictureAsset::write_to_cpl (xmlpp::Node* node, bool interop) const
109 MXFAsset::write_to_cpl (node, interop);
111 xmlpp::Node::NodeList c = node->get_children ();
112 xmlpp::Node::NodeList::iterator i = c.begin();
113 while (i != c.end() && (*i)->get_name() != cpl_node_name ()) {
117 assert (i != c.end ());
119 (*i)->add_child ("FrameRate")->add_child_text (lexical_cast<string> (_edit_rate * edit_rate_factor ()) + " 1");
121 (*i)->add_child ("ScreenAspectRatio")->add_child_text (lexical_cast<string> (float (_size.width) / _size.height));
123 (*i)->add_child ("ScreenAspectRatio")->add_child_text (lexical_cast<string> (_size.width) + " " + lexical_cast<string> (_size.height));
128 PictureAsset::equals (shared_ptr<const Asset> other, EqualityOptions opt, boost::function<void (NoteType, string)> note) const
130 if (!MXFAsset::equals (other, opt, note)) {
134 ASDCP::JP2K::MXFReader reader_A;
135 if (ASDCP_FAILURE (reader_A.OpenRead (path().string().c_str()))) {
136 boost::throw_exception (MXFFileError ("could not open MXF file for reading", path().string()));
139 ASDCP::JP2K::MXFReader reader_B;
140 if (ASDCP_FAILURE (reader_B.OpenRead (other->path().string().c_str()))) {
141 boost::throw_exception (MXFFileError ("could not open MXF file for reading", path().string()));
144 ASDCP::JP2K::PictureDescriptor desc_A;
145 if (ASDCP_FAILURE (reader_A.FillPictureDescriptor (desc_A))) {
146 boost::throw_exception (DCPReadError ("could not read video MXF information"));
148 ASDCP::JP2K::PictureDescriptor desc_B;
149 if (ASDCP_FAILURE (reader_B.FillPictureDescriptor (desc_B))) {
150 boost::throw_exception (DCPReadError ("could not read video MXF information"));
154 desc_A.EditRate != desc_B.EditRate ||
155 desc_A.SampleRate != desc_B.SampleRate ||
156 desc_A.StoredWidth != desc_B.StoredWidth ||
157 desc_A.StoredHeight != desc_B.StoredHeight ||
158 desc_A.AspectRatio != desc_B.AspectRatio ||
159 desc_A.Rsize != desc_B.Rsize ||
160 desc_A.Xsize != desc_B.Xsize ||
161 desc_A.Ysize != desc_B.Ysize ||
162 desc_A.XOsize != desc_B.XOsize ||
163 desc_A.YOsize != desc_B.YOsize ||
164 desc_A.XTsize != desc_B.XTsize ||
165 desc_A.YTsize != desc_B.YTsize ||
166 desc_A.XTOsize != desc_B.XTOsize ||
167 desc_A.YTOsize != desc_B.YTOsize ||
168 desc_A.Csize != desc_B.Csize
169 // desc_A.CodingStyleDefault != desc_B.CodingStyleDefault ||
170 // desc_A.QuantizationDefault != desc_B.QuantizationDefault
173 note (ERROR, "video MXF picture descriptors differ");
177 if (desc_A.ContainerDuration != desc_B.ContainerDuration) {
178 note (ERROR, "video container durations differ");
181 // for (unsigned int j = 0; j < ASDCP::JP2K::MaxComponents; ++j) {
182 // if (desc_A.ImageComponents[j] != desc_B.ImageComponents[j]) {
183 // notes.pack_start ("video MXF picture descriptors differ");
191 MonoPictureAsset::MonoPictureAsset (
192 boost::function<string (int)> get_path,
195 boost::signals2::signal<void (float)>* progress,
197 int intrinsic_duration,
201 MXFMetadata const & metadata
203 : PictureAsset (directory, mxf_name, progress, fps, intrinsic_duration, encrypted, size)
205 construct (get_path, interop, metadata);
208 MonoPictureAsset::MonoPictureAsset (
209 vector<string> const & files,
212 boost::signals2::signal<void (float)>* progress,
214 int intrinsic_duration,
218 MXFMetadata const & metadata
220 : PictureAsset (directory, mxf_name, progress, fps, intrinsic_duration, encrypted, size)
222 construct (boost::bind (&MonoPictureAsset::path_from_list, this, _1, files), interop, metadata);
225 MonoPictureAsset::MonoPictureAsset (string directory, string mxf_name, int fps, Size size)
226 : PictureAsset (directory, mxf_name, 0, fps, 0, false, size)
231 MonoPictureAsset::MonoPictureAsset (string directory, string mxf_name)
232 : PictureAsset (directory, mxf_name)
234 ASDCP::JP2K::MXFReader reader;
235 if (ASDCP_FAILURE (reader.OpenRead (path().string().c_str()))) {
236 boost::throw_exception (MXFFileError ("could not open MXF file for reading", path().string()));
239 ASDCP::JP2K::PictureDescriptor desc;
240 if (ASDCP_FAILURE (reader.FillPictureDescriptor (desc))) {
241 boost::throw_exception (DCPReadError ("could not read video MXF information"));
244 _size.width = desc.StoredWidth;
245 _size.height = desc.StoredHeight;
246 _edit_rate = desc.EditRate.Numerator;
247 assert (desc.EditRate.Denominator == 1);
248 _intrinsic_duration = desc.ContainerDuration;
252 MonoPictureAsset::construct (boost::function<string (int)> get_path, bool interop, MXFMetadata const & metadata)
254 ASDCP::JP2K::CodestreamParser j2k_parser;
255 ASDCP::JP2K::FrameBuffer frame_buffer (4 * Kumu::Megabyte);
256 if (ASDCP_FAILURE (j2k_parser.OpenReadFrame (get_path(0).c_str(), frame_buffer))) {
257 boost::throw_exception (FileError ("could not open JPEG2000 file for reading", get_path (0)));
260 ASDCP::JP2K::PictureDescriptor picture_desc;
261 j2k_parser.FillPictureDescriptor (picture_desc);
262 picture_desc.EditRate = ASDCP::Rational (_edit_rate, 1);
264 ASDCP::WriterInfo writer_info;
265 fill_writer_info (&writer_info, _uuid, interop, metadata);
267 ASDCP::JP2K::MXFWriter mxf_writer;
268 if (ASDCP_FAILURE (mxf_writer.OpenWrite (path().string().c_str(), writer_info, picture_desc, 16384, false))) {
269 boost::throw_exception (MXFFileError ("could not open MXF file for writing", path().string()));
272 for (int i = 0; i < _intrinsic_duration; ++i) {
274 string const path = get_path (i);
276 if (ASDCP_FAILURE (j2k_parser.OpenReadFrame (path.c_str(), frame_buffer))) {
277 boost::throw_exception (FileError ("could not open JPEG2000 file for reading", path));
280 if (ASDCP_FAILURE (mxf_writer.WriteFrame (frame_buffer, _encryption_context, 0))) {
281 boost::throw_exception (MXFFileError ("error in writing video MXF", this->path().string()));
285 (*_progress) (0.5 * float (i) / _intrinsic_duration);
289 if (ASDCP_FAILURE (mxf_writer.Finalize())) {
290 boost::throw_exception (MXFFileError ("error in finalising video MXF", path().string()));
295 MonoPictureAsset::path_from_list (int f, vector<string> const & files) const
300 shared_ptr<const MonoPictureFrame>
301 MonoPictureAsset::get_frame (int n) const
303 return shared_ptr<const MonoPictureFrame> (new MonoPictureFrame (path().string(), n, _decryption_context));
308 MonoPictureAsset::equals (shared_ptr<const Asset> other, EqualityOptions opt, boost::function<void (NoteType, string)> note) const
310 if (!PictureAsset::equals (other, opt, note)) {
314 shared_ptr<const MonoPictureAsset> other_picture = dynamic_pointer_cast<const MonoPictureAsset> (other);
315 assert (other_picture);
317 for (int i = 0; i < _intrinsic_duration; ++i) {
318 if (i >= other_picture->intrinsic_duration()) {
322 note (PROGRESS, "Comparing video frame " + lexical_cast<string> (i) + " of " + lexical_cast<string> (_intrinsic_duration));
323 shared_ptr<const MonoPictureFrame> frame_A = get_frame (i);
324 shared_ptr<const MonoPictureFrame> frame_B = other_picture->get_frame (i);
326 if (!frame_buffer_equals (
328 frame_A->j2k_data(), frame_A->j2k_size(),
329 frame_B->j2k_data(), frame_B->j2k_size()
339 StereoPictureAsset::equals (shared_ptr<const Asset> other, EqualityOptions opt, boost::function<void (NoteType, string)> note) const
341 if (!PictureAsset::equals (other, opt, note)) {
345 shared_ptr<const StereoPictureAsset> other_picture = dynamic_pointer_cast<const StereoPictureAsset> (other);
346 assert (other_picture);
348 for (int i = 0; i < _intrinsic_duration; ++i) {
349 shared_ptr<const StereoPictureFrame> frame_A = get_frame (i);
350 shared_ptr<const StereoPictureFrame> frame_B = other_picture->get_frame (i);
352 if (!frame_buffer_equals (
354 frame_A->left_j2k_data(), frame_A->left_j2k_size(),
355 frame_B->left_j2k_data(), frame_B->left_j2k_size()
360 if (!frame_buffer_equals (
362 frame_A->right_j2k_data(), frame_A->right_j2k_size(),
363 frame_B->right_j2k_data(), frame_B->right_j2k_size()
373 PictureAsset::frame_buffer_equals (
374 int frame, EqualityOptions opt, boost::function<void (NoteType, string)> note,
375 uint8_t const * data_A, unsigned int size_A, uint8_t const * data_B, unsigned int size_B
378 if (size_A == size_B && memcmp (data_A, data_B, size_A) == 0) {
379 note (NOTE, "J2K identical");
380 /* Easy result; the J2K data is identical */
384 /* Decompress the images to bitmaps */
385 shared_ptr<XYZFrame> image_A = decompress_j2k (const_cast<uint8_t*> (data_A), size_A, 0);
386 shared_ptr<XYZFrame> image_B = decompress_j2k (const_cast<uint8_t*> (data_B), size_B, 0);
390 vector<int> abs_diffs (image_A->size().width * image_A->size().height * 3);
394 for (int c = 0; c < 3; ++c) {
396 if (image_A->size() != image_B->size()) {
397 note (ERROR, "image sizes for frame " + lexical_cast<string>(frame) + " differ");
401 int const pixels = image_A->size().width * image_A->size().height;
402 for (int j = 0; j < pixels; ++j) {
403 int const t = abs (image_A->data(c)[j] - image_B->data(c)[j]);
405 max_diff = max (max_diff, t);
410 for (vector<int>::iterator j = abs_diffs.begin(); j != abs_diffs.end(); ++j) {
414 double const mean = double (total) / abs_diffs.size ();
416 uint64_t total_squared_deviation = 0;
417 for (vector<int>::iterator j = abs_diffs.begin(); j != abs_diffs.end(); ++j) {
418 total_squared_deviation += pow (*j - mean, 2);
421 double const std_dev = sqrt (double (total_squared_deviation) / abs_diffs.size());
423 note (NOTE, "mean difference " + lexical_cast<string> (mean) + ", deviation " + lexical_cast<string> (std_dev));
425 if (mean > opt.max_mean_pixel_error) {
426 note (ERROR, "mean " + lexical_cast<string>(mean) + " out of range " + lexical_cast<string>(opt.max_mean_pixel_error) + " in frame " + lexical_cast<string>(frame));
430 if (std_dev > opt.max_std_dev_pixel_error) {
431 note (ERROR, "standard deviation " + lexical_cast<string>(std_dev) + " out of range " + lexical_cast<string>(opt.max_std_dev_pixel_error) + " in frame " + lexical_cast<string>(frame));
439 StereoPictureAsset::StereoPictureAsset (string directory, string mxf_name, int fps, int intrinsic_duration)
440 : PictureAsset (directory, mxf_name, 0, fps, intrinsic_duration, false, Size (0, 0))
442 ASDCP::JP2K::MXFSReader reader;
443 if (ASDCP_FAILURE (reader.OpenRead (path().string().c_str()))) {
444 boost::throw_exception (MXFFileError ("could not open MXF file for reading", path().string()));
447 ASDCP::JP2K::PictureDescriptor desc;
448 if (ASDCP_FAILURE (reader.FillPictureDescriptor (desc))) {
449 boost::throw_exception (DCPReadError ("could not read video MXF information"));
452 _size.width = desc.StoredWidth;
453 _size.height = desc.StoredHeight;
456 shared_ptr<const StereoPictureFrame>
457 StereoPictureAsset::get_frame (int n) const
459 return shared_ptr<const StereoPictureFrame> (new StereoPictureFrame (path().string(), n));
462 shared_ptr<PictureAssetWriter>
463 MonoPictureAsset::start_write (bool overwrite, bool interop, MXFMetadata const & metadata)
465 /* XXX: can't we use shared_ptr here? */
466 return shared_ptr<MonoPictureAssetWriter> (new MonoPictureAssetWriter (this, overwrite, interop, metadata));
470 PictureAsset::key_type () const
475 StereoPictureAsset::StereoPictureAsset (string directory, string mxf_name, int fps, Size size)
476 : PictureAsset (directory, mxf_name, 0, fps, 0, false, size)
481 shared_ptr<PictureAssetWriter>
482 StereoPictureAsset::start_write (bool overwrite, bool interop, MXFMetadata const & metadata)
484 /* XXX: can't we use shared_ptr here? */
485 return shared_ptr<StereoPictureAssetWriter> (new StereoPictureAssetWriter (this, overwrite, interop, metadata));