1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
/*
Metric
Copyright (C) 2006-2011 Yangli Hector Yee
Copyright (C) 2011-2016 Steven Myint, Jeff Terrace
This program 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, 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., 59 Temple
Place, Suite 330, Boston, MA 02111-1307 USA
*/
#ifndef PERCEPTUALDIFF_METRIC_H
#define PERCEPTUALDIFF_METRIC_H
#include <cstdint>
#include <ostream>
#include <string>
namespace pdiff
{
class RGBAImage;
struct PerceptualDiffParameters
{
PerceptualDiffParameters();
// Only consider luminance; ignore chroma channels in the comparison.
bool luminance_only;
// Field of view in degrees.
float field_of_view;
// The gamma to convert to linear color space
float gamma;
float luminance;
// How many pixels different to ignore.
unsigned int threshold_pixels;
// How much color to use in the metric.
// 0.0 is the same as luminance_only_ = true,
// 1.0 means full strength.
float color_factor;
};
// Image comparison metric using Yee's method.
// References: A Perceptual Metric for Production Testing, Hector Yee,
// Journal of Graphics Tools 2004
//
// Return true if the images are perceptually the same.
bool yee_compare(
const RGBAImage &image_a,
const RGBAImage &image_b,
const PerceptualDiffParameters ¶meters=PerceptualDiffParameters(),
size_t *output_num_pixels_failed=nullptr,
float *output_sum_errors=nullptr,
std::string *output_reason=nullptr,
RGBAImage *output_image_difference=nullptr,
std::ostream *output_verbose=nullptr);
}
#endif
|
