crop_domain_relcrop_domain_relCropDomainRelCropDomainRel (Operator)

Name

crop_domain_relcrop_domain_relCropDomainRelCropDomainRel — Ausschneiden eines Bildausschnittes um den Definitionsbereich.

Signatur

crop_domain_rel(Image : ImagePart : Top, Left, Bottom, Right : )

Beschreibung

crop_domain_relcrop_domain_relCropDomainRelCropDomainRelCropDomainRel schneidet aus den Eingabebildern einen rechteckigen Ausschnitt aus. Der Ausschnitt wird durch das umschließende Rechteck des Definitionsbereiches bestimmt. Das Rechteck kann durch die Steuerparameter oben (TopTopTopToptop), links (LeftLeftLeftLeftleft), unten (BottomBottomBottomBottombottom) oder rechts (RightRightRightRightright) verändert werden. Positive Werte bewirken eine Verkleinerung, negative Zahlen bewirken eine Vergrößerung. Sind alle Parameter gleich Null, dann bleibt das Rechteck unverändert.

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.
Automatisch parallelisiert auf Kanalebene.

Parameter

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Eingabebild.

ImagePartImagePartImagePartImagePartimagePart (output_object) (multichannel-)image(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Bildauschnitt.

TopTopTopToptop (input_control) integer → (integer)

Anzahl Zeilen die „oben“ abgeschnitten werden.

Defaultwert: -1

Wertevorschläge: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

LeftLeftLeftLeftleft (input_control) integer → (integer)

Anzahl Spalten die „links“ abgeschnitten werden.

Defaultwert: -1

Wertevorschläge: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

BottomBottomBottomBottombottom (input_control) integer → (integer)

Anzahl Zeilen die „unten“ abgeschnitten werden.

Defaultwert: -1

Wertevorschläge: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

RightRightRightRightright (input_control) integer → (integer)

Anzahl Zeilen die „rechts“ abgeschnitten werden.

Defaultwert: -1

Wertevorschläge: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20

Ergebnis

crop_domain_relcrop_domain_relCropDomainRelCropDomainRelCropDomainRel 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>), 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>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, pouringpouringPouringPouringPouring

Alternativen

crop_domaincrop_domainCropDomainCropDomainCropDomain, crop_rectangle1crop_rectangle1CropRectangle1CropRectangle1CropRectangle1

Siehe auch

smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1, intersectionintersectionIntersectionIntersectionIntersection, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1, clip_regionclip_regionClipRegionClipRegionClipRegion

Modul

Foundation