HALCON Website / HALCON Operator-Referenz / Segmentation / Schwellenwert-Verfahren
KlassenKlassen | | Operatoren

check_differencecheck_differenceCheckDifferenceCheckDifferencecheck_difference (Operator)

Name

check_differencecheck_differenceCheckDifferenceCheckDifferencecheck_difference — Pixelweises Vergleichen zweier Bilder.

Signatur

check_difference(Image, Pattern : Selected : Mode, DiffLowerBound, DiffUpperBound, GrayOffset, AddRow, AddCol : )

Herror check_difference(const Hobject Image, const Hobject Pattern, Hobject* Selected, const char* Mode, const Hlong DiffLowerBound, const Hlong DiffUpperBound, const Hlong GrayOffset, const Hlong AddRow, const Hlong AddCol)

Herror T_check_difference(const Hobject Image, const Hobject Pattern, Hobject* Selected, const Htuple Mode, const Htuple DiffLowerBound, const Htuple DiffUpperBound, const Htuple GrayOffset, const Htuple AddRow, const Htuple AddCol)

void CheckDifference(const HObject& Image, const HObject& Pattern, HObject* Selected, const HTuple& Mode, const HTuple& DiffLowerBound, const HTuple& DiffUpperBound, const HTuple& GrayOffset, const HTuple& AddRow, const HTuple& AddCol)

HRegion HImage::CheckDifference(const HImage& Pattern, const HString& Mode, Hlong DiffLowerBound, Hlong DiffUpperBound, Hlong GrayOffset, Hlong AddRow, Hlong AddCol) const

HRegion HImage::CheckDifference(const HImage& Pattern, const char* Mode, Hlong DiffLowerBound, Hlong DiffUpperBound, Hlong GrayOffset, Hlong AddRow, Hlong AddCol) const

HRegion HImage::CheckDifference(const HImage& Pattern, const wchar_t* Mode, Hlong DiffLowerBound, Hlong DiffUpperBound, Hlong GrayOffset, Hlong AddRow, Hlong AddCol) const   (Nur Windows)

static void HOperatorSet.CheckDifference(HObject image, HObject pattern, out HObject selected, HTuple mode, HTuple diffLowerBound, HTuple diffUpperBound, HTuple grayOffset, HTuple addRow, HTuple addCol)

HRegion HImage.CheckDifference(HImage pattern, string mode, int diffLowerBound, int diffUpperBound, int grayOffset, int addRow, int addCol)

def check_difference(image: HObject, pattern: HObject, mode: str, diff_lower_bound: int, diff_upper_bound: int, gray_offset: int, add_row: int, add_col: int) -> HObject

Beschreibung

check_differencecheck_differenceCheckDifferenceCheckDifferenceCheckDifferencecheck_difference wählt aus dem Eingabebild die Bildpunkte ( ) aus, deren Grauwertabweichung von den entsprechenden Pixel in PatternPatternPatternPatternpatternpattern abhängig vom Parameter ModeModeModeModemodemode innerhalb bzw. außerhalb des vorgegebenen Werteintervalls liegt. Die Pixel in PatternPatternPatternPatternpatternpattern werden um gegenüber ImageImageImageImageimageimage verschoben. Sei der Grauwert aus PatternPatternPatternPatternpatternpattern, der gegenüber um den Vektor verschoben ist.

Dann werden im Modus 'diff_inside'"diff_inside""diff_inside""diff_inside""diff_inside""diff_inside" die Pixel selektiert mit und im Modus 'diff_outside'"diff_outside""diff_outside""diff_outside""diff_outside""diff_outside" die mit g_o - g_p - GrayOffset < DiffLowerBound oder g_o - g_p - GrayOffset > DiffUpperBound

Dieser Test wird für alle Bildpunkte aus dem Definitionsbereich von ImageImageImageImageimageimage, geschnitten mit dem verschobenen Definitionsbereich von PatternPatternPatternPatternpatternpattern, durchgeführt. Alle Punkte, die die obige Bedingung erfüllen, werden in der Ausgaberegion gespeichert. Die beiden Bilder können unterschiedliche Größe haben. Typischerweise ist PatternPatternPatternPatternpatternpattern kleiner als ImageImageImageImageimageimage.

Ausführungsinformationen

Parameter

ImageImageImageImageimageimage (input_object)  singlechannelimage(-array) → objectHImageHObjectHImageHobject (byte)

Eingabebild.

