HALCON Reference Manual 10.0.2
Table of Contents / Image / Features ClassesClassesClasses | | | Operators

elliptic_axis_grayelliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray (Operator)

Name

elliptic_axis_grayelliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray — Compute the orientation and major axes of a region in a gray value image.

Signature

elliptic_axis_gray(Regions, Image : : : Ra, Rb, Phi)

Herror elliptic_axis_gray(const Hobject Regions, const Hobject Image, double* Ra, double* Rb, double* Phi)

Herror T_elliptic_axis_gray(const Hobject Regions, const Hobject Image, Htuple* Ra, Htuple* Rb, Htuple* Phi)

Herror elliptic_axis_gray(Hobject Regions, Hobject Image, double* Ra, double* Rb, double* Phi)

Herror elliptic_axis_gray(Hobject Regions, Hobject Image, HTuple* Ra, HTuple* Rb, HTuple* Phi)

double HRegion::EllipticAxisGray(const HImage& Image, double* Rb, double* Phi) const

HTuple HRegionArray::EllipticAxisGray(const HImage& Image, HTuple* Rb, HTuple* Phi) const

void HOperatorSetX.EllipticAxisGray(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [out] VARIANT* Ra, [out] VARIANT* Rb, [out] VARIANT* Phi)

VARIANT HImageX.EllipticAxisGray(
[in] IHRegionX* Regions, [out] VARIANT* Rb, [out] VARIANT* Phi)

VARIANT HRegionX.EllipticAxisGray(
[in] IHImageX* Image, [out] VARIANT* Rb, [out] VARIANT* Phi)

static void HOperatorSet.EllipticAxisGray(HObject regions, HObject image, out HTuple ra, out HTuple rb, out HTuple phi)

HTuple HImage.EllipticAxisGray(HRegion regions, out HTuple rb, out HTuple phi)

double HImage.EllipticAxisGray(HRegion regions, out double rb, out double phi)

HTuple HRegion.EllipticAxisGray(HImage image, out HTuple rb, out HTuple phi)

double HRegion.EllipticAxisGray(HImage image, out double rb, out double phi)

Description

The operator elliptic_axis_grayelliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray calculates the length of the axes and the orientation of the ellipse having the “same orientation” and the “aspect ratio” as the input region. Several input regions can be passed in RegionsRegionsRegionsRegionsregions as tuples. The length of the major axis RaRaRaRara and the minor axis RbRbRbRbrb as well as the orientation of the major axis with regard to the x-axis (PhiPhiPhiPhiphi) are determined. The angle is returned in radians. The calculation is done analogously to elliptic_axiselliptic_axiselliptic_axisEllipticAxisEllipticAxis. The only difference is that in elliptic_axis_grayelliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray the gray value moments are used instead of the region moments. The gray value moments are derived from the input image ImageImageImageImageimage. For the definition of the gray value moments, see area_center_grayarea_center_grayarea_center_grayAreaCenterGrayAreaCenterGray.

Parallelization

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Region(s) to be examined.

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Gray value image.

RaRaRaRara (output_control)  real(-array) HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Major axis of the region.

RbRbRbRbrb (output_control)  real(-array) HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Minor axis of the region.

PhiPhiPhiPhiphi (output_control)  angle.rad(-array) HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Angle enclosed by the major axis and the x-axis.

Result

elliptic_axis_grayelliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionconnectionConnectionConnection

Possible Successors

gen_ellipsegen_ellipsegen_ellipseGenEllipseGenEllipse

Alternatives

elliptic_axiselliptic_axiselliptic_axisEllipticAxisEllipticAxis

See also

area_center_grayarea_center_grayarea_center_grayAreaCenterGrayAreaCenterGray

Module

Foundation


Table of Contents / Image / Features ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH