pbarbremoval

Removes barbs from length.

Synopsis

pbarbremoval relation length [-m mask] [im_in|-] [im_out|-]

Description

pbarbremoval removes barbs from their length value. A barb is a chain of connected non null pixels with 1 pixel thickness that begins with an end point (a point with only one neighbor) and that ends at a junction (a point with more than two neighbors):

         /
 --------
         \

The parameter relation specifies the order relation to the length value that is used to select or not a barb. All other contour points are kept in the output image.

Warning: if the contour is not 1 pixel thickness, the operator may have unpredictable behavior. It might be necessary to use the operator ppostthinning to guaranty 1 pixel thickness.

Parameters

relation is an integer from [-2,2] which specifies the order relation to the length value:
- relation = 2: barbs ≥ length.
- relation = 1: barbs > length.
- relation = 0: barbs = length.
- relation = -1: barbs < length.
- relation = -2: barbs ≤ length.
length is an integer defined in pixel unit.

Inputs

im_in: a unsigned char graycale image (Img2duc or Img3duc).

Outputs

im_out: an image of the same type as the input image.

Result

The number of removed barbs.

Examples

Removes barbs from contours yielded by a simple edge detection of tangram.pan:

   psobel tangram.pan b.pan
   pbinarization 45 1e30 b.pan c.pan
   pskeletonization c.pan d.pan 
   ppostthinning d.pan e.pan
   pbarbremoval 1 5 e.pan out.pan
   pstatus

C++ prototype

Errc PBarbRemoval( const Img2duc &im_in, Img2duc &im_out, int relation, int length );

Version française

Suppression des barbules sur leur longueur.

Author: Régis Clouard