set_comprise ( : : WindowHandle, Mode : )

Define the image matrix output clipping.

set_comprise defines the image matrix output clipping. If Mode is set to 'object', only grayvalues belonging to the output object are displayed. If set to 'image', the whole image matrix is displayed. Default is 'object'.


Attention

If Mode was set to 'image', undefined grayvalues may be displayed. Depending on the context they are black or can have random content. See the examples.


Parameters

WindowHandle (input_control)
window -> integer
Window_id.

Mode (input_control)
string -> string
Clipping mode for grayvalue output.
Default value: 'object'
List of values: 'image', 'object'


Example
open_window(0,0,-1,-1,'root','visible',"',WindowHandle) 
read_image(Image,'fabrik') 
threshold(Image,Seg,100,255) 
set_system('init_new_image','false') 
sobel_amp(Image,Sob,'sum_abs',3) 
disp_image(Sob,WindowHandle) 
get_comprise(Mode) 
fwrite_string(['Current mode for gray values: ',Mode]) 
fnew_line() 
set_comprise(WindowHandle,'image') 
get_mbutton(WindowHandle,_,_,_) 
disp_image(Sob,WindowHandle) 
fwrite_string(['Current mode for gray values: image']) 
fnew_line().

Result

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


Parallelization Information

set_comprise is reentrant and processed without parallelization.


Possible Predecessors

get_comprise


Possible Successors

disp_image


See also

get_comprise, disp_image, disp_color


Module

System



Copyright © 1996-2005 MVTec Software GmbH