F_VN_ImageCenterOfMass

F_VN_ImageCenterOfMass 1:

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

F_VN_ImageCenterOfMass 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

Source image (1 channel)

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

F_VN_ImageCenterOfMass 3: In/Outputs

Name

Type

Description

aCenterOfMass

TcVnPoint2_LREAL

Returns the center of mass of the image

F_VN_ImageCenterOfMass 4: Return value

HRESULT

Further information

This function calculates the center of mass of the input image. The expert version F_VN_ImageCenterOfMassExp exists with advanced parameterization options.

Parameter

Input image

The input image ipSrcImage must be a 1-channel image. If you wish to calculate the center of mass of a multi-channel image, you have the following options:

Center of mass (return value)

The calculated center of mass is returned via the reference aCenterOfMass.

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.54 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision