clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel (Operator)

Name

clip_region_relclip_region_relClipRegionRelClipRegionRelclip_region_rel — Beschneiden der Region relativ zu ihrem kleinsten umschließenden Rechteck.

Signatur

clip_region_rel(Region : RegionClipped : Top, Bottom, Left, Right : )

Beschreibung

clip_region_relclip_region_relClipRegionRelClipRegionRelClipRegionRelclip_region_rel verkleinert die RegionRegionRegionRegionregionregion dadurch, dass Bereiche weggeschnitten werden, die nahe am kleinsten umschließenden Rechteck der RegionRegionRegionRegionregionregion liegen. Konkret bedeutet das, dass der Durchschnitt der RegionRegionRegionRegionregionregion mit einem Rechteck gebildet wird, welches kleiner als oder gleich groß wie das kleinste umschließende Rechteck ist. Die resultierende verkleinerte Region wird in RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped zurückgegeben.

Das Rechteck, mit dem die RegionRegionRegionRegionregionregion geschnitten wird, wird dadurch bestimmt, dass das kleinste umschließende achsenparallele Rechteck oben, unten, links und rechts jeweils um die Werte TopTopTopToptoptop, BottomBottomBottomBottombottombottom, LeftLeftLeftLeftleftleft und RightRightRightRightrightright verkleinert wird.


(1)	(2)

Region mit kleinstem umschließenden Rechteck (1) und geschnittene Region (2).

Diese vier Werte müssen größer oder gleich Null sein. Werden alle vier Werte auf Null gesetzt, so ist RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped identisch mit der Eingaberegion.

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

Zu transformierende Regionen.

RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped (output_object) region(-array) → object

Beschnittene Regionen.

TopTopTopToptoptop (input_control) integer → (integer)

Anzahl Zeilen die „oben“ abgeschnitten werden.

Defaultwert: 1

Wertevorschläge: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Typischer Wertebereich: 0 ≤ Top Top Top Top top top (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

BottomBottomBottomBottombottombottom (input_control) integer → (integer)

Anzahl Zeilen die „unten“ abgeschnitten werden.

Defaultwert: 1

Wertevorschläge: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Typischer Wertebereich: 0 ≤ Bottom Bottom Bottom Bottom bottom bottom (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

LeftLeftLeftLeftleftleft (input_control) integer → (integer)

Anzahl Spalten die „links“ abgeschnitten werden.

Defaultwert: 1

Wertevorschläge: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Typischer Wertebereich: 0 ≤ Left Left Left Left left left (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

RightRightRightRightrightright (input_control) integer → (integer)

Anzahl Zeilen die „rechts“ abgeschnitten werden.

Defaultwert: 1

Wertevorschläge: 0, 1, 2, 3, 4, 5, 7, 10, 20, 30, 50

Typischer Wertebereich: 0 ≤ Right Right Right Right right right (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Ergebnis

clip_region_relclip_region_relClipRegionRelClipRegionRelClipRegionRelclip_region_rel liefert den Wert 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

smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1, intersectionintersectionIntersectionIntersectionIntersectionintersection, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1, clip_regionclip_regionClipRegionClipRegionClipRegionclip_region

Modul

Foundation

Operatoren