crop_domain_relcrop_domain_relCropDomainRelCropDomainRelcrop_domain_rel (Operator)
Name
crop_domain_relcrop_domain_relCropDomainRelCropDomainRelcrop_domain_rel — Ausschneiden eines Bildausschnittes um den Definitionsbereich.
Signatur
Herror crop_domain_rel(const Hobject Image, Hobject* ImagePart, const Hlong Top, const Hlong Left, const Hlong Bottom, const Hlong Right)
Herror T_crop_domain_rel(const Hobject Image, Hobject* ImagePart, const Htuple Top, const Htuple Left, const Htuple Bottom, const Htuple Right)
Beschreibung
crop_domain_relcrop_domain_relCropDomainRelCropDomainRelCropDomainRelcrop_domain_rel 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 (TopTopTopToptoptop), links
(LeftLeftLeftLeftleftleft), unten (BottomBottomBottomBottombottombottom) oder rechts
(RightRightRightRightrightright) 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
ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)
Eingabebild.
ImagePartImagePartImagePartImagePartimagePartimage_part (output_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)
Bildausschnitt.
TopTopTopToptoptop (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl Zeilen die „oben“ abgeschnitten werden.
Defaultwert: -1
Wertevorschläge: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
LeftLeftLeftLeftleftleft (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl Spalten die „links“ abgeschnitten werden.
Defaultwert: -1
Wertevorschläge: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
BottomBottomBottomBottombottombottom (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl Zeilen die „unten“ abgeschnitten werden.
Defaultwert: -1
Wertevorschläge: -20, -10, -5, -3, -2, -1, 0, 1, 2, 3, 4, 5, 10, 20
RightRightRightRightrightright (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
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_relCropDomainRelCropDomainRelCropDomainRelcrop_domain_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
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain,
thresholdthresholdThresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionConnectionconnection,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
pouringpouringPouringPouringPouringpouring
Alternativen
crop_domaincrop_domainCropDomainCropDomainCropDomaincrop_domain,
crop_rectangle1crop_rectangle1CropRectangle1CropRectangle1CropRectangle1crop_rectangle1
Siehe auch
smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1,
intersectionintersectionIntersectionIntersectionIntersectionintersection,
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1,
clip_regionclip_regionClipRegionClipRegionClipRegionclip_region
Modul
Foundation