Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | Private Types

mln::labeled_image< I > Class Template Reference
[Identity morphers]

Morpher providing an improved interface for labeled image. More...

#include <labeled_image.hh>

Inheritance diagram for mln::labeled_image< I >:
Inheritance graph

List of all members.

Public Types

typedef accu::shape::bbox
< typename I::psite >::result 
bbox_t
 Type of the bounding component bounding boxes.
typedef I::domain_t::bkd_piter bkd_piter
 Backward Site_Iterator associated type.
typedef Image< void > category
typedef const I delegatee
 Delegatee associated type.
typedef I::domain_t domain_t
 Site_Set associated type.
typedef labeled_image< I > exact_t
typedef I::domain_t::fwd_piter fwd_piter
 Forward Site_Iterator associated type.
typedef
internal::morpher_lvalue_
< const I >::ret 
lvalue
 Return type of read-write access.
typedef fwd_piter piter
 Site_Iterator associated type; default definition is fwd_piter.
typedef I::domain_t::psite psite
 Point_Site associated type.
typedef const I::rvalue rvalue
 Return type of read-only access.
typedef I::domain_t::site site
 Site associated type.
typedef labeled_image
< tag::image_< I > > 
skeleton
 Skeleton.
typedef mln::value::set< const
I::value > 
t_eligible_values_set
 Eligible-value-set associated type.
typedef mln::value::set
< typename
mln::value::super_value< const
I::value >::ret
t_values_space
 Value space associated type.
typedef const I unmorph
 Unmorph image associated type.
typedef const I::value value
 Value associated type.

Public Member Functions

const bbox_tbbox (const typename I::value &label) const
 Return the bounding box of the component label.
const util::array< bbox_t > & bboxes () const
 Return the component bounding boxes.
mln::metal::const_< const I >
::ret
delegatee_ () const
 Return the delegatee_ pointer; default code.
const I * delegatee_ ()
 Return the delegatee_ pointer (non-const version); default code.
void destroy ()
 Detach data from an image (free it if nobody else hold it).
const const I::domain_t & domain () const
bool has (const typename const I::psite &p) const
bool has (const psite &p) const
 Test if p belongs to the image domain.
const util::tracked_ptr
< internal::data
< labeled_image< I > > > & 
hook_data_ () const
 Hook to the image data.
const void * id_ () const
 Give an identifier of this image.
unsigned index_of_point (const P &p) const
 Give the offset of the site p.
void init_ (const I &ima, const typename I::value &nlabels)
 Deferred initialization from a labeled image ima and the number of labels nlabels.
void init_from_ (const labeled_image< I > &model)
 Duplicate the underlying image and create a new labeled_image.
bool is_valid () const
 Test if this image has been initialized; default impl.
I::value nlabels () const
 Return the number of labels;.
std::size_t nsites () const
 Give the number of sites of the image domain.
lvalue operator() (const typename I::domain_t::psite &p)
 Read-write access of pixel value at point site p.
rvalue operator() (const typename I::domain_t::psite &p) const
 Read-only access of pixel value at point site p.
labeled_image< I > & rw ()
 State that the morpher is writable.
p_if< mln_box(I),
fun::eq_v2b_expr_< pw::value_
< I >, pw::cst_< typename
I::value > > > 
subdomain (const typename I::value &label) const
 Return the domain of the component with label label.
mln::metal::const_< const I >
::ret
unmorph_ () const
 Give the morphed image (const version).
const I & unmorph_ ()
 Give the morphed image (mutable version).
const t_eligible_values_setvalues_eligible () const
const t_values_spacevalues_space () const
 Return the value space of the image.

 labeled_image ()
 ConstructorsConstructor without argument.
 labeled_image (const I &ima, const typename I::value &nlabels)
 Constructor from an image ima and the number of labels nlabels.
 labeled_image (const I &ima, const typename I::value &nlabels, const util::array< mln_box(I)> &bboxes)
 Constructor from an image ima, the number of labels nlabels and the object bounding boxes.

void relabel (const Function_v2v< F > &f)
 Relabel according to a function.
void relabel (const Function_v2b< F > &f)
 Labels may be removed.

Protected Member Functions

void relabel_ (const Function_v2v< F > &f)
void relabel_ (const Function_v2b< F > &f)
void update_data (const fun::i2v::array< typename I::value > &relabel_fun)
 Update bounding boxes information.

void init_update_data_ ()
 Called during relabeling.
void prepare_update_data_ (const typename I::value &lbl, const typename I::value &new_lbl)
void update_data_ (const fun::i2v::array< typename I::value > &relabel_fun)

Protected Attributes

util::tracked_ptr
< internal::data
< labeled_image< I > > > 
data_

Private Types

typedef labeled_image_base< I,
labeled_image< I > > 
super_

Detailed Description

template<typename I>
class mln::labeled_image< I >

Morpher providing an improved interface for labeled image.

Template Parameters:
I The label image type.

This image type allows to access every site set at a given label.

This image type guaranties that labels are contiguous (from 1 to n).

