Herror ::set_comprise (
    const HTuple &WindowHandle,
    const HTuple &Mode
)
void HWindow::SetComprise (
    const HTuple &Mode
) const

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 -> HTuple.long
Window_id.

Mode (input_control)
string -> HTuple.char *
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: ") ;
fwrite_string(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 H_MSG_TRUE if Mode is correct and the window is valid. Otherwise an exception handling is raised.


Possible Predecessors

::get_comprise


Possible Successors

::disp_image


See also

::get_comprise, ::disp_image, ::disp_color


Module

System



Copyright © 1996-2002 MVTec Software GmbH