[Olena-patches] olena: olena-2.0-605-g53d1610 doc/mln/labeling/labeling.dox: Write general documentation on labeling.

--- milena/ChangeLog | 5 ++++ milena/doc/mln/labeling/labeling.dox | 35 +++++++++++++++++++++++++++++---- 2 files changed, 35 insertions(+), 5 deletions(-) diff --git a/milena/ChangeLog b/milena/ChangeLog index c18309f..89d615b 100644 --- a/milena/ChangeLog +++ b/milena/ChangeLog @@ -1,5 +1,10 @@ 2013-05-13 Guillaume Lazzara <z(a)lrde.epita.fr> + * doc/mln/labeling/labeling.dox: Write general documentation on + labeling. + +2013-05-13 Guillaume Lazzara <z(a)lrde.epita.fr> + * doc/ref-guide.tex: Mention *_without_localization routines in reference guide. diff --git a/milena/doc/mln/labeling/labeling.dox b/milena/doc/mln/labeling/labeling.dox index c0b09c4..3ae56df 100644 --- a/milena/doc/mln/labeling/labeling.dox +++ b/milena/doc/mln/labeling/labeling.dox @@ -1,6 +1,31 @@ /*! \defgroup labeling Image Labeling - * - * \brief All labeling routines provided in Milena. - * - * \ingroup modroutines - */ + + \brief All labeling-related routines provided in Milena. + + Olena provides both labeling routines and routines working on + labeled image to massively process each label. + + labeling::blobs, labeling::value, labeling::foreground, + labeling::flat_zones, and labeling::background can be used to label + binary or gray-level images. Labeled images produced by these + algorithms are made of a continuous labeling starting from index + 1. Output image may contain value '0' which is considered in + Milena as a non-label and is usually used for background. + + \warning In all labeling functions returning the number of labels, + (usually named as \c nlabels), the number of label only refers to + the labels different from '0' (which is considered as no-label + value). A labeled image may contain \c nlabels + 1 different + values. + + labeling::compute_image, labeling::compute, labeling::mean_colors, + massively compute attribute on labeled image. + + labeling::value_and_compute performs both labeling and attribute + computation at the same time. + + labeling::wrap, labeling::superpose, and labeling::colorize are + usually used for debugging purpose to output labeled images. + + \ingroup modroutines +*/ -- 1.7.2.5