HALCON 17.12 / HALCON Operator Reference / Legacy / Graphics
ClassesClasses | | Operators

move_rectanglemove_rectangleMoveRectangleMoveRectangle (Operator)

Name

move_rectanglemove_rectangleMoveRectangleMoveRectangle — Copy inside an output window.

Warning

move_rectanglemove_rectangleMoveRectangleMoveRectangleMoveRectangle is obsolete and is only provided for reasons of backward compatibility.

Signature

move_rectangle( : : WindowHandle, Row1, Column1, Row2, Column2, DestRow, DestColumn : )

Herror move_rectangle(const Hlong WindowHandle, const Hlong Row1, const Hlong Column1, const Hlong Row2, const Hlong Column2, const Hlong DestRow, const Hlong DestColumn)

Herror T_move_rectangle(const Htuple WindowHandle, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2, const Htuple DestRow, const Htuple DestColumn)

void MoveRectangle(const HTuple& WindowHandle, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, const HTuple& DestRow, const HTuple& DestColumn)

void HWindow::MoveRectangle(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, const HTuple& DestRow, const HTuple& DestColumn) const

void HWindow::MoveRectangle(Hlong Row1, Hlong Column1, Hlong Row2, Hlong Column2, Hlong DestRow, Hlong DestColumn) const

static void HOperatorSet.MoveRectangle(HTuple windowHandle, HTuple row1, HTuple column1, HTuple row2, HTuple column2, HTuple destRow, HTuple destColumn)

void HWindow.MoveRectangle(HTuple row1, HTuple column1, HTuple row2, HTuple column2, HTuple destRow, HTuple destColumn)

void HWindow.MoveRectangle(int row1, int column1, int row2, int column2, int destRow, int destColumn)

Description

move_rectanglemove_rectangleMoveRectangleMoveRectangleMoveRectangle copies all entries in the rectangle (Row1Row1Row1Row1row1,Column1Column1Column1Column1column1), (Row2Row2Row2Row2row2,Column2Column2Column2Column2column2) of the output window to a new position inside the same window. This position is determined by the upper left corner (DestRowDestRowDestRowDestRowdestRow, DestColumnDestColumnDestColumnDestColumndestColumn). Regions of the window, which are “uncovered” through moving the rectangle, are set to the color of the background.

If you want to move several rectangles at once, you may pass parameters in form of tuples.

Execution Information

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Window handle.

Row1Row1Row1Row1row1 (input_control)  rectangle.origin.y(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row index of upper left corner of the source rectangle.

Default value: 0

Typical range of values: 0 ≤ Row1 Row1 Row1 Row1 row1 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

Column1Column1Column1Column1column1 (input_control)  rectangle.origin.x(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column index of upper left corner of the source rectangle.

Default value: 0

Typical range of values: 0 ≤ Column1 Column1 Column1 Column1 column1 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

Row2Row2Row2Row2row2 (input_control)  rectangle.corner.y(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row index of lower right corner of the source rectangle.

Default value: 64

Typical range of values: 0 ≤ Row2 Row2 Row2 Row2 row2 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

Column2Column2Column2Column2column2 (input_control)  rectangle.corner.x(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column index of lower right corner of the source rectangle.

Default value: 64

Typical range of values: 0 ≤ Column2 Column2 Column2 Column2 column2 ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

DestRowDestRowDestRowDestRowdestRow (input_control)  point.y(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row index of upper left corner of the target position.

Default value: 64

Typical range of values: 0 ≤ DestRow DestRow DestRow DestRow destRow ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

DestColumnDestColumnDestColumnDestColumndestColumn (input_control)  point.x(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column index of upper left corner of the target position.

Default value: 64

Typical range of values: 0 ≤ DestColumn DestColumn DestColumn DestColumn destColumn ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

Example (HDevelop)

* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)

Example (C)

/* "Interactive" copy of a rectangle in the same window */
draw_rectangle1(WindowHandle,&L1,&C1,&L2,&C2) ;
get_mbutton(WindowHandle,LN,CN,NULL) ;
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN) ;

Example (HDevelop)

* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)

Example (HDevelop)

* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)

Example (HDevelop)

* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)

Result

If the window is valid and the specified parameters are correct move_rectanglemove_rectangleMoveRectangleMoveRectangleMoveRectangle returns 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Alternatives

copy_rectanglecopy_rectangleCopyRectangleCopyRectangleCopyRectangle

See also

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH