gen_struct_elements

Herror ::gen_struct_elements ( Hobject *StructElements, const HTuple &Type, const HTuple &Row, const HTuple &Column ) HRegion HRegion::GenStructElements ( const HTuple &Type, const HTuple &Row, const HTuple &Column ) HRegionArray HRegionArray::GenStructElements ( const HTuple &Type, const HTuple &Row, const HTuple &Column )

Generate standard structuring elements.

::gen_struct_elements serves to generate eight structuring elements normally used in the operator ::fitting. The default value 'noise' of the parameter Type generates elements especially suited for the elimination of noise.

  o o o   o * o   o o *   * o o   o o o  o o o   o * o   o * o
  * * *   o * o   o * o   o * o   * * o  o * *   * * o   o * *
  o o o   o * o   * o o   o o *   o * o  o * o   o o o   o o o
    M1      M2      M3      M4      M5     M6      M7      M8

Parameters

`StructElements` (output_object)	region(-array) `->` Hobject : HRegion(Array)*
Generated structuring elements.

`Type` (input_control)	string `->` HTuple.char *
Type of structuring element to generate.
Default value: 'noise'
List of values: 'noise'

`Row` (input_control)	point.y `->` HTuple.long
Row coordinate of the reference point.
Default value: 1
Suggested values: 0, 1, 10, 50, 100, 200, 300, 400
Typical range of values: `-oo <= Row <= -oo` (lin)

`Column` (input_control)	point.x `->` HTuple.long
Column coordinate of the reference point.
Default value: 1
Suggested values: 0, 1, 10, 50, 100, 200, 300, 400
Typical range of values: `-oo <= Column <= -oo` (lin)

Result

::gen_struct_elements returns H_MSG_TRUE if all parameters are correct. Otherwise, an exception is raised.

Possible Successors

::fitting, ::hit_or_miss, ::opening, ::closing, ::erosion2, ::dilation2

See also

::golay_elements

Module

Morphology