HALCON Website / HALCON Operator-Referenz / Bild / Generierung
KlassenKlassenKlassenKlassen | | | | Operatoren

region_to_labelregion_to_labelRegionToLabelregion_to_labelRegionToLabelRegionToLabel (Operator)

Name

region_to_labelregion_to_labelRegionToLabelregion_to_labelRegionToLabelRegionToLabel — Eintragen von Regionen in ein (Label-)Bild.

Signatur

region_to_label(Region : ImageLabel : Type, Width, Height : )

Herror region_to_label(const Hobject Region, Hobject* ImageLabel, const char* Type, const Hlong Width, const Hlong Height)

Herror T_region_to_label(const Hobject Region, Hobject* ImageLabel, const Htuple Type, const Htuple Width, const Htuple Height)

Herror region_to_label(Hobject Region, Hobject* ImageLabel, const HTuple& Type, const HTuple& Width, const HTuple& Height)

HImage HRegion::RegionToLabel(const HTuple& Type, const HTuple& Width, const HTuple& Height) const

HImage HRegionArray::RegionToLabel(const HTuple& Type, const HTuple& Width, const HTuple& Height) const

void RegionToLabel(const HObject& Region, HObject* ImageLabel, const HTuple& Type, const HTuple& Width, const HTuple& Height)

HImage HRegion::RegionToLabel(const HString& Type, Hlong Width, Hlong Height) const

HImage HRegion::RegionToLabel(const char* Type, Hlong Width, Hlong Height) const

void HOperatorSetX.RegionToLabel(
[in] IHUntypedObjectX* Region, [out] IHUntypedObjectX** ImageLabel, [in] VARIANT Type, [in] VARIANT Width, [in] VARIANT Height)

IHImageX* HRegionX.RegionToLabel(
[in] BSTR Type, [in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.RegionToLabel(HObject region, out HObject imageLabel, HTuple type, HTuple width, HTuple height)

HImage HRegion.RegionToLabel(string type, int width, int height)

Beschreibung

region_to_labelregion_to_labelRegionToLabelregion_to_labelRegionToLabelRegionToLabel trägt die Regionen mit ihrem Index (1..n) in eine Bildmatrix ein. Die erste Region erhält den „Grauwert“ 1, die zweite den „Grauwert“ 2 usw. Es werden also nur positive Zahlen verwendet. Bei 'byte'"byte""byte""byte""byte""byte"-Bildern wird der Index modulo 256 genommen.

Regionen, die über die Größe des angegebenen Bildes hinausgehen, werden entsprechend beschnitten. Falls sich Regionen überlappen, so gibt die Reihenfolge vor, welche Region in dem Bild eingetragen wird: Es wird in der Reihenfolge der Regionen in die Matrix gezeichnet. Die zuletzt gezeichnete Region bleibt folglich im Ergebnisbild markiert. Die Regionen können gegebenenfalls mit expand_regionexpand_regionExpandRegionexpand_regionExpandRegionExpandRegion aufbereitet werden.

Der Hintergrund (keine Regionenpunkte) wird auf 0 gesetzt. Hiermit kann getestet werden, in welchen Bildbereichen keine Regionen vorhanden sind.

Parallelisierung

Parameter

RegionRegionRegionRegionRegionregion (input_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject

Enthält die einzutragenden Regionen.

ImageLabelImageLabelImageLabelImageLabelImageLabelimageLabel (output_object)  image → objectHImageHImageHImageHImageXHobject * (byte / int2 / int4)

Ergebnisbild der Größe Width * Height mit eingetragenen Regionen.

TypeTypeTypeTypeTypetype (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Pixeltyp

Defaultwert: 'int2' "int2" "int2" "int2" "int2" "int2"

Werteliste: 'byte'"byte""byte""byte""byte""byte", 'int2'"int2""int2""int2""int2""int2", 'int4'"int4""int4""int4""int4""int4", 'int8'"int8""int8""int8""int8""int8"

WidthWidthWidthWidthWidthwidth (input_control)  extent.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Breite des zu erstellenden Bildes.

Defaultwert: 512

Wertevorschläge: 64, 128, 256, 512, 1024

Typischer Wertebereich: 1 ≤ Width Width Width Width Width width ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 16

Restriktion: Width >= 1

HeightHeightHeightHeightHeightheight (input_control)  extent.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Höhe des zu erstellenden Bildes.

Defaultwert: 512

Wertevorschläge: 64, 128, 256, 512, 1024

Typischer Wertebereich: 1 ≤ Height Height Height Height Height height ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 16

Restriktion: Height >= 1

Komplexität

O(2*HeightHeightHeightHeightHeightheight*WidthWidthWidthWidthWidthwidth).

Ergebnis

region_to_labelregion_to_labelRegionToLabelregion_to_labelRegionToLabelRegionToLabel liefert normalerweise den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>), das bei leerer Region mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection, expand_regionexpand_regionExpandRegionexpand_regionExpandRegionExpandRegion

Nachfolger

get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval, get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1

Alternativen

region_to_binregion_to_binRegionToBinregion_to_binRegionToBinRegionToBin, paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion

Siehe auch

label_to_regionlabel_to_regionLabelToRegionlabel_to_regionLabelToRegionLabelToRegion

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH