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 definition 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
             'complement'  complement displayed pixels

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

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

set_insert is reentrant, local, and processed without parallelization.

query_insert, get_insert

disp_region

get_insert, query_insert

Foundation