clip_regionclip_regionClipRegionClipRegionclip_region (Operator)
Name
clip_regionclip_regionClipRegionClipRegionclip_region — Reduzieren der Region auf ein Rechteck.
Signatur
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)
Beschreibung
clip_regionclip_regionClipRegionClipRegionClipRegionclip_region bildet den Durchschnitt aller Regionen in
der Eingabe mit dem Rechteck das durch die vier Steuerparameter
festgelegt wird. Dabei ist clip_regionclip_regionClipRegionClipRegionClipRegionclip_region effizienter als
intersectionintersectionIntersectionIntersectionIntersectionintersection mit einem Rechteck das als Region
(gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1) dargestellt ist.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Automatisch parallelisiert auf Tupelebene.
Parameter
RegionRegionRegionRegionregionregion (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Zu transformierende Regionen.
RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped (output_object) region(-array) → objectHRegionHObjectHRegionHobject *
Beschnittene Regionen.
Row1Row1Row1Row1row1row_1 (input_control) rectangle.origin.y → HTupleintHTupleHtuple (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
row_1
(lin)
Column1Column1Column1Column1column1column_1 (input_control) rectangle.origin.x → HTupleintHTupleHtuple (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
column_1
(lin)
Row2Row2Row2Row2row2row_2 (input_control) rectangle.corner.y → HTupleintHTupleHtuple (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
row_2
≤
511 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 10
Column2Column2Column2Column2column2column_2 (input_control) rectangle.corner.x → HTupleintHTupleHtuple (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
column_2
≤
511 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 10
Ergebnis
clip_regionclip_regionClipRegionClipRegionClipRegionclip_region 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>)set_system("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>)set_system("empty_region_result",<Result>) festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
thresholdthresholdThresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionConnectionconnection,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
pouringpouringPouringPouringPouringpouring
Nachfolger
select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape,
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region
Alternativen
intersectionintersectionIntersectionIntersectionIntersectionintersection,
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1,
clip_region_relclip_region_relClipRegionRelClipRegionRelClipRegionRelclip_region_rel
Modul
Foundation