F_VN_ImageCenterOfMass
Computes the center of mass of an image.
Syntax
Definition:
FUNCTION F_VN_ImageCenterOfMass : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
END_VAR
VAR_IN_OUT
aCenterOfMass : TcVnPoint2_LREAL;
END_VAR
VAR_INPUT
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (1 channel) | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
aCenterOfMass |
Returns the center of mass of the image |
Return valueWeiterführende Informationen
Diese Funktion berechnet den Schwerpunkt des Eingangsbildes. Es existiert die Expert-Variante F_VN_ImageCenterOfMassExp mit erweiterten Parametriermöglichkeiten.
Parameter
Eingangsbild
Das Eingangsbild ipSrcImage muss 1-kanalig sein. Wenn Sie den Schwerpunkt eines mehrkanaligen Bildes berechnen wollen, haben Sie folgende Möglichkeiten:
- Sie können das mehrkanalige Bild mit F_VN_SplitImageChannels in einzelne Kanäle aufteilen und für jeden Kanal einzeln einen Schwerpunkt berechnen.
- Sie können das mehrkanalige Bild mit F_VN_ConvertColorSpace in ein 1-kanaliges Bild umwandeln und dafür einen Schwerpunkt berechnen.
Schwerpunkt (Rückgabewert)
Über die Referenz aCenterOfMass wird der berechnete Schwerpunkt zurückgegeben.
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 |