region_to_binregion_to_binRegionToBinRegionToBinregion_to_bin (Operator)

Name

region_to_binregion_to_binRegionToBinRegionToBinregion_to_bin — Umwandeln von Regionen in ein binäres byte-Bild.

Signatur

region_to_bin(Region : BinImage : ForegroundGray, BackgroundGray, Width, Height : )

Beschreibung

region_to_binregion_to_binRegionToBinRegionToBinRegionToBinregion_to_bin erzeugt ein byte-Bild und stellt darin die Eingaberegionen mit dem durch den Eingabe-Steuerparameter ForegroundGrayForegroundGrayForegroundGrayForegroundGrayforegroundGrayforeground_gray vorgegebenen Grauwert dar. Regionen, die über die Größe des angegebenen Bildes hinausgehen, werden entsprechend beschnitten. Der Hintergrund wird auf BackgroundGrayBackgroundGrayBackgroundGrayBackgroundGraybackgroundGraybackground_gray gesetzt.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

RegionRegionRegionRegionregionregion (input_object) region(-array) → object

Enthält die darzustellenden Regionen.

BinImageBinImageBinImageBinImagebinImagebin_image (output_object) image → object (byte)

Ergebnisbild der Größe Width * Height mit eingetragenen Regionen.

ForegroundGrayForegroundGrayForegroundGrayForegroundGrayforegroundGrayforeground_gray (input_control) integer → (integer)

Grauwert für die Darstellung der Regionen.

Defaultwert: 255

Wertevorschläge: 0, 1, 50, 100, 128, 150, 200, 254, 255

Typischer Wertebereich: 0 ≤ ForegroundGray ForegroundGray ForegroundGray ForegroundGray foregroundGray foreground_gray ≤ 255 (lin)

Empfohlene Schrittweite: 1

BackgroundGrayBackgroundGrayBackgroundGrayBackgroundGraybackgroundGraybackground_gray (input_control) integer → (integer)

Grauwert für die Darstellung des Hintergrunds.

Defaultwert: 0

Wertevorschläge: 0, 1, 50, 100, 128, 150, 200, 254, 255

Typischer Wertebereich: 0 ≤ BackgroundGray BackgroundGray BackgroundGray BackgroundGray backgroundGray background_gray ≤ 255 (lin)

Empfohlene Schrittweite: 1

WidthWidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Breite des zu erstellenden Bildes.

Defaultwert: 512

Wertevorschläge: 256, 512, 1024

Typischer Wertebereich: 1 ≤ Width Width Width Width width width ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 16

Restriktion: Width >= 1

HeightHeightHeightHeightheightheight (input_control) extent.y → (integer)

Höhe des zu erstellenden Bildes.

Defaultwert: 512

Wertevorschläge: 256, 512, 1024

Typischer Wertebereich: 1 ≤ Height Height Height Height height height ≤ 1024 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 16

Restriktion: Height >= 1

Komplexität

O(2*HeightHeightHeightHeightheightheight*WidthWidthWidthWidthwidthwidth).

Ergebnis

region_to_binregion_to_binRegionToBinRegionToBinRegionToBinregion_to_bin liefert normalerweise den Wert 2 (H_MSG_TRUE). 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

get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval

Alternativen

region_to_labelregion_to_labelRegionToLabelRegionToLabelRegionToLabelregion_to_label, paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region, set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval

Siehe auch

gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray

Modul

Foundation

Operatoren