Store individual pixels as image region.
The operator ::gen_region_points creates a region described by a number of pixels. The pixels do not have to be stored in a fixed order, but the best runtime behavior is obtained when the pixels are stored in ascending order. The order is as follows:
(l1,c1) <= (l2,c2) := l1 < l2 oder l1 = l2 und c1 <= c2
The indicated coordinates stand for two consecutive pixels in the tupel.
The gray values of the output regions are undefined. All pixels must be located within the image format. If no pixels are passed an empty region is created.
|
Region (output_object) |
region -> Hobject * : HRegion |
| Created region. | |
|
Rows (input_control) |
coordinates.y(-array) -> HTuple.long |
| Lines of the pixels in the region. | |
| Default value: 100 | |
| Suggested values: 0, 10, 30, 50, 100, 200, 300, 500 | |
| Typical range of values: 0 <= Rows <= 511 (lin) | |
| Minimum increment: 1 | |
|
Recommended increment: 1 | |
|
Columns (input_control) |
coordinates.x(-array) -> HTuple.long |
| Columns of the pixels in the region. | |
| Default value: 100 | |
| Suggested values: 0, 10, 30, 50, 100, 200, 300, 500 | |
| Typical range of values: 0 <= Columns <= 511 (lin) | |
| Minimum increment: 1 | |
|
Recommended increment: 1 | |
| Number of elements: Columns == Rows | |
F shall be the number of pixels. If the pixels are sorted in ascending order the runtime complexity is: O(F), otherwise O(log(F)*F).
The operator ::gen_region_points returns the value H_MSG_TRUE if the pixels are located within the image format. 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'>). If an empty region is created (empty input) the operator ::set_system('store_gen_empty_region',<true/false>) determines whether the region is returned.
::paint_region, ::reduce_domain
::gen_region_polygon, ::gen_region_runs, ::gen_region_line
Region processing
