Herror ::set_insert (
    const HTuple &WindowHandle,
    const HTuple &Mode
)
void HWindow::SetInsert (
    const HTuple &Mode
) const

Define the pixel output function.

::set_insert defines the function, with which pixels are displayed in the output window. It is e.g. possible for a pixel to overwrite the old value. In most of the cases there is a functional relationship between old and new values.

The definiton value is only valid for the valid window. Output procedures that honor Mode are e.g. ::disp_region, ::disp_polygon,::disp_circle.

Possible display functions are: 'copy' overwrite displayed pixels 'xor' display old "xor" new pixels 'not' complement displayed pixels

There may not be all functions available, depending on the physical display. However, "copy" is always available.


Parameters

WindowHandle (input_control)
window -> HTuple.long
Window_id.

Mode (input_control)
string -> HTuple.char *
Name of the display function.
Default value: 'copy'
List of values: 'copy', 'xor', 'not'


Result

::set_insert returns H_MSG_TRUE if the paramter is correct and the window is valid. Otherwise an exception handling is raised.


Possible Predecessors

::query_insert, ::get_insert


Possible Successors

::disp_region


See also

::get_insert, ::query_insert


Module

System



Copyright © 1996-2002 MVTec Software GmbH