clip_region_relclip_region_relClipRegionRelclip_region_relClipRegionRelClipRegionRel (Operator)

Name

clip_region_relclip_region_relClipRegionRelclip_region_relClipRegionRelClipRegionRel — 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_relClipRegionRelclip_region_relClipRegionRelClipRegionRel 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 RegionClippedRegionClippedRegionClippedRegionClippedRegionClippedregionClipped 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 RegionClippedRegionClippedRegionClippedRegionClippedRegionClippedregionClipped identisch mit der Eingaberegion.

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.

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_relClipRegionRelclip_region_relClipRegionRelClipRegionRel 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

smallest_rectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1, intersectionintersectionIntersectionintersectionIntersectionIntersection, gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1, clip_regionclip_regionClipRegionclip_regionClipRegionClipRegion

Modul

Foundation