shape_histo_pointShapeHistoPointShapeHistoPointshape_histo_pointT_shape_histo_point

HALCON ScriptCpp++.NETPythonC

Short description

shape_histo_pointShapeHistoPointShapeHistoPointshape_histo_pointT_shape_histo_point — Determine a histogram of features along all threshold values.

Signature

shape_histo_point( region Region, image Image, string Feature, point.y Row, point.x Column, out histogram AbsoluteHisto, out histogram RelativeHisto )void ShapeHistoPoint( const HObject& Region, const HObject& Image, const HTuple& Feature, const HTuple& Row, const HTuple& Column, HTuple* AbsoluteHisto, HTuple* RelativeHisto )static void HOperatorSet.ShapeHistoPoint( HObject region, HObject image, HTuple feature, HTuple row, HTuple column, out HTuple absoluteHisto, out HTuple relativeHisto )def shape_histo_point( region: HObject, image: HObject, feature: str, row: int, column: int ) -> Tuple[Sequence[Union[int, float]], Sequence[float]]

Herror T_shape_histo_point( const Hobject Region, const Hobject Image, const Htuple Feature, const Htuple Row, const Htuple Column, Htuple* AbsoluteHisto, Htuple* RelativeHisto )

HTuple HRegion::ShapeHistoPoint( const HImage& Image, const HString& Feature, Hlong Row, Hlong Column, HTuple* RelativeHisto ) const

HTuple HRegion::ShapeHistoPoint( const HImage& Image, const char* Feature, Hlong Row, Hlong Column, HTuple* RelativeHisto ) const

HTuple HRegion::ShapeHistoPoint( const HImage& Image, const wchar_t* Feature, Hlong Row, Hlong Column, HTuple* RelativeHisto ) const (Windows only)

HTuple HRegion.ShapeHistoPoint( HImage image, string feature, int row, int column, out HTuple relativeHisto )

Description

Like shape_histo_allShapeHistoAll the operator shape_histo_pointShapeHistoPoint carries out 255 threshold value operations within Regionregionregion with the gray values of Imageimageimage. Contrary to shape_histo_allShapeHistoAll only the segmented region containing the pixel (Rowrowrow, Columncolumncolumn) is taken into account here. The entry \(i\) in the histogram then corresponds to the number of holes of this region segmented with the threshold \(i\) (Featurefeaturefeature = 'holes'"holes") or the feature value of the region (Featurefeaturefeature = 'convexity'"convexity", 'compactness'"compactness", 'anisometry'"anisometry"), respectively.

Attention

Note that the operator shape_histo_pointShapeHistoPoint only considers the given Regionregionregion and ignores any previously set domain of the input image Imageimageimage.

Execution information

Execution information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).

• Multithreading scope: global (may be called from any thread).

• Processed without parallelization.

Parameters

Regionregionregion (input_object) region → objectHObjectHRegionHObjectHobject

Region in which the features are to be examined.

Imageimageimage (input_object) singlechannelimage → object (byte)HObject (byte)HImage (byte)HObject (byte)Hobject (byte)

Gray value image.

Featurefeaturefeature (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Feature to be examined.

Default: 'convexity'"convexity"
List of values: 'anisometry', 'compactness', 'convexity', 'holes'"anisometry", "compactness", "convexity", "holes"

Rowrowrow (input_control) point.y → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Row of the pixel which the region must contain.

Default: 256256
Suggested values: 10, 50, 100, 200, 300, 40010, 50, 100, 200, 300, 400

Columncolumncolumn (input_control) point.x → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Column of the pixel which the region must contain.

Default: 256256
Suggested values: 10, 50, 100, 200, 300, 40010, 50, 100, 200, 300, 400

AbsoluteHistoabsoluteHistoabsolute_histo (output_control) histogram-array → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)Sequence[Union[int, float]]Htuple (double / Hlong)

Absolute distribution of the feature.

RelativeHistorelativeHistorelative_histo (output_control) histogram-array → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Relative distribution of the feature.

Result

The operator shape_histo_pointShapeHistoPoint returns the value 2 (H_MSG_TRUE) if an image with defined gray values is entered. The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:), the behavior in case of empty region is set via set_system(::'empty_region_result',<Result>:). If necessary an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

get_mbuttonGetMbutton, area_centerAreaCenter

Possible successors

histo_to_threshHistoToThresh, thresholdThreshold, gen_region_histoGenRegionHisto

Alternatives

shape_histo_allShapeHistoAll

See also

connectionConnection, connect_and_holesConnectAndHoles, convexityConvexity, compactnessCompactness

Module

Foundation