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

draw_rectangle1_moddraw_rectangle1_moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1Mod (Operator)

Name

draw_rectangle1_moddraw_rectangle1_moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1Mod — Draw a rectangle parallel to the coordinate axis.

Signature

draw_rectangle1_mod( : : WindowHandle, Row1In, Column1In, Row2In, Column2In : Row1, Column1, Row2, Column2)

Herror draw_rectangle1_mod(const Hlong WindowHandle, double Row1In, double Column1In, double Row2In, double Column2In, double* Row1, double* Column1, double* Row2, double* Column2)

Herror T_draw_rectangle1_mod(const Htuple WindowHandle, const Htuple Row1In, const Htuple Column1In, const Htuple Row2In, const Htuple Column2In, Htuple* Row1, Htuple* Column1, Htuple* Row2, Htuple* Column2)

Herror draw_rectangle1_mod(const HTuple& WindowHandle, const HTuple& Row1In, const HTuple& Column1In, const HTuple& Row2In, const HTuple& Column2In, double* Row1, double* Column1, double* Row2, double* Column2)

double HWindow::DrawRectangle1Mod(const HTuple& Row1In, const HTuple& Column1In, const HTuple& Row2In, const HTuple& Column2In, HTuple* Column1, HTuple* Row2, HTuple* Column2) const

void HOperatorSetX.DrawRectangle1Mod(
[in] VARIANT WindowHandle, [in] VARIANT Row1In, [in] VARIANT Column1In, [in] VARIANT Row2In, [in] VARIANT Column2In, [out] VARIANT* Row1, [out] VARIANT* Column1, [out] VARIANT* Row2, [out] VARIANT* Column2)

double HWindowX.DrawRectangle1Mod(
[in] double Row1In, [in] double Column1In, [in] double Row2In, [in] double Column2In, [out] double* Column1, [out] double* Row2, [out] double* Column2)

static void HOperatorSet.DrawRectangle1Mod(HTuple windowHandle, HTuple row1In, HTuple column1In, HTuple row2In, HTuple column2In, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)

void HWindow.DrawRectangle1Mod(double row1In, double column1In, double row2In, double column2In, out double row1, out double column1, out double row2, out double column2)

Description

draw_rectangle1_moddraw_rectangle1_moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1Mod 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 are expected the parameters Row1InRow1InRow1InRow1Inrow1In, Column1InColumn1InColumn1InColumn1Incolumn1In,Row2InRow2InRow2InRow2Inrow2In and Column2InColumn2InColumn2InColumn2Incolumn2In. After a 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.

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

Parallelization

Parameters

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

Window identifier.

Row1InRow1InRow1InRow1Inrow1In (input_control)  rectangle.origin.y → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row index of the left upper corner.

Column1InColumn1InColumn1InColumn1Incolumn1In (input_control)  rectangle.origin.x → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column index of the left upper corner.

Row2InRow2InRow2InRow2Inrow2In (input_control)  rectangle.corner.y → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row index of the right lower corner.

Column2InColumn2InColumn2InColumn2Incolumn2In (input_control)  rectangle.corner.x → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column index of the right lower corner.

Row1Row1Row1Row1row1 (output_control)  rectangle.origin.y → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row index of the left upper corner.

Column1Column1Column1Column1column1 (output_control)  rectangle.origin.x → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column index of the left upper corner.

Row2Row2Row2Row2row2 (output_control)  rectangle.corner.y → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row index of the right lower corner.

Column2Column2Column2Column2column2 (output_control)  rectangle.corner.x → HTupleHTupleVARIANTHtuple (real) (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_mod(WindowHandle,Row1In,Column1In,Row2In,Column2In,\
                    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_mod(WindowHandle,Row1In,Column1In,Row2In,Column2In,
                    &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_mod(WindowHandle,Row1In,Column1In,Row2In,Column2In,\
                    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_mod(WindowHandle,Row1In,Column1In,Row2In,Column2In,\
                    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_mod(WindowHandle,Row1In,Column1In,Row2In,Column2In,\
                    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_rectangle1_moddraw_rectangle1_moddraw_rectangle1_modDrawRectangle1ModDrawRectangle1Mod returns 2 (H_MSG_TRUE), if the window is valid and the needed drawing mode (see set_insertset_insertset_insertSetInsertSetInsert) is available. If necessary, an exception is raised.

Possible Predecessors

open_windowopen_windowopen_windowOpenWindowOpenWindow

Possible Successors

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, disp_regiondisp_regiondisp_regionDispRegionDispRegion, set_coloredset_coloredset_coloredSetColoredSetColored, set_line_widthset_line_widthset_line_widthSetLineWidthSetLineWidth, set_drawset_drawset_drawSetDrawSetDraw, set_insertset_insertset_insertSetInsertSetInsert

Alternatives

draw_rectangle1draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_regiondraw_regiondraw_regionDrawRegionDrawRegion

See also

gen_rectangle1gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1, draw_circledraw_circledraw_circleDrawCircleDrawCircle, draw_ellipsedraw_ellipsedraw_ellipseDrawEllipseDrawEllipse, set_insertset_insertset_insertSetInsertSetInsert

Module

Foundation

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