clip_region_rel
— Beschneiden der Region relativ zu ihrem kleinsten umschließenden Rechteck.
clip_region_rel
verkleinert die Region
dadurch, dass
Bereiche weggeschnitten werden, die nahe am kleinsten umschließenden
Rechteck der Region
liegen. Konkret bedeutet das, dass der
Durchschnitt der Region
mit einem Rechteck gebildet wird,
welches kleiner als oder gleich groß wie das kleinste umschließende
Rechteck ist. Die resultierende verkleinerte Region wird in
RegionClipped
zurückgegeben.
Das Rechteck, mit dem die Region
geschnitten wird, wird
dadurch bestimmt, dass das kleinste umschließende achsenparallele
Rechteck oben, unten, links und rechts jeweils um die Werte
Top
, Bottom
, Left
und Right
verkleinert wird.
(1) | (2) |
Diese vier Werte müssen größer oder gleich Null sein. Werden alle vier
Werte auf Null gesetzt, so ist RegionClipped
identisch mit
der Eingaberegion.
Region
(input_object) region(-array) →
object
Zu transformierende Regionen.
RegionClipped
(output_object) region(-array) →
object
Beschnittene Regionen.
Top
(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
(lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Bottom
(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
(lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Left
(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
(lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Right
(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
(lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
clip_region_rel
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>)
,
das bei leerer Region mit
set_system('empty_region_result',<Result>)
festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
threshold
,
connection
,
regiongrowing
,
pouring
smallest_rectangle1
,
intersection
,
gen_rectangle1
,
clip_region
Foundation