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 or l1 = l2 and c1 <= c2
The indicated coordinates stand for two consecutive pixels in the tupel.
|
Region (output_object) |
region -> object |
| Created region. | |
|
Rows (input_control) |
coordinates.y(-array) -> integer |
| Lines of the pixels in the region. | |
| Default value: 100 | |
| Suggested values: 0, 10, 30, 50, 100, 200, 300, 500 | |
| Typical range of values: -oo <= Rows <= -oo (lin) | |
| Minimum increment: 1 | |
|
Recommended increment: 1 | |
|
Columns (input_control) |
coordinates.x(-array) -> integer |
| Columns of the pixels in the region. | |
| Default value: 100 | |
| Suggested values: 0, 10, 30, 50, 100, 200, 300, 500 | |
| Typical range of values: -oo <= Columns <= -oo (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 2 (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 (by the clipping or by an empty input) the operator set_system('store_empty_region',<true/false>) determines whether the region is returned or an empty object tuple.
gen_region_points is reentrant, local, and processed without parallelization.
gen_region_polygon, gen_region_runs, gen_region_line
Foundation
