Operator Reference

HALCON Operator Reference / Image / Features
ClassesClasses | | Operators

area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayarea_center_gray (Operator)

area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayarea_center_gray — Compute the area and center of gravity of a region in a gray value image.

Signature

area_center_gray(Regions, Image : : : Area, Row, Column)

Herror area_center_gray(const Hobject Regions, const Hobject Image, double* Area, double* Row, double* Column)

Herror T_area_center_gray(const Hobject Regions, const Hobject Image, Htuple* Area, Htuple* Row, Htuple* Column)

void AreaCenterGray(const HObject& Regions, const HObject& Image, HTuple* Area, HTuple* Row, HTuple* Column)

HTuple HImage::AreaCenterGray(const HRegion& Regions, HTuple* Row, HTuple* Column) const

double HImage::AreaCenterGray(const HRegion& Regions, double* Row, double* Column) const

HTuple HRegion::AreaCenterGray(const HImage& Image, HTuple* Row, HTuple* Column) const

double HRegion::AreaCenterGray(const HImage& Image, double* Row, double* Column) const

static void HOperatorSet.AreaCenterGray(HObject regions, HObject image, out HTuple area, out HTuple row, out HTuple column)

HTuple HImage.AreaCenterGray(HRegion regions, out HTuple row, out HTuple column)

double HImage.AreaCenterGray(HRegion regions, out double row, out double column)

HTuple HRegion.AreaCenterGray(HImage image, out HTuple row, out HTuple column)

double HRegion.AreaCenterGray(HImage image, out double row, out double column)

def area_center_gray(regions: HObject, image: HObject) -> Tuple[Sequence[float], Sequence[float], Sequence[float]]

def area_center_gray_s(regions: HObject, image: HObject) -> Tuple[float, float, float]

Description

area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayarea_center_gray computes the area and center of gravity of the regions RegionsRegionsRegionsregionsregions that have gray values which are defined by the image ImageImageImageimageimage. This operator is similar to area_centerarea_centerAreaCenterAreaCenterarea_center, but in contrast to that operator, the gray values of the image are taken into account while computing the area and center of gravity.

The area A of a region R in the image with the gray values g(r,c) is defined as This means that the area is defined by the volume of the gray value function g(r,c). The center of gravity is defined by the first two normalized moments of the gray values g(r,c), i.e., by , where

Note, that in the case where the AreaAreaAreaareaarea is zero the row and column coordinates of the center of gravity are also set to zero.

Attention

Note that the operator area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayarea_center_gray only considers the given RegionsRegionsRegionsregionsregions and ignores any previously set domain of the input image ImageImageImageimageimage. area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayarea_center_gray can be executed on OpenCL devices if the device supports the cl_khr_fp64 and cl_khr_int64_base_atomics OpenCL extensions.

Execution Information

  • Supports OpenCL compute devices.
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.

Parameters

RegionsRegionsRegionsregionsregions (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Region(s) to be examined.

ImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte* / direction* / cyclic* / int1* / int2* / uint2* / int4* / real*) *allowed for compute devices

Gray value image.

AreaAreaAreaareaarea (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Gray value volume of the region.

RowRowRowrowrow (output_control)  point.y(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Row coordinate of the gray value center of gravity.

ColumnColumnColumncolumncolumn (output_control)  point.x(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Column coordinate of the gray value center of gravity.

Result

area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayarea_center_gray returns 2 ( H_MSG_TRUE) if all parameters are correct and no error occurs during execution. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionconnection

Alternatives

area_centerarea_centerAreaCenterAreaCenterarea_center

See also

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldarea_center_xld, elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGrayelliptic_axis_gray

Module

Foundation

ClassesClasses | | Operators