gen_random_regiongen_random_regionGenRandomRegionGenRandomRegiongen_random_region (Operator)

Name

gen_random_regiongen_random_regionGenRandomRegionGenRandomRegiongen_random_region — Erzeugen einer Zufallsregion.

Signatur

gen_random_region( : RegionRandom : Width, Height : )

Herror gen_random_region(Hobject* RegionRandom, const Hlong Width, const Hlong Height)

Herror T_gen_random_region(Hobject* RegionRandom, const Htuple Width, const Htuple Height)

void GenRandomRegion(HObject* RegionRandom, const HTuple& Width, const HTuple& Height)

void HRegion::GenRandomRegion(Hlong Width, Hlong Height)

static void HOperatorSet.GenRandomRegion(out HObject regionRandom, HTuple width, HTuple height)

void HRegion.GenRandomRegion(int width, int height)

def gen_random_region(width: int, height: int) -> HObject

Beschreibung

gen_random_regiongen_random_regionGenRandomRegionGenRandomRegionGenRandomRegiongen_random_region liefert eine Zufallsregion. Dabei wird im Bildbereich [0...Width-1][0...Height-1] jeder Punkt mit Wahrscheinlichkeit 0.5 in die Region aufgenommen. Man kann sich die erzeugte Region als die Schwellenwertbildung in einem Bild mit Rauschen vorstellen.

Diese Prozedur ist insbesondere wichtig für die Erzeugung von unkorrelierten Binärmustern. Das Zufallsmuster wird mit der C-Funktion „nrand48()“ erzeugt.

Achtung

Wenn WidthWidthWidthWidthwidthwidth und HeightHeightHeightHeightheightheight groß gewählt werden (> 100), dann kann die erzeugte Region durch die intern verwendete Lauflängenkodierung viel Speicherplatz benötigen. Die Grauwerte der Ausgaberegion sind undefiniert.

Ausführungsinformationen

Parameter

RegionRandomRegionRandomRegionRandomRegionRandomregionRandomregion_random (output_object)  region objectHRegionHObjectHRegionHobject *

Erzeugte Zufallsregion mit Ausdehnung WidthWidthWidthWidthwidthwidth x HeightHeightHeightHeightheightheight.

WidthWidthWidthWidthwidthwidth (input_control)  extent.x HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximale horizontale Ausdehnung der Zufallsregion.

Defaultwert: 128

Wertevorschläge: 16, 32, 50, 64, 100, 128, 256, 300, 400, 512

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: Width > 0

HeightHeightHeightHeightheightheight (input_control)  extent.y HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Maximale vertikale Ausdehnung der Zufallsregion.

Defaultwert: 128

Wertevorschläge: 16, 32, 50, 64, 100, 128, 256, 300, 400, 512

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

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: Height > 0

Komplexität

Der schlimmste Fall für die Speicherplatzkomplexität für die erzeugte Region (in Byte) ist: O(Width * Height * 2).

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_random_regiongen_random_regionGenRandomRegionGenRandomRegionGenRandomRegiongen_random_region den Wert TRUE. Andernfalls wird eine Fehlerbehandlung durchgeführt. Das Clipping am aktuellen Bildformat wird durch set_system('clip_region',<'2 (H_MSG_TRUE)'/'3 (H_MSG_FALSE)'>)set_system("clip_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("clip_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("clip_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("clip_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)set_system("clip_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">) festgelegt.

Nachfolger

paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain

Siehe auch

gen_checker_regiongen_checker_regionGenCheckerRegionGenCheckerRegionGenCheckerRegiongen_checker_region, add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistributionadd_noise_distribution, add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteAddNoiseWhiteadd_noise_white, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain

Modul

Foundation