2 Copyright (C) 2014-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 #include "colour_conversion.h"
36 #include "openjpeg_image.h"
37 #include "piecewise_lut.h"
39 #include "stream_operators.h"
40 #include <boost/bind.hpp>
41 #include <boost/random.hpp>
42 #include <boost/scoped_array.hpp>
43 #include <boost/test/unit_test.hpp>
48 using std::make_shared;
50 using std::shared_ptr;
52 using boost::optional;
53 using boost::scoped_array;
58 rgb_xyz_test_case (std::function<void (uint16_t*)> write_pixel)
61 dcp::Size const size (640, 480);
63 scoped_array<uint8_t> rgb (new uint8_t[size.width * size.height * 6]);
64 for (int y = 0; y < size.height; ++y) {
65 uint16_t* p = reinterpret_cast<uint16_t*> (rgb.get() + y * size.width * 6);
66 for (int x = 0; x < size.width; ++x) {
72 auto xyz = dcp::rgb_to_xyz (rgb.get(), size, size.width * 6, dcp::ColourConversion::srgb_to_xyz());
74 for (int y = 0; y < size.height; ++y) {
75 uint16_t* p = reinterpret_cast<uint16_t*> (rgb.get() + y * size.width * 6);
76 for (int x = 0; x < size.width; ++x) {
78 double cr = *p++ / 65535.0;
79 double cg = *p++ / 65535.0;
80 double cb = *p++ / 65535.0;
87 cr = pow ((cr + 0.055) / 1.055, 2.4);
93 cg = pow ((cg + 0.055) / 1.055, 2.4);
99 cb = pow ((cb + 0.055) / 1.055, 2.4);
104 double cx = cr * 0.4124564 + cg * 0.3575761 + cb * 0.1804375;
105 double cy = cr * 0.2126729 + cg * 0.7151522 + cb * 0.0721750;
106 double cz = cr * 0.0193339 + cg * 0.1191920 + cb * 0.9503041;
116 cx = pow (cx, 1 / 2.6);
117 cy = pow (cy, 1 / 2.6);
118 cz = pow (cz, 1 / 2.6);
120 BOOST_REQUIRE_CLOSE (cx * 4095, xyz->data(0)[y * size.width + x], 1);
121 BOOST_REQUIRE_CLOSE (cy * 4095, xyz->data(1)[y * size.width + x], 1);
122 BOOST_REQUIRE_CLOSE (cz * 4095, xyz->data(2)[y * size.width + x], 1);
128 /** Convert a test image from sRGB to XYZ and check that the transforms are right */
129 BOOST_AUTO_TEST_CASE (rgb_xyz_test)
133 rgb_xyz_test_case ([&counter](uint16_t* p) {
134 p[0] = p[1] = p[2] = (counter << 4);
136 if (counter >= 4096) {
142 boost::random::mt19937 rng(1);
143 boost::random::uniform_int_distribution<> dist(0, 4095);
145 rgb_xyz_test_case ([&rng, &dist](uint16_t* p) {
146 p[0] = dist(rng) << 4;
147 p[1] = dist(rng) << 4;
148 p[2] = dist(rng) << 4;
153 /** Check the piecewise LUT that is used for inverse gamma calculation */
154 BOOST_AUTO_TEST_CASE (rgb_xyz_lut_test)
156 auto conversion = dcp::ColourConversion::rec709_to_xyz();
157 auto lut = dcp::make_inverse_gamma_lut(conversion.out());
159 for (double x = 0; x < 1; x += 0.000001) {
160 BOOST_CHECK(std::abs(lrint(lut.lookup(x) * 4095) - lrint(pow(x, 1 / 2.6) * 4095)) < 2);
165 static list<string> notes;
168 note_handler (dcp::NoteType n, string s)
170 BOOST_REQUIRE_EQUAL (n, dcp::NoteType::NOTE);
174 /** Check that xyz_to_rgb clamps XYZ values correctly */
175 BOOST_AUTO_TEST_CASE (xyz_rgb_range_test)
177 auto xyz = make_shared<dcp::OpenJPEGImage>(dcp::Size(2, 2));
179 xyz->data(0)[0] = -4;
180 xyz->data(0)[1] = 6901;
182 xyz->data(0)[3] = 4095;
183 xyz->data(1)[0] = -4;
184 xyz->data(1)[1] = 6901;
186 xyz->data(1)[3] = 4095;
187 xyz->data(2)[0] = -4;
188 xyz->data(2)[1] = 6901;
190 xyz->data(2)[3] = 4095;
192 scoped_array<uint8_t> rgb (new uint8_t[2 * 2 * 6]);
196 xyz, dcp::ColourConversion::srgb_to_xyz (), rgb.get(), 2 * 6, boost::optional<dcp::NoteHandler> (boost::bind (¬e_handler, _1, _2))
199 /* The 6 out-of-range samples should have been noted */
200 BOOST_REQUIRE_EQUAL (notes.size(), 6U);
201 auto i = notes.begin ();
202 BOOST_REQUIRE_EQUAL (*i++, "XYZ value -4 out of range");
203 BOOST_REQUIRE_EQUAL (*i++, "XYZ value -4 out of range");
204 BOOST_REQUIRE_EQUAL (*i++, "XYZ value -4 out of range");
205 BOOST_REQUIRE_EQUAL (*i++, "XYZ value 6901 out of range");
206 BOOST_REQUIRE_EQUAL (*i++, "XYZ value 6901 out of range");
207 BOOST_REQUIRE_EQUAL (*i++, "XYZ value 6901 out of range");
209 /* And those samples should have been clamped, so check that they give the same result
210 as inputs at the extremes (0 and 4095).
213 auto buffer = reinterpret_cast<uint16_t*> (rgb.get ());
214 BOOST_REQUIRE_EQUAL (buffer[0 * 3 + 0], buffer[2 * 3 + 1]);
215 BOOST_REQUIRE_EQUAL (buffer[0 * 3 + 1], buffer[2 * 3 + 1]);
216 BOOST_REQUIRE_EQUAL (buffer[0 * 3 + 2], buffer[2 * 3 + 2]);
218 BOOST_REQUIRE_EQUAL (buffer[1 * 3 + 0], buffer[3 * 3 + 0]);
219 BOOST_REQUIRE_EQUAL (buffer[1 * 3 + 1], buffer[3 * 3 + 1]);
220 BOOST_REQUIRE_EQUAL (buffer[1 * 3 + 2], buffer[3 * 3 + 2]);
223 /** Convert an image from RGB to XYZ and back again */
224 BOOST_AUTO_TEST_CASE (rgb_xyz_round_trip_test)
227 dcp::Size const size (640, 480);
229 scoped_array<uint8_t> rgb (new uint8_t[size.width * size.height * 6]);
230 for (int y = 0; y < size.height; ++y) {
231 uint16_t* p = reinterpret_cast<uint16_t*> (rgb.get() + y * size.width * 6);
232 for (int x = 0; x < size.width; ++x) {
233 /* Write a 12-bit random number for each component */
234 for (int c = 0; c < 3; ++c) {
235 *p = (rand () & 0xfff) << 4;
241 shared_ptr<dcp::OpenJPEGImage> xyz = dcp::rgb_to_xyz (rgb.get(), size, size.width * 6, dcp::ColourConversion::srgb_to_xyz ());
242 scoped_array<uint8_t> back (new uint8_t[size.width * size.height * 6]);
243 dcp::xyz_to_rgb (xyz, dcp::ColourConversion::srgb_to_xyz (), back.get(), size.width * 6);
246 uint16_t* p = reinterpret_cast<uint16_t*> (rgb.get ());
247 uint16_t* q = reinterpret_cast<uint16_t*> (back.get ());
248 for (int i = 0; i < (size.width * size.height); ++i) {
249 /* XXX: doesn't quite work */
250 // BOOST_REQUIRE_EQUAL (*p++, *q++);