PatternPatternPatternPatternpatternpattern (input_object)  singlechannelimage(-array) → objectHImageHObjectHImageHobject (byte)

Vergleichsbild.

SelectedSelectedSelectedSelectedselectedselected (output_object)  region(-array) → objectHRegionHObjectHRegionHobject *

Punkte, in denen sich die Bilder ähneln/unterscheiden.

ModeModeModeModemodemode (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Modus: bestimme ähnliche oder verschiedene Pixel.

Defaultwert: 'diff_outside' "diff_outside" "diff_outside" "diff_outside" "diff_outside" "diff_outside"

Wertevorschläge: 'diff_inside'"diff_inside""diff_inside""diff_inside""diff_inside""diff_inside", 'diff_outside'"diff_outside""diff_outside""diff_outside""diff_outside""diff_outside"

DiffLowerBoundDiffLowerBoundDiffLowerBoundDiffLowerBounddiffLowerBounddiff_lower_bound (input_control)  number → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Untere Grenze der erlaubten Grauwertdifferenz.

Defaultwert: -5

Wertevorschläge: 0, -1, -2, -3, -5, -7, -10, -12, -15, -17, -20, -25, -30

Typischer Wertebereich: -255 ≤ DiffLowerBound DiffLowerBound DiffLowerBound DiffLowerBound diffLowerBound diff_lower_bound ≤ 255 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 2

DiffUpperBoundDiffUpperBoundDiffUpperBoundDiffUpperBounddiffUpperBounddiff_upper_bound (input_control)  number → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Obere Grenze der erlaubten Grauwertdifferenz.

Defaultwert: 5

Wertevorschläge: 0, 1, 2, 3, 5, 7, 10, 12, 15, 17, 20, 25, 30

Typischer Wertebereich: -255 ≤ DiffUpperBound DiffUpperBound DiffUpperBound DiffUpperBound diffUpperBound diff_upper_bound ≤ 255 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 2

GrayOffsetGrayOffsetGrayOffsetGrayOffsetgrayOffsetgray_offset (input_control)  number → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Korrekturgrauwert, der im Eingabebild abgezogen wird.

Defaultwert: 0

Wertevorschläge: -30, -25, -20, -17, -15, -12, -10, -7, -5, -3, -2, -1, 0, 1, 2, 3, 5, 7, 10, 12, 15, 17, 20, 25, 30

Typischer Wertebereich: -255 ≤ GrayOffset GrayOffset GrayOffset GrayOffset grayOffset gray_offset ≤ 255 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 2

AddRowAddRowAddRowAddRowaddRowadd_row (input_control)  point.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zeilenkoordinate, um die das Vergleichsbild verschoben wird.

Defaultwert: 0

Wertevorschläge: -200, -100, -20, -10, 0, 10, 20, 100, 200

Typischer Wertebereich: -32000 ≤ AddRow AddRow AddRow AddRow addRow add_row ≤ 32000 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

AddColAddColAddColAddColaddColadd_col (input_control)  point.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Spaltenkoordinate, um die das Vergleichsbild verschoben wird.

Defaultwert: 0

Wertevorschläge: -200, -100, -20, -10, 0, 10, 20, 100, 200

Typischer Wertebereich: -32000 ≤ AddCol AddCol AddCol AddCol addCol add_col ≤ 32000 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Komplexität

Sei die Anzahl der gültigen Pixel, dann ist die Laufzeitkomplexität: .

Ergebnis

check_differencecheck_differenceCheckDifferenceCheckDifferenceCheckDifferencecheck_difference liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Für das Verhalten bzgl. der Eingabebilder und Ausgaberegionen sind die Flags 'no_object_result'"no_object_result""no_object_result""no_object_result""no_object_result""no_object_result", 'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result""empty_region_result" und 'store_empty_region'"store_empty_region""store_empty_region""store_empty_region""store_empty_region""store_empty_region" einstellbar (siehe set_systemset_systemSetSystemSetSystemSetSystemset_system). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

connectionconnectionConnectionConnectionConnectionconnection, select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, select_grayselect_graySelectGraySelectGraySelectGrayselect_gray, rank_regionrank_regionRankRegionRankRegionRankRegionrank_region, dilation1dilation1Dilation1Dilation1Dilation1dilation1, openingopeningOpeningOpeningOpeningopening

Alternativen

sub_imagesub_imageSubImageSubImageSubImagesub_image, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThresholddyn_threshold

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 22.11.4.0 Copyright © 1996-2025 MVTec Software GmbH
Follow us on