Definition at line 105 of file labeled_image.hh.


Member Typedef Documentation

typedef accu::shape::bbox<typename I ::psite>::result mln::labeled_image_base< I, labeled_image< I > >::bbox_t [inherited]

Type of the bounding component bounding boxes.

Definition at line 124 of file labeled_image_base.hh.

typedef I::domain_t ::bkd_piter mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::bkd_piter [inherited]

Backward Site_Iterator associated type.

Definition at line 118 of file core/internal/image_base.hh.

typedef Image<void> mln::Image< labeled_image< I > >::category [inherited]

Reimplemented from mln::Object< labeled_image< I > >.

Definition at line 75 of file core/concept/image.hh.

typedef const I mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::delegatee [inherited]

Delegatee associated type.

Definition at line 57 of file image_morpher.hh.

typedef I::domain_t mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::domain_t [inherited]

Site_Set associated type.

Definition at line 105 of file core/internal/image_base.hh.

typedef labeled_image< I > mln::Object< labeled_image< I > >::exact_t [inherited]

Definition at line 173 of file object.hh.

typedef I::domain_t ::fwd_piter mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::fwd_piter [inherited]

Forward Site_Iterator associated type.

Definition at line 115 of file core/internal/image_base.hh.

typedef internal::morpher_lvalue_< const I >::ret mln::internal::image_identity< const I , I::domain_t , labeled_image< I > >::lvalue [inherited]

Return type of read-write access.

Definition at line 140 of file image_identity.hh.

typedef fwd_piter mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::piter [inherited]

Site_Iterator associated type; default definition is fwd_piter.

Definition at line 123 of file core/internal/image_base.hh.

typedef I::domain_t ::psite mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::psite [inherited]

Point_Site associated type.

Definition at line 108 of file core/internal/image_base.hh.

typedef const I ::rvalue mln::internal::image_identity< const I , I::domain_t , labeled_image< I > >::rvalue [inherited]

Return type of read-only access.

Definition at line 137 of file image_identity.hh.

typedef I::domain_t ::site mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::site [inherited]

Site associated type.

Definition at line 111 of file core/internal/image_base.hh.

template<typename I>
typedef labeled_image< tag::image_<I> > mln::labeled_image< I >::skeleton

Skeleton.

Definition at line 113 of file labeled_image.hh.

template<typename I>
typedef labeled_image_base<I, labeled_image<I> > mln::labeled_image< I >::super_ [private]

Reimplemented from mln::labeled_image_base< I, labeled_image< I > >.

Definition at line 108 of file labeled_image.hh.

typedef mln::value::set<const I::value > mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::t_eligible_values_set [inherited]

Eligible-value-set associated type.

Definition at line 91 of file core/internal/image_base.hh.

typedef mln::value::set< typename mln::value::super_value<const I::value >::ret > mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::t_values_space [inherited]

Value space associated type.

Definition at line 98 of file core/internal/image_base.hh.

typedef const I mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::unmorph [inherited]

Unmorph image associated type.

Definition at line 68 of file image_morpher.hh.

typedef const I ::value mln::internal::image_identity< const I , I::domain_t , labeled_image< I > >::value [inherited]

Value associated type.

Reimplemented from mln::internal::image_base< const I::value, I::domain_t, labeled_image< I > >.

Definition at line 134 of file image_identity.hh.


Constructor & Destructor Documentation

template<typename I >
mln::labeled_image< I >::labeled_image (  )  [inline]

ConstructorsConstructor without argument.

Definition at line 193 of file labeled_image.hh.

template<typename I >
mln::labeled_image< I >::labeled_image ( const I &  ima,
const typename I::value &  nlabels 
) [inline]

Constructor from an image ima and the number of labels nlabels.

Definition at line 199 of file labeled_image.hh.

References mln::labeled_image< I >::init_().

template<typename I >
mln::labeled_image< I >::labeled_image ( const I &  ima,
const typename I::value &  nlabels,
const util::array< mln_box(I)> &  bboxes 
) [inline]

Constructor from an image ima, the number of labels nlabels and the object bounding boxes.

Definition at line 206 of file labeled_image.hh.

References mln::data::compute(), and mln::internal::image_base< const I::value, I::domain_t, labeled_image< I > >::data_.


Member Function Documentation

const bbox_t& mln::labeled_image_base< I, labeled_image< I > >::bbox ( const typename I::value &  label  )  const [inherited]

Return the bounding box of the component label.

Referenced by mln::test_image().

const util::array<bbox_t>& mln::labeled_image_base< I, labeled_image< I > >::bboxes (  )  const [inherited]

Return the component bounding boxes.

mln::metal::const_< const I >::ret* mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::delegatee_ (  )  const [inherited]

Return the delegatee_ pointer; default code.

const I * mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::delegatee_ (  )  [inherited]

Return the delegatee_ pointer (non-const version); default code.

void mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::destroy (  )  [inherited]

Detach data from an image (free it if nobody else hold it).

