Interactive movement of a region with restriction of positions.
You use drag_region3 to move a region on the display by mouse. It corresponds to the procedure drag_region2 with the enhancement, that all points are specified which can be entered by mouse. If you move the mouse outside of this area (MaskRegion), the region on the point with the smallest distance inside MaskRegion will be displayed.
The region's gray values are not moved. With moving the input region it is not sure whether the gray values of the output regions are filled reasonable. This may occur if the gray values of the input regions do not comprise the whole image.
|
SourceRegion (input_object) |
region-array -> object |
| Regions to move. | |
|
MaskRegion (input_object) |
region-array -> object |
| Points on which it is allowed for a region to move. | |
|
DestinationRegion (output_object) |
region-array -> object |
| Moved regions. | |
|
WindowHandle (input_control) |
window -> integer |
| Window_id. | |
|
Row (input_control) |
point.y -> integer |
| Row index of the reference point. | |
| Default value: 100 | |
| Suggested values: 0, 64, 128, 256, 512 | |
| Typical range of values: 0 <= Row <= 1024 | |
|
Column (input_control) |
point.x -> integer |
| Column index of the reference point. | |
| Default value: 100 | |
| Suggested values: 0, 64, 128, 256, 512 | |
| Typical range of values: 0 <= Column <= 1024 | |
drag_region3 returns 2 (H_MSG_TRUE), if a region is entered, if the window is valid and the needed drawing mode (see set_insert) is available. If necessary, an exception handling is raised. You may determine the behavior after an empty input with set_system(::'no_object_result',<Result>:).
drag_region3 is reentrant, local, and processed without parallelization.
reduce_domain, disp_region, set_colored, set_line_width, set_draw, set_insert, affine_trans_image
get_mposition, move_region, drag_region1, drag_region2
set_insert, set_draw, affine_trans_image
System
