$extrastylesheet
Olena
User documentation 2.1
An Image Processing Platform
Scribo
Modules
Namespaces
Classes
All
Classes
Namespaces
Functions
Variables
Typedefs
Enumerations
Enumerator
Friends
Groups
Pages
sauvola_formula.hh
1
// Copyright (C) 2011, 2012 EPITA Research and Development Laboratory
2
// (LRDE)
3
//
4
// This file is part of Olena.
5
//
6
// Olena is free software: you can redistribute it and/or modify it under
7
// the terms of the GNU General Public License as published by the Free
8
// Software Foundation, version 2 of the License.
9
//
10
// Olena is distributed in the hope that it will be useful,
11
// but WITHOUT ANY WARRANTY; without even the implied warranty of
12
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
// General Public License for more details.
14
//
15
// You should have received a copy of the GNU General Public License
16
// along with Olena. If not, see <http://www.gnu.org/licenses/>.
17
//
18
// As a special exception, you may use this file as part of a free
19
// software project without restriction. Specifically, if other files
20
// instantiate templates or use macros or inline functions from this
21
// file, or you compile this file and link it with other files to produce
22
// an executable, this file does not by itself cause the resulting
23
// executable to be covered by the GNU General Public License. This
24
// exception does not however invalidate any other reasons why the
25
// executable file might be covered by the GNU General Public License.
26
27
#ifndef SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_FORMULA_HH
28
# define SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_FORMULA_HH
29
30
35
36
37
// Setup default Sauvola's formula parameters values.
38
// These macros may be used in other variant of Sauvola's algorithms.
39
//
40
// Values are set according to the following reference: "Automatic
41
// Evaluation of Document Binarization Results", Badekas and al, 2005
42
//
43
// Badekas et al. said 0.34 was best for Sauvola.
44
# define SCRIBO_DEFAULT_SAUVOLA_K 0.34
45
//
46
// 128 is best for grayscale documents.
47
# define SCRIBO_DEFAULT_SAUVOLA_R 128
48
49
50
#include <mln/core/alias/point2d.hh>
51
52
namespace
scribo
53
{
54
55
namespace
binarization
56
{
57
58
namespace
internal
59
{
60
61
using namespace
mln;
62
63
struct
sauvola_formula
64
{
65
78
double
operator()(
const
double
m_x_y,
const
double
s_x_y,
79
const
double
K,
const
double
R)
const
;
80
85
double
operator()(
const
double
m_x_y,
const
double
s_x_y)
const
;
86
87
};
88
89
90
# ifndef MLN_INCLUDE_ONLY
91
92
inline
93
double
94
sauvola_formula::operator()
(
const
double
m_x_y,
const
double
s_x_y,
95
const
double
K,
const
double
R)
const
96
{
97
return
m_x_y * (1.0 + K * ((s_x_y / R) - 1.0));
98
}
99
100
inline
101
double
102
sauvola_formula::operator()
(
const
double
m_x_y,
const
double
s_x_y)
const
103
{
104
return
(*
this
)(m_x_y, s_x_y,
105
SCRIBO_DEFAULT_SAUVOLA_K, SCRIBO_DEFAULT_SAUVOLA_R);
106
}
107
108
# endif // ! MLN_INCLUDE_ONLY
109
110
}
// end of namespace scribo::binarization::internal
111
112
}
// end of namespace scribo::binarization
113
114
}
// end of namespace scribo
115
116
#endif // ! SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_FORMULA_HH
scribo
scribo
binarization
internal
sauvola_formula.hh
Copyright (C) 2012 EPITA Research and Development Laboratory (LRDE)