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

Interactive creation of any orientated rectangle.

draw_rectangle2 returns the parameter for any orientated rectangle, which has been created interactively by the user in the current 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 (Length1) and the orientation (Phi) 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 may move it at will. 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.

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


Parameters

Row (output_control)
rectangle2.center.y -> integer
Row index of the barycenter.

Column (output_control)
rectangle2.center.x -> integer
Column index of the barycenter.

Phi (output_control)
rectangle2.angle.rad -> real
Orientation of the bigger half axis in radians.

Length1 (output_control)
rectangle2.hwidth -> integer
Bigger half axis

Length2 (output_control)
rectangle2.hheight -> integer
Smaller half axis


Result

draw_rectangle2 returns TRUE, if a window is activated and if the needed drawing mode (see set_insert) is available. If necessary an exception is raised.


Possible Predecessors

open_window, set_window


Possible Successors

reduce_domain, disp_region, set_colored, set_line_width, set_draw, set_insert


Alternatives

draw_rectangle1, draw_region


See also

rectangle2, draw_circle, draw_ellipse, set_insert



Copyright © 1996-1997 MVTec Software GmbH