set_insert ( : : Mode : )

Definition of 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 active 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

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


Result

set_insert returns TRUE, if the paramter is correct and a window is active. Otherwise an exception is raised.


Possible Predecessors

query_insert, get_insert


Possible Successors

disp_region


See also

get_insert, query_insert



Copyright © 1996-1997 MVTec Software GmbH