Create a random region.
The operator ::gen_random_region returns a random region. During this process every pixel in the image area [0...Width-1][0...Height-1] is adapted into the region with the probability 0.5. The created region can be imagined as the threshold formation in an image with noise.
This procedure is particularly important for the creation of uncorrelated binary patterns. The random pattern is created by the C function ``nrand48()''.
If Width and Height are chosen large (> 100) the created region may require much storage space due to the internally used runlength coding. The gray values of the output region are undefined.
|
RegionRandom (output_object) |
region -> Hobject * : HRegion |
| Created random region with expansion Width x Height. | |
|
Width (input_control) |
extent.x -> HTuple.long |
| Maximum horizontal expansion of random region. | |
| Default value: 128 | |
| Suggested values: 16, 32, 50, 64, 100, 128, 256, 300, 400, 512 | |
| Typical range of values: 1 <= Width <= 512 (lin) | |
| Minimum increment: 1 | |
|
Recommended increment: 10 | |
| Restriction: Width > 0 | |
|
Height (input_control) |
extent.y -> HTuple.long |
| Maximum vertical expansion of random region. | |
| Default value: 128 | |
| Suggested values: 16, 32, 50, 64, 100, 128, 256, 300, 400, 512 | |
| Typical range of values: 1 <= Height <= 512 (lin) | |
| Minimum increment: 1 | |
|
Recommended increment: 10 | |
| Restriction: Height > 0 | |
The worst case for the storage complexity for the created region (in byte) is: O(Width * Height * 2).
If the parameter values are correct, the operator ::gen_random_region returns the value H_MSG_TRUE. Otherwise an exception handling is raised. The clipping according to the current image format is set via the operator ::set_system('clip_region',<'true'/'false'>).
::paint_region, ::reduce_domain
::gen_checker_region, ::hamming_change_region, ::add_noise_distribution, ::add_noise_white, ::reduce_domain
Region processing
