Skip to content

gen_struct_elementsGenStructElementsGenStructElementsgen_struct_elementsgen_struct_elements🔗

Short description🔗

gen_struct_elementsGenStructElementsGenStructElementsgen_struct_elementsgen_struct_elements — Generate standard structuring elements.

Warning🔗

gen_struct_elementsGenStructElements is obsolete and is only provided for reasons of backward compatibility.

Signature🔗

gen_struct_elements( out region StructElements, string Type, point.y Row, point.x Column )void GenStructElements( HObject* StructElements, const HTuple& Type, const HTuple& Row, const HTuple& Column )static void HOperatorSet.GenStructElements( out HObject structElements, HTuple type, HTuple row, HTuple column )def gen_struct_elements( type: str, row: int, column: int ) -> HObject

Herror gen_struct_elements( Hobject* StructElements, const char* Type, const Hlong Row, const Hlong Column )

Herror T_gen_struct_elements( Hobject* StructElements, const Htuple Type, const Htuple Row, const Htuple Column )

void HRegion::GenStructElements( const HString& Type, Hlong Row, Hlong Column )

void HRegion::GenStructElements( const char* Type, Hlong Row, Hlong Column )

void HRegion::GenStructElements( const wchar_t* Type, Hlong Row, Hlong Column ) (Windows only)

void HRegion.GenStructElements( string type, int row, int column )

Description🔗

gen_struct_elementsGenStructElements serves to generate eight structuring elements normally used in the operator fittingFitting. The default value 'noise'"noise" of the parameter Typetypetype 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

Execution information🔗

Execution information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

StructElementsstructElementsstruct_elements (output_object) region(-array) → objectHObjectHRegionHObjectHobject *

Generated structuring elements.

Typetypetype (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Type of structuring element to generate.

Default: 'noise'"noise"
List of values: 'noise'"noise"

Rowrowrow (input_control) point.y → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Row coordinate of the reference point.

Default: 11
Suggested values: 0, 1, 10, 50, 100, 200, 300, 4000, 1, 10, 50, 100, 200, 300, 400
Value range: Row (lin)

Columncolumncolumn (input_control) point.x → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Column coordinate of the reference point.

Default: 11
Suggested values: 0, 1, 10, 50, 100, 200, 300, 4000, 1, 10, 50, 100, 200, 300, 400
Value range: Column (lin)

Result🔗

gen_struct_elementsGenStructElements returns 2 (H_MSG_TRUE) if all parameters are correct. Otherwise, an exception is raised.

Combinations with other operators🔗

Combinations

Possible successors

fittingFitting, hit_or_missHitOrMiss, openingOpening, closingClosing, erosion2Erosion2, dilation2Dilation2

See also

golay_elementsGolayElements

Module🔗

Foundation