clip_regionclip_regionClipRegionclip_regionClipRegionClipRegion (Operator)

Name

clip_regionclip_regionClipRegionclip_regionClipRegionClipRegion — Reduzieren der Region auf ein Rechteck.

Signatur

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

Beschreibung

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

Parallelisierung

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) → object

Zu transformierende Regionen.

RegionClippedRegionClippedRegionClippedRegionClippedRegionClippedregionClipped (output_object) region(-array) → object

Beschnittene Regionen.

Row1Row1Row1Row1Row1row1 (input_control) rectangle.origin.y → (integer)

Zeilen-Koordinate linkes oberes Eck des Rechtecks.

Defaultwert: 0

Wertevorschläge: 0, 128, 200, 256

Typischer Wertebereich: Row1 Row1 Row1 Row1 Row1 row1 (lin)

Column1Column1Column1Column1Column1column1 (input_control) rectangle.origin.x → (integer)

Spalten-Koordinate linkes oberes Eck.

Defaultwert: 0

Wertevorschläge: 0, 128, 200, 256

Typischer Wertebereich: Column1 Column1 Column1 Column1 Column1 column1 (lin)

Row2Row2Row2Row2Row2row2 (input_control) rectangle.corner.y → (integer)

Zeilen-Koordinate rechtes unteres Eck des Rechtecks.

Defaultwert: 256

Wertevorschläge: 128, 200, 256, 512

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Column2Column2Column2Column2Column2column2 (input_control) rectangle.corner.x → (integer)

Spalten-Koordinate rechtes unteres Eck.

Defaultwert: 256

Wertevorschläge: 128, 200, 256, 512

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Ergebnis

clip_regionclip_regionClipRegionclip_regionClipRegionClipRegion 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>)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, connectionconnectionConnectionconnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, pouringpouringPouringpouringPouringPouring

Nachfolger

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Alternativen

intersectionintersectionIntersectionintersectionIntersectionIntersection, gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1, clip_region_relclip_region_relClipRegionRelclip_region_relClipRegionRelClipRegionRel

Modul

Foundation