area_center_gray — Compute the area and center of gravity of a region in a gray value
area_center_gray computes the area and center of gravity of
Regions that have gray values which are defined
by the image
Image. This operator is similar to
area_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
Area is zero the row and
column coordinates of the center of gravity are also set to zero.
Note that the operator
area_center_gray only considers
Regions and ignores any previously set domain
of the input image
area_center_gray can be executed on OpenCL devices if the device
supports the cl_khr_fp64 and cl_khr_int64_base_atomics OpenCL extensions.
Region(s) to be examined.
→object (byte* / direction* / cyclic* / int1* / int2* / uint2* / int4* / real*) *allowed for compute devices
Gray value image.
Gray value volume of the region.
Row coordinate of the gray value center of gravity.
Column coordinate of the gray value center of gravity.
area_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
necessary, an exception is raised.