HALCON Reference Manual 10.0.2

get_mbuttonget_mbuttonget_mbuttonGetMbuttonGetMbutton (Operator)

Name

get_mbuttonget_mbuttonget_mbuttonGetMbuttonGetMbutton — Wait until a mouse button is pressed.

Signature

get_mbutton( : : WindowHandle : Row, Column, Button)

get_mbuttonget_mbuttonget_mbuttonGetMbuttonGetMbutton returns the pixel accurate image coordinates of the mouse pointer in the output window and the mouse button pressed (ButtonButtonButtonButtonbutton):

1:: Left button,
2:: Middle button,
4:: Right button.

The operator waits until a button is pressed in the output window. If more than one button is pressed, the sum of the individual buttons' values is returned. For graphics windows the coordinates RowRowRowRowrow and ColumnColumnColumnColumncolumn are expressed with consideration of the current image part (see set_partset_partset_partSetPartSetPart). For text windows the coordinates of the upper left corner are (0,0), while the coordinates of the lower right corner are (window height-1,window width-1) (see open_textwindowopen_textwindowopen_textwindowOpenTextwindowOpenTextwindow).

If subpixel accurate image coordinates are required, you can use the operator get_mbutton_sub_pixget_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPix.

Attention

get_mbuttonget_mbuttonget_mbuttonGetMbuttonGetMbutton only returns if a mouse button is pressed in the window.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
Processed without parallelization.