store_coord ( : Region : Rows, Columns : )

Store individual pixels as image region.

The operator store_coord 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.


Attention

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.


Parameters

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
Range of values: 0 <= Rows <= 511 (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
Range of values: 0 <= Columns <= 511 (lin)
Minimum increment: 1
Recommended increment: 1
Number of elements: Columns == Rows


Complexity

Sei F die Anzahl der Punkte. Falls die Punkte aufsteigend sortiert sind, dann ist die Laufzeitkomplexität: O(F), sonst O(log(F)*F).


Result

The operator store_coord returns the value TRUE if the pixels are located within the image format. Otherwise an exception is raised. The clipping of 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_empty_region',<true/false>:) determines whether the region is returned.


Possible Predecessors

fetch_coord


Possible Successors

paint_region__, reduce_domain


Alternatives

store_polygon, store_chord, store_lines


See also

reduce_domain



Copyright © 1996-1997 MVTec Software GmbH