HALCON Website / HALCON Operator Reference / Graphics / Drawing
ClassesClassesClassesClasses | | | | Operators

draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1 (Operator)

Name

draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1 — Draw a rectangle parallel to the coordinate axis.

Signature

draw_rectangle1( : : WindowHandle : Row1, Column1, Row2, Column2)

Herror draw_rectangle1(const Hlong WindowHandle, double* Row1, double* Column1, double* Row2, double* Column2)

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

Herror draw_rectangle1(const HTuple& WindowHandle, double* Row1, double* Column1, double* Row2, double* Column2)

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

void DrawRectangle1(const HTuple& WindowHandle, HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2)

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

void HOperatorSetX.DrawRectangle1(
[in] VARIANT WindowHandle, [out] VARIANT* Row1, [out] VARIANT* Column1, [out] VARIANT* Row2, [out] VARIANT* Column2)

double HWindowX.DrawRectangle1(
[out] double* Column1, [out] double* Row2, [out] double* Column2)

static void HOperatorSet.DrawRectangle1(HTuple windowHandle, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)

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

Description

draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1 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 mousebutton terminates the procedure. On Mac OS X draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1 can also be terminated by pressing the escape key.

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

Parallelization

Parameters

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Window identifier.

Row1Row1Row1Row1Row1row1 (output_control)  rectangle.origin.y → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row index of the left upper corner.

Column1Column1Column1Column1Column1column1 (output_control)  rectangle.origin.x → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column index of the left upper corner.

Row2Row2Row2Row2Row2row2 (output_control)  rectangle.corner.y → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row index of the right lower corner.

Column2Column2Column2Column2Column2column2 (output_control)  rectangle.corner.x → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column index of the right lower corner.

Example (HDevelop)

get_system('width',Width)
get_system('height',Height)
set_part(WindowHandle,0,0,Width-1,Height-1)
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
fwrite_string(FileHandle,['Clipping = (',Row1,',',Column1,')'])
fwrite_string(FileHandle,[',(',Row2,',',Column2,')'])
fnew_line(FileHandle)

Example (C)

get_system("width",Width) ;
get_system("height",Height) ;
set_part(WindowHandle,0,0,Width-1,Height-1) ;
read_image(&Image,"monkey") ;
disp_image(Image,WindowHandle) ;
draw_rectangle1(WindowHandle,&Row1,&Column1,&Row2,&Column2) ;
set_part(WindowHandle,Row1,Column1,Row2,Column2) ;
disp_image(Image,WindowHandle) ;
fwrite_string(FileHandle,"Clipping = (") ;
fwrite_string(FileHandle,Row1) ;
fwrite_string(FileHandle,",") ;
fwrite_string(FileHandle,Column1) ;
fwrite_string(FileHandle,"),(") ;
fwrite_string(FileHandle,Row2) ;
fwrite_string(FileHandle,",") ;
fwrite_string(FileHandle,Column2) ;
fwrite_string(FileHandle,")") ;
fnew_line(FileHandle) ;

Example (HDevelop)

get_system('width',Width)
get_system('height',Height)
set_part(WindowHandle,0,0,Width-1,Height-1)
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
fwrite_string(FileHandle,['Clipping = (',Row1,',',Column1,')'])
fwrite_string(FileHandle,[',(',Row2,',',Column2,')'])
fnew_line(FileHandle)

Example (HDevelop)

get_system('width',Width)
get_system('height',Height)
set_part(WindowHandle,0,0,Width-1,Height-1)
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
fwrite_string(FileHandle,['Clipping = (',Row1,',',Column1,')'])
fwrite_string(FileHandle,[',(',Row2,',',Column2,')'])
fnew_line(FileHandle)

Example (HDevelop)

get_system('width',Width)
get_system('height',Height)
set_part(WindowHandle,0,0,Width-1,Height-1)
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
fwrite_string(FileHandle,['Clipping = (',Row1,',',Column1,')'])
fwrite_string(FileHandle,[',(',Row2,',',Column2,')'])
fnew_line(FileHandle)

Example (HDevelop)

get_system('width',Width)
get_system('height',Height)
set_part(WindowHandle,0,0,Width-1,Height-1)
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
draw_rectangle1(WindowHandle,Row1,Column1,Row2,Column2)
set_part(WindowHandle,Row1,Column1,Row2,Column2)
disp_image(Image,WindowHandle)
fwrite_string(FileHandle,['Clipping = (',Row1,',',Column1,')'])
fwrite_string(FileHandle,[',(',Row2,',',Column2,')'])
fnew_line(FileHandle)

Result

draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1 returns 2 (H_MSG_TRUE), if the window is valid and the needed drawing mode (see set_insertset_insertSetInsertset_insertSetInsertSetInsert) is available. If necessary, an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Possible Successors

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_insertset_insertSetInsertset_insertSetInsertSetInsert

Alternatives

draw_rectangle1_moddraw_rectangle1_modDrawRectangle1Moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1Mod, draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_regiondraw_regionDrawRegiondraw_regionDrawRegionDrawRegion

See also

gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1, draw_circledraw_circleDrawCircledraw_circleDrawCircleDrawCircle, draw_ellipsedraw_ellipseDrawEllipsedraw_ellipseDrawEllipseDrawEllipse, set_insertset_insertSetInsertset_insertSetInsertSetInsert

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH