$extrastylesheet
Olena  User documentation 2.1
An Image Processing Platform
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
connectivity_number_2d.hh
1 // Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
2 //
3 // This file is part of Olena.
4 //
5 // Olena is free software: you can redistribute it and/or modify it under
6 // the terms of the GNU General Public License as published by the Free
7 // Software Foundation, version 2 of the License.
8 //
9 // Olena 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 GNU
12 // General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Olena. If not, see <http://www.gnu.org/licenses/>.
16 //
17 // As a special exception, you may use this file as part of a free
18 // software project without restriction. Specifically, if other files
19 // instantiate templates or use macros or inline functions from this
20 // file, or you compile this file and link it with other files to produce
21 // an executable, this file does not by itself cause the resulting
22 // executable to be covered by the GNU General Public License. This
23 // exception does not however invalidate any other reasons why the
24 // executable file might be covered by the GNU General Public License.
25 
26 #ifndef MLN_TOPO_CONNECTIVITY_NUMBER_2D_HH
27 # define MLN_TOPO_CONNECTIVITY_NUMBER_2D_HH
28 
31 
32 # include <mln/core/concept/image.hh>
33 
34 # include <mln/core/alias/neighb2d.hh>
35 
36 # include <mln/value/int_u8.hh>
37 
38 // FIXME: This file includes the routine mln::connectivity_number_2d,
39 // which should be moved into its own file.
40 # include <mln/topo/is_simple_2d.hh>
41 
42 
43 // FIXME: This implementation used the LUT-based (mask-based)
44 // computation of 2D connectivity numbers, which may is fast but may
45 // be inexact on the border of an image. We shoud rename these
46 // routines with a `_fast' suffix.
47 
48 namespace mln
49 {
50 
51  namespace topo
52  {
53 
62 
63 
76  template<typename I>
78  connectivity_number_2d_c4(const Image<I>& ima, const mln_psite(I)& p,
79  bool ref_val);
80 
93  template<typename I>
95  connectivity_number_2d_c8(const Image<I>& ima, const mln_psite(I)& p,
96  bool ref_val);
97 
98 
99 
100 # ifndef MLN_INCLUDE_ONLY
101 
102  template<typename I>
104  connectivity_number_2d_c4(const Image<I>& ima, const mln_psite(I)& p,
105  bool ref_val)
106  {
107  // Create a copy of mln::c4()'s own neighborhood to avoid
108  // thread-unsafe accesses to this neighborhood.
109  neighb2d nbh = c4();
110  return connectivity_number_2d(ima, nbh, p, ref_val);
111  }
112 
113  template<typename I>
115  connectivity_number_2d_c8(const Image<I>& ima, const mln_psite(I)& p,
116  bool ref_val)
117  {
118  // Create a copy of mln::c8()'s own neighborhood to avoid
119  // thread-unsafe accesses to this neighborhood.
120  neighb2d nbh = c8();
121  return connectivity_number_2d(ima, nbh, p, ref_val);
122  }
123 
124 # endif // MLN_INCLUDE_ONLY
125 
126  } // end of namespace mln::topo
127 
128 } // end of namespace mln
129 
130 #endif // ! MLN_TOPO_CONNECTIVITY_NUMBER_2D_HH