const const I ::domain_t& mln::internal::image_identity< const I , I::domain_t , labeled_image< I > >::domain (  )  const [inherited]
bool mln::internal::image_identity< const I , I::domain_t , labeled_image< I > >::has ( const typename const I ::psite p  )  const [inherited]
bool mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::has ( const psite p  )  const [inherited]

Test if p belongs to the image domain.

const util::tracked_ptr< internal::data<labeled_image< I > > >& mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::hook_data_ (  )  const [inherited]

Hook to the image data.

Referenced by mln::labeled_image< I >::init_from_().

const void* mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::id_ (  )  const [inherited]

Give an identifier of this image.

When several image variables designate the same image, they share the same identifier.

unsigned mln::internal::check::image_fastest_< labeled_image< I > , mln::metal::equal< mln_trait_image_speed(labeled_image< I >), trait::image::speed::fastest >::eval >::index_of_point ( const P &  p  )  const [inherited]

Give the offset of the site p.

Parameters:
[in] p A site.
Warning:
This method is final.
Precondition:
The image has to be initialized and to own the point p.
Postcondition:
p == point_at_index(result)
template<typename I >
void mln::labeled_image< I >::init_ ( const I &  ima,
const typename I::value &  nlabels 
) [inline]

Deferred initialization from a labeled image ima and the number of labels nlabels.

Definition at line 217 of file labeled_image.hh.

References mln::labeling::compute(), mln::data::compute(), and mln::internal::image_base< const I::value, I::domain_t, labeled_image< I > >::data_.

Referenced by mln::init_(), and mln::labeled_image< I >::labeled_image().

template<typename I >
void mln::labeled_image< I >::init_from_ ( const labeled_image< I > &  model  )  [inline]
void mln::labeled_image_base< I, labeled_image< I > >::init_update_data_ (  )  [protected, inherited]

Called during relabeling.

bool mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::is_valid (  )  const [inherited]

Test if this image has been initialized; default impl.

Reimplemented from mln::internal::image_base< const I::value, I::domain_t, labeled_image< I > >.

I ::value mln::labeled_image_base< I, labeled_image< I > >::nlabels (  )  const [inherited]

Return the number of labels;.

Referenced by mln::init_(), mln::labeled_image< I >::init_from_(), and mln::test_image().

std::size_t mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::nsites (  )  const [inherited]

Give the number of sites of the image domain.

lvalue mln::internal::image_identity< const I , I::domain_t , labeled_image< I > >::operator() ( const typename I::domain_t ::psite p  )  [inherited]

Read-write access of pixel value at point site p.

rvalue mln::internal::image_identity< const I , I::domain_t , labeled_image< I > >::operator() ( const typename I::domain_t ::psite p  )  const [inherited]

Read-only access of pixel value at point site p.

void mln::labeled_image_base< I, labeled_image< I > >::prepare_update_data_ ( const typename I::value &  lbl,
const typename I::value &  new_lbl 
) [protected, inherited]
void mln::labeled_image_base< I, labeled_image< I > >::relabel ( const Function_v2b< F > &  f  )  [inherited]

Labels may be removed.

This overload make sure the labeling is still contiguous.

void mln::labeled_image_base< I, labeled_image< I > >::relabel ( const Function_v2v< F > &  f  )  [inherited]

Relabel according to a function.

Merge or delete labels according to the given function. This method ensures that the labeling remains contiguous.

void mln::labeled_image_base< I, labeled_image< I > >::relabel_ ( const Function_v2v< F > &  f  )  [protected, inherited]
void mln::labeled_image_base< I, labeled_image< I > >::relabel_ ( const Function_v2b< F > &  f  )  [protected, inherited]
labeled_image< I > & mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::rw (  )  [inherited]

State that the morpher is writable.

This allows for C++ to use it as a mutable object even if it is a temporary object.

p_if<mln_box(I), fun::eq_v2b_expr_<pw::value_<I>, pw::cst_<typename I ::value> > > mln::labeled_image_base< I, labeled_image< I > >::subdomain ( const typename I::value &  label  )  const [inherited]

Return the domain of the component with label label.

mln::metal::const_< const I >::ret& mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::unmorph_ (  )  const [inherited]

Give the morphed image (const version).

const I & mln::internal::image_morpher< const I , const I::value , I::domain_t , labeled_image< I > >::unmorph_ (  )  [inherited]

Give the morphed image (mutable version).

void mln::labeled_image_base< I, labeled_image< I > >::update_data ( const fun::i2v::array< typename I::value > &  relabel_fun  )  [protected, inherited]

Update bounding boxes information.

void mln::labeled_image_base< I, labeled_image< I > >::update_data_ ( const fun::i2v::array< typename I::value > &  relabel_fun  )  [protected, inherited]
const t_eligible_values_set& mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::values_eligible (  )  const [inherited]
const t_values_space& mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::values_space (  )  const [inherited]

Return the value space of the image.


Member Data Documentation

util::tracked_ptr< internal::data<labeled_image< I > > > mln::internal::image_base< const I::value , I::domain_t , labeled_image< I > >::data_ [protected, inherited]