gen_random_regiongen_random_regionGenRandomRegionGenRandomRegion (Operator)

Name

gen_random_regiongen_random_regionGenRandomRegionGenRandomRegion — 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)

Beschreibung

gen_random_regiongen_random_regionGenRandomRegionGenRandomRegionGenRandomRegion 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 WidthWidthWidthWidthwidth und HeightHeightHeightHeightheight 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

RegionRandomRegionRandomRegionRandomRegionRandomregionRandom (output_object)  region objectHRegionHRegionHobject *

Erzeugte Zufallsregion mit Ausdehnung WidthWidthWidthWidthwidth x HeightHeightHeightHeightheight.

WidthWidthWidthWidthwidth (input_control)  extent.x HTupleHTupleHtuple (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 ≤ 512 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: Width > 0

HeightHeightHeightHeightheight (input_control)  extent.y HTupleHTupleHtuple (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 ≤ 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_regionGenRandomRegionGenRandomRegionGenRandomRegion den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt. Das Clipping am aktuellen Bildformat wird durch set_system('clip_region',<'true'/'false'>)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">) festgelegt.

Nachfolger

paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Siehe auch

gen_checker_regiongen_checker_regionGenCheckerRegionGenCheckerRegionGenCheckerRegion, add_noise_distributionadd_noise_distributionAddNoiseDistributionAddNoiseDistributionAddNoiseDistribution, add_noise_whiteadd_noise_whiteAddNoiseWhiteAddNoiseWhiteAddNoiseWhite, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Modul

Foundation