HALCON Reference Manual 10.0.2
Table of Contents / Graphics / Parameters ClassesClassesClasses | | | Operators

set_insertset_insertset_insertSetInsertSetInsert (Operator)

Name

set_insertset_insertset_insertSetInsertSetInsert — Define the pixel output function.

Signature

set_insert( : : WindowHandle, Mode : )

Herror set_insert(const Hlong WindowHandle, const char* Mode)

Herror T_set_insert(const Htuple WindowHandle, const Htuple Mode)

Herror set_insert(const HTuple& WindowHandle, const HTuple& Mode)

void HWindow::SetInsert(const HTuple& Mode) const

void HOperatorSetX.SetInsert(
[in] VARIANT WindowHandle, [in] VARIANT Mode)

void HWindowX.SetInsert([in] BSTR Mode)

static void HOperatorSet.SetInsert(HTuple windowHandle, HTuple mode)

void HWindow.SetInsert(string mode)

Description

set_insertset_insertset_insertSetInsertSetInsert 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 operators that honor ModeModeModeModemode are e.g. disp_regiondisp_regiondisp_regionDispRegionDispRegion, disp_polygondisp_polygondisp_polygonDispPolygonDispPolygon,disp_circledisp_circledisp_circleDispCircleDispCircle.

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.

Parallelization

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong)

Window_id.

ModeModeModeModemode (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Name of the display function.

Default value: 'copy' "copy" "copy" "copy" "copy"

List of values: 'copy'"copy""copy""copy""copy", 'xor'"xor""xor""xor""xor", 'complement'"complement""complement""complement""complement"

Result

set_insertset_insertset_insertSetInsertSetInsert returns 2 (H_MSG_TRUE) if the parameter is correct and the window is valid. Otherwise an exception is raised.

Possible Predecessors

query_insertquery_insertquery_insertQueryInsertQueryInsert, get_insertget_insertget_insertGetInsertGetInsert

Possible Successors

disp_regiondisp_regiondisp_regionDispRegionDispRegion

See also

get_insertget_insertget_insertGetInsertGetInsert, query_insertquery_insertquery_insertQueryInsertQueryInsert

Module

Foundation


Table of Contents / Graphics / Parameters ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH