HALCON Website / HALCON Operator-Referenz / Regionen / Transformationen
KlassenKlassen | | Operatoren

clip_regionclip_regionClipRegionClipRegion (Operator)

Name

clip_regionclip_regionClipRegionClipRegion — Reduzieren der Region auf ein Rechteck.

Signatur

clip_region(Region : RegionClipped : Row1, Column1, Row2, Column2 : )

Herror clip_region(const Hobject Region, Hobject* RegionClipped, const Hlong Row1, const Hlong Column1, const Hlong Row2, const Hlong Column2)

Herror T_clip_region(const Hobject Region, Hobject* RegionClipped, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2)

void ClipRegion(const HObject& Region, HObject* RegionClipped, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)

HRegion HRegion::ClipRegion(Hlong Row1, Hlong Column1, Hlong Row2, Hlong Column2) const

static void HOperatorSet.ClipRegion(HObject region, out HObject regionClipped, HTuple row1, HTuple column1, HTuple row2, HTuple column2)

HRegion HRegion.ClipRegion(int row1, int column1, int row2, int column2)

Beschreibung

clip_regionclip_regionClipRegionClipRegionClipRegion bildet den Durchschnitt aller Regionen in der Eingabe mit dem Rechteck das durch die vier Steuerparameter festgelegt wird. Dabei ist clip_regionclip_regionClipRegionClipRegionClipRegion effizienter als intersectionintersectionIntersectionIntersectionIntersection mit einem Rechteck das als Region (gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1) dargestellt ist.

Ausführungsinformationen

Parameter

RegionRegionRegionRegionregion (input_object)  region(-array) → objectHRegionHRegionHobject

Zu transformierende Regionen.

RegionClippedRegionClippedRegionClippedRegionClippedregionClipped (output_object)  region(-array) → objectHRegionHRegionHobject *

Beschnittene Regionen.

Row1Row1Row1Row1row1 (input_control)  rectangle.origin.y → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zeilen-Koordinate linkes oberes Eck des Rechtecks.

Defaultwert: 0

Wertevorschläge: 0, 128, 200, 256

Typischer Wertebereich: Row1 Row1 Row1 Row1 row1 (lin)

Column1Column1Column1Column1column1 (input_control)  rectangle.origin.x → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Spalten-Koordinate linkes oberes Eck.

Defaultwert: 0

Wertevorschläge: 0, 128, 200, 256

Typischer Wertebereich: Column1 Column1 Column1 Column1 column1 (lin)

Row2Row2Row2Row2row2 (input_control)  rectangle.corner.y → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zeilen-Koordinate rechtes unteres Eck des Rechtecks.

Defaultwert: 256

Wertevorschläge: 128, 200, 256, 512

Typischer Wertebereich: 0 ≤ Row2 Row2 Row2 Row2 row2 ≤ 511 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Column2Column2Column2Column2column2 (input_control)  rectangle.corner.x → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Spalten-Koordinate rechtes unteres Eck.

Defaultwert: 256

Wertevorschläge: 128, 200, 256, 512

Typischer Wertebereich: 0 ≤ Column2 Column2 Column2 Column2 column2 ≤ 511 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Ergebnis

clip_regionclip_regionClipRegionClipRegionClipRegion liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. 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>)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>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, pouringpouringPouringPouringPouring

Nachfolger

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, disp_regiondisp_regionDispRegionDispRegionDispRegion

Alternativen

intersectionintersectionIntersectionIntersectionIntersection, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1, clip_region_relclip_region_relClipRegionRelClipRegionRelClipRegionRel

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.05.0.0 Copyright © 1996-2019 MVTec Software GmbH