random_regions ( : Regions : Type, WidthMin, WidthMax, HeightMin, HeightMax, PhiMin, PhiMax, NumRegions, Width, Height : )
Create random regions like circles, rectangles and ellipses.
The operator random_region generates circles, rectangles
and ellipses whose parameters are determined at random.
In each case only one lower or upper limit, respectively, is given.
The position is alway random and cannot be determined by parameters.
The parameter NumRegions indicates how many regions
shall be created.
Parameters
Regions (output_object)
|
region-array -> object
|
Created regions. |
Type (input_control)
|
string -> string
|
Type of regions to be created. |
Default value: 'circle' |
List of values: 'circle', 'ring', 'ellipse', 'rectangle1', 'rectangle2' |
WidthMin (input_control)
|
number -> real / integer
|
Minimum width of the region. |
Default value: 10.0 |
Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0 |
Range of values: 1.0 <= WidthMin <= 511.0 (lin) |
Minimum increment: 1.0
|
Recommended increment: 10.0
|
Restriction: WidthMin > 0 |
WidthMax (input_control)
|
number -> real / integer
|
Maximum width of the region. |
Default value: 20.0 |
Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0 |
Range of values: 1.0 <= WidthMax <= 511.0 (lin) |
Minimum increment: 1.0
|
Recommended increment: 10.0
|
Restriction: WidthMax > 0 |
HeightMin (input_control)
|
number -> real / integer
|
Minimum height of the region. |
Default value: 10.0 |
Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0 |
Range of values: 1.0 <= HeightMin <= 511.0 (lin) |
Minimum increment: 1.0
|
Recommended increment: 10.0
|
Restriction: HeightMin > 0 |
HeightMax (input_control)
|
number -> real / integer
|
Maximum height of the region. |
Default value: 30.0 |
Suggested values: 1.0, 3.0, 5.0, 10.0, 20.0, 40.0, 80.0 |
Range of values: 1.0 <= HeightMax <= 511.0 (lin) |
Minimum increment: 1.0
|
Recommended increment: 10.0
|
Restriction: HeightMax > 0 |
PhiMin (input_control)
|
number -> real / integer
|
Minimum rotation angle of the region. |
Default value: -0.7854 |
Suggested values: 0.0, 0.1, 0.3, 0.6, 0.9, 1.2, 1.5 |
Range of values: 0.0 <= PhiMin <= 6.28 (lin) |
Minimum increment: 0.001
|
Recommended increment: 0.10
|
Restriction: PhiMin > 0 |
PhiMax (input_control)
|
number -> real / integer
|
Maximum rotation angle of the region. |
Default value: 0.7854 |
Suggested values: 0.0, 0.1, 0.3, 0.6, 0.9, 1.2, 1.5 |
Range of values: 0.0 <= PhiMax <= 6.28 (lin) |
Minimum increment: 0.001
|
Recommended increment: 0.10
|
Restriction: PhiMax > 0 |
NumRegions (input_control)
|
integer -> integer
|
Number of regions. |
Default value: 100 |
Suggested values: 1, 5, 20, 100, 200, 500, 1000, 2000 |
Range of values: 1 <= NumRegions <= 2000 (lin) |
Minimum increment: 1
|
Recommended increment: 10
|
Restriction: NumRegions > 0 |
Width (input_control)
|
integer -> integer
|
Maximum horizontal expansion. |
Default value: 512 |
Suggested values: 128, 256, 512, 1024 |
Range of values: 1 <= Width <= 1024 (lin) |
Minimum increment: 1
|
Recommended increment: 10
|
Restriction: Width > 0 |
Height (input_control)
|
integer -> integer
|
Maximum vertical expansion. |
Default value: 512 |
Suggested values: 128, 256, 512, 1024 |
Range of values: 1 <= Height <= 1024 (lin) |
Minimum increment: 1
|
Recommended increment: 10
|
Restriction: Height > 0 |
Result
If the parameter values are correct random_regions returns
the value TRUE.
Otherwise an exception is raised.
The clipping of the current image format is determined by the operator
set_system(::'clip_region',<true/false>:).
Possible Successors
paint_region__
Copyright © 1996-1997 MVTec Software GmbH