psizeselection

Selects regions from size measures.

Synopsis

psizeselection relation width height depth [-m mask] [rg_in|-] [rg_out|-]

Description

psizeselection selects regions from their size measures (depth, height, and width). The parameter relation specifies the order relation on the size values that are used to select or not a region.

If one of size parameter =-1 then this size feature is not taken into account to select regions.

Parameters

relation is an integer from [-2,2] which specifies the order relation on the size value:
- relation = 2: regions >= size
- relation = 1: regions > size.
- relation = 0: regions = size.
- relation = -1: regions < size.
- relation = -2: regions <= size.
depth is an integer defined in pixel unit. If the parameter value =-1 then this size is not taken into account.
height is an integer defined in pixel unit. If the parameter value =-1 then this size is not taken into account.
width is an integer defined in pixel unit. If the parameter value =-1 then this size is not taken into account.

Inputs

rg_in: a region map.

Outputs

rg_out: a region map.

Result

Returns the number of selected regions.

Examples

Selects all regions with width = 50 pixels in the input region map rin.pan:

   psizeselection 0 50 -1 0 rin.pan rout.pan

C++ prototype

Errc PSizeSelection( const Reg2d &rg_in, Reg2d &rg_out, int relation, long width, long height, long depth );

Version française

Sélection de régions sur leur taille.

Author: Régis Clouard