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

draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2 (Operator)

Name

draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2 — Interactive drawing of any orientated rectangle.

Signature

draw_rectangle2( : : WindowHandle : Row, Column, Phi, Length1, Length2)

Herror draw_rectangle2(const Hlong WindowHandle, double* Row, double* Column, double* Phi, double* Length1, double* Length2)

Herror T_draw_rectangle2(const Htuple WindowHandle, Htuple* Row, Htuple* Column, Htuple* Phi, Htuple* Length1, Htuple* Length2)

Herror draw_rectangle2(const HTuple& WindowHandle, double* Row, double* Column, double* Phi, double* Length1, double* Length2)

double HWindow::DrawRectangle2(HTuple* Column, HTuple* Phi, HTuple* Length1, HTuple* Length2) const

void DrawRectangle2(const HTuple& WindowHandle, HTuple* Row, HTuple* Column, HTuple* Phi, HTuple* Length1, HTuple* Length2)

void HWindow::DrawRectangle2(double* Row, double* Column, double* Phi, double* Length1, double* Length2) const

void HOperatorSetX.DrawRectangle2(
[in] VARIANT WindowHandle, [out] VARIANT* Row, [out] VARIANT* Column, [out] VARIANT* Phi, [out] VARIANT* Length1, [out] VARIANT* Length2)

double HWindowX.DrawRectangle2(
[out] double* Column, [out] double* Phi, [out] double* Length1, [out] double* Length2)

static void HOperatorSet.DrawRectangle2(HTuple windowHandle, out HTuple row, out HTuple column, out HTuple phi, out HTuple length1, out HTuple length2)

void HWindow.DrawRectangle2(out double row, out double column, out double phi, out double length1, out double length2)

Description

draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2 returns the parameter for any orientated rectangle, which has been created interactively by the user in the window.

The created rectangle is described by its center, its two half axes and the angle between the first half axis and the horizontal coordinate axis.

To create a rectangle you have to press the left mouse button for the center of the rectangle. While keeping the button pressed you may dimension the length (Length1Length1Length1Length1Length1length1) and the orientation (PhiPhiPhiPhiPhiphi) of the first half axis. In doing so a temporary default length for the second half axis is assumed, which may be modified afterwards on demand. 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. You only can modify the orientation, if you grip a side perpendicular to the first half axis. Pressing the right mouse button terminates the procedure. On OS X draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2 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.

RowRowRowRowRowrow (output_control)  rectangle2.center.y → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row index of the center.

ColumnColumnColumnColumnColumncolumn (output_control)  rectangle2.center.x → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column index of the center.

PhiPhiPhiPhiPhiphi (output_control)  rectangle2.angle.rad → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Orientation of the bigger half axis in radians.

Length1Length1Length1Length1Length1length1 (output_control)  rectangle2.hwidth → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Bigger half axis.

Length2Length2Length2Length2Length2length2 (output_control)  rectangle2.hheight → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Smaller half axis.

Result

draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2 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_rectangle2_moddraw_rectangle2_modDrawRectangle2Moddraw_rectangle2_modDrawRectangle2ModDrawRectangle2Mod, draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_regiondraw_regionDrawRegiondraw_regionDrawRegionDrawRegion

See also

gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2, draw_circledraw_circleDrawCircledraw_circleDrawCircleDrawCircle, draw_ellipsedraw_ellipseDrawEllipsedraw_ellipseDrawEllipseDrawEllipse, set_insertset_insertSetInsertset_insertSetInsertSetInsert

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH