gen_random_regions — Erzeugen zufälliger Regionen wie Kreise, Rechtecke und Ellipsen.
gen_random_regions( : Regions : Type, WidthMin, WidthMax, HeightMin, HeightMax, PhiMin, PhiMax, NumRegions, Width, Height : )
gen_random_regions erzeugt Regionen, deren Parameter
innerhalb der gegebenen Grenzwerte zufällig erzeugt werden, und gibt diese
in Regions zurück.
Der Parameter NumRegions gibt an wie viele Regionen
erzeugt werden sollen.
Die Position ist immer zufällig und kann nicht über Parameter bestimmt werden, die Schwerpunkte liegen jedoch stets im Bildbereich [0...Width-1][0...Height-1].
Der Parameter Type definiert die Art der Regionen.
Die Bedeutung der Unter- bzw. Obergrenzen ist von Type abhängig:
'rectangle1': Minimale/maximale Breite/Höhe.
'rectangle2': Minimale/maximale halbe Kantenlängen,
minimaler/maximaler Orientierungswinkel.
Dabei wird der größere Wert für die erste halbe Kantenlänge verwendet.
Die Parameter entsprechen den Parametern Length1,
Lenght2 und Phi von gen_rectangle2.
'circle': WidthMin und WidthMax bestimmen
die minimalen und maximalen Radien.
Der Parameter entspricht dem Parameter Radius von
gen_circle.
HeightMin und HeightMax sowie
PhiMin und PhiMax sind ohne Bedeutung.
'ellipse': Minimale/maximale Halbradien und
minimaler/maximaler Orientierungswinkel.
Dabei wird der größere Wert für den ersten Halbradius verwendet.
Die Parameter entsprechen den Parametern Radius1,
Radius2 und Phi von gen_ellipse.
'ring': Minimale/maximale Radien, wobei der größere Wert den Radius des Außenkreises bestimmt und der kleinere Wert den des Lochs.
Regions (output_object) region-array → object
Erzeugte Regionen.
Type (input_control) string → (string)
Art der zu erzeugenden Regionen.
Defaultwert: 'circle'
Werteliste: 'circle', 'ellipse', 'rectangle1', 'rectangle2', 'ring'
WidthMin (input_control) number → (real / integer)
Minimale typ- und wertabhängige Objektgröße.
Defaultwert: 10.0
Wertevorschläge: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0
Typischer Wertebereich: 0
≤
WidthMin
(lin)
Minimale Schrittweite: 1.0
Empfohlene Schrittweite: 10.0
WidthMax (input_control) number → (real / integer)
Maximale typ- und wertabhängige Objektgröße.
Defaultwert: 20.0
Wertevorschläge: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0
Typischer Wertebereich:
WidthMax
(lin)
Minimale Schrittweite: 1.0
Empfohlene Schrittweite: 10.0
Restriktion: WidthMin <= WidthMax
HeightMin (input_control) number → (real / integer)
Minimale typ- und wertabhängige Objektgröße.
Defaultwert: 10.0
Wertevorschläge: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0
Typischer Wertebereich: 0
≤
HeightMin
(lin)
Minimale Schrittweite: 1.0
Empfohlene Schrittweite: 10.0
HeightMax (input_control) number → (real / integer)
Maximale typ- und wertabhängige Objektgröße.
Defaultwert: 30.0
Wertevorschläge: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0
Typischer Wertebereich:
HeightMax
(lin)
Minimale Schrittweite: 1.0
Empfohlene Schrittweite: 10.0
Restriktion: HeightMin <= HeightMax
PhiMin (input_control) number → (real / integer)
Minimaler Rotationswinkel der Regionen.
Defaultwert: -0.7854
Wertevorschläge: 0.0, 0.1, 0.3, 0.6, 0.9, 1.2, 1.5
Typischer Wertebereich: 0.0
≤
PhiMin
≤
6.28 (lin)
Restriktion: PhiMin > 0
PhiMax (input_control) number → (real / integer)
Maximaler Rotationswinkel der Regionen.
Defaultwert: 0.7854
Wertevorschläge: 0.0, 0.1, 0.3, 0.6, 0.9, 1.2, 1.5
Typischer Wertebereich: 0.0
≤
PhiMax
≤
6.28 (lin)
Restriktion: PhiMax > 0
NumRegions (input_control) integer → (integer)
Anzahl der Regionen.
Defaultwert: 100
Wertevorschläge: 1, 5, 20, 100, 200, 500, 1000, 2000
Typischer Wertebereich: 1
≤
NumRegions
(lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 10
Width (input_control) integer → (integer)
Maximale horizontale Ausdehnung der Schwerpunkte.
Defaultwert: 512
Wertevorschläge: 128, 256, 512, 1024
Typischer Wertebereich: 1
≤
Width
(lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 10
Height (input_control) integer → (integer)
Maximale vertikale Ausdehnung der Schwerpunkte.
Defaultwert: 512
Wertevorschläge: 128, 256, 512, 1024
Typischer Wertebereich: 1
≤
Height
(lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 10
Sind die Parameterwerte korrekt, dann liefert gen_random_regions
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'>) festgelegt.
Foundation