set_draw ( : : WindowHandle, Mode : )

Define the region fill mode.

set_draw defines the region fill mode. If Mode is set to 'fill', output regions are filled, if set to 'margin', only contours are displayed. Setting Mode only affects the valid window. It is used by procedures with region output like disp_region, disp_circle, disp_rectangle1, disp_rectangle2, disp_arrow etc. It is also used by procedures with grayvalue output for some grayvalue output modes (e.g. 'histogram', see set_paint). If the mode is 'margin', the contour can be affected with set_line_width, set_line_approx and set_line_style.


Attention

If the output mode is 'margin' and the line width is more than one, objects may not be displayed.


Parameters

WindowHandle (input_control)
window -> integer
Window_id.

Mode (input_control)
string -> string
Fill mode for region output.
Default value: 'fill'
List of values: 'fill', 'margin'


Result

set_draw returns 2 (H_MSG_TRUE) if Mode is correct and the window is valid. Otherwise an exception handling is raised.


Parallelization Information

set_draw is reentrant, local, and processed without parallelization.


Possible Predecessors

get_draw


Possible Successors

disp_region


See also

get_draw, disp_region, set_paint, disp_image, set_line_width, set_line_style


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH