F_VN_MorphologicalOperator

Syntax

Definition:

FUNCTION F_VN_MorphologicalOperator : HRESULT
VAR_INPUT
    ipSrcImage           : ITcVnImage;
    ipDestImage          : Reference To  ITcVnImage;
    eOperator            : ETcVnMorphologicalOperator;
    ipStructuringElement : ITcVnImage;
    hrPrev               : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	Source image (only 1 channel supported for reconstruction operators)
ipDestImage	Reference To ITcVnImage	Destination image (An appropriate destination image will be created if required.)
eOperator	ETcVnMorphologicalOperator	Operator type
ipStructuringElement	ITcVnImage	Structuring element to be applied (Typically created via F_VN_CreateStructuringElement.)
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Weiterführende Informationen

Die Funktion F_VN_MorphologicalOperator wendet einen morphologischen Operator auf das Eingangsbild an.

Parameter

Originalbild

Die Reconstruction-Operatoren können nur auf ein 1-Kanal-Bild angewendet werden, die anderen Operatoren stellen keine besonderen Anforderungen an das Originalbild ipSrcImage.

Ergebnisbild

Im Ergebnisbild ipDestImage wird das veränderte Bild zurückgegeben.

Morphologischer Operator

Der Parameter eOperator definiert, welcher morphologische Operator auf das Originalbild ipSrcImage angewandt wird. Zur Verfügung stehen alle Operatoren im Enum ETcVnMorphologicalOperator.

Struktur-Element

Das Struktur-Element ipStructuringElement ist das Element, das das Filtergebiet des morphologischen Operators vorgibt. Es kann mit Hilfe der Funktion F_VN_CreateStructuringElement erstellt werden.

Anwendung

Die Anwendung eines Opening-Operators mit einem rechteckigen Filtergebiet der Größe 3×3 sieht z. B. so aus:

VAR
    ipElement : ITcVnImage; 
END_VAR

hr := F_VN_CreateStructuringElement(ipElement, TCVN_SES_RECTANGLE, 3, 3, hr);

hr := F_VN_MorphologicalOperator(
    ipSrcImage  :=  ipImageIn,
    ipDestImage :=  ipImageRes,
    eOperator   :=  TCVN_MO_OPENING,
    ipStructuringElement  :=  ipElement,
    hrPrev      :=  hr
);

Beispiele

Morphologische Operatoren

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4024.59 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision