draw_rectangle1DrawRectangle1DrawRectangle1draw_rectangle1T_draw_rectangle1

HALCON ScriptCpp++.NETPythonC

Short description

draw_rectangle1DrawRectangle1DrawRectangle1draw_rectangle1T_draw_rectangle1 — Draw a rectangle parallel to the coordinate axis.

Signature

draw_rectangle1( window WindowHandle, out rectangle.origin.y Row1, out rectangle.origin.x Column1, out rectangle.corner.y Row2, out rectangle.corner.x Column2 )void DrawRectangle1( const HTuple& WindowHandle, HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2 )static void HOperatorSet.DrawRectangle1( HTuple windowHandle, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2 )def draw_rectangle1( window_handle: HHandle ) -> Tuple[float, float, float, float]

Herror T_draw_rectangle1( const Htuple WindowHandle, Htuple* Row1, Htuple* Column1, Htuple* Row2, Htuple* Column2 )

void HWindow::DrawRectangle1( double* Row1, double* Column1, double* Row2, double* Column2 ) const

void HWindow.DrawRectangle1( out double row1, out double column1, out double row2, out double column2 )

Description

draw_rectangle1DrawRectangle1 returns the parameter for a rectangle parallel to the coordinate axes, which has been created interactively by the user in the window.

To create a rectangle you have to press the left mouse button determining a corner of the rectangle. While keeping the button pressed you may “drag” the rectangle in any direction. After another mouse click in the middle of the created rectangle you can move it. A click close to one side “grips” it to modify the rectangle’s dimension in perpendicular direction to this side. If you click on one corner of the created rectangle, you may move this corner. Pressing the right mouse button terminates the procedure.

After terminating the procedure the rectangle is not visible in the window any longer.

Attention

If used in a buffer window, mouse events have to be supplied by the application, while the draw operator must be run in another thread.

Execution information

Execution information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).

• Multithreading scope: global (may be called from any thread).

• Processed without parallelization.

Parameters

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Row1row1row_1 (output_control) rectangle.origin.y → (real)HTuple (double)HTuple (double)floatHtuple (double)

Row index of the left upper corner.

Column1column1column_1 (output_control) rectangle.origin.x → (real)HTuple (double)HTuple (double)floatHtuple (double)

Column index of the left upper corner.

Row2row2row_2 (output_control) rectangle.corner.y → (real)HTuple (double)HTuple (double)floatHtuple (double)

Row index of the right lower corner.

Column2column2column_2 (output_control) rectangle.corner.x → (real)HTuple (double)HTuple (double)floatHtuple (double)

Column index of the right lower corner.

Example

(HDevelop)

read_image(Image,'monkey')
get_image_size (Image, Width, Height)
dev_display (Image)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
dev_set_part (Row1, Column1, Row2, Column2)
dev_display (Image)

(C)

read_image(&Image,"monkey")\;
get_image_size(Image,&Width,&Height)\;
disp_image(Image,WindowHandle)\;
draw_rectangle1(WindowHandle,&Row1,&Column1,&Row2,&Column2)\;
set_part(WindowHandle,Row1,Column1,Row2,Column2)\;
disp_image(Image,WindowHandle)\;

Result

draw_rectangle1DrawRectangle1 returns 2 (H_MSG_TRUE) if the window is valid. If necessary, an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

open_windowOpenWindow

Possible successors

reduce_domainReduceDomain, disp_regionDispRegion, set_coloredSetColored, set_line_widthSetLineWidth, set_drawSetDraw

Alternatives

draw_rectangle1_modDrawRectangle1Mod, draw_rectangle2DrawRectangle2, draw_regionDrawRegion

See also

gen_rectangle1GenRectangle1, draw_circleDrawCircle, draw_ellipseDrawEllipse

Module

Foundation