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 >:

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_t &	bbox (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_set &	values_eligible () const
const t_values_space &	values_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]

Duplicate the underlying image and create a new labeled_image.

Definition at line 229 of file labeled_image.hh.

References mln::internal::image_base< const I::value, I::domain_t, labeled_image< I > >::data_, mln::duplicate(), mln::internal::image_base< const I::value, I::domain_t, labeled_image< I > >::hook_data_(), and mln::labeled_image_base< I, labeled_image< I > >::nlabels().

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]

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

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