Drawing

List of Operators ↓

This chapter describes operators that allow the user to manually draw geometric shapes. They require mouse interaction and in general block the application until the mouse interaction is finished. For non-blocking interactive creation of geometric shapes, HALCON also provides drawing objects with the operators listed in Graphics / Object.

General Objectives

The draw operators draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region, draw_xlddraw_xldDrawXldDrawXldDrawXlddraw_xld, draw_xld_moddraw_xld_modDrawXldModDrawXldModDrawXldModdraw_xld_mod, draw_nurbsdraw_nurbsDrawNurbsDrawNurbsDrawNurbsdraw_nurbs, draw_nurbs_moddraw_nurbs_modDrawNurbsModDrawNurbsModDrawNurbsModdraw_nurbs_mod, draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp, draw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpModDrawNurbsInterpModdraw_nurbs_interp_mod, as well as drag_region1drag_region1DragRegion1DragRegion1DragRegion1drag_region1, drag_region2drag_region2DragRegion2DragRegion2DragRegion2drag_region2 and drag_region3drag_region3DragRegion3DragRegion3DragRegion3drag_region3 return iconic objects. All other draw operators return the geometric parameters that are needed to create regions or contours in the respective shape (see table). Most draw operators have a modifying variant that allows the user to specify the initial parameters of the shown shape.

Drawing in Buffer Windows

Because the draw operators rely on mouse interaction, they generally do not work when used with buffer windows (see open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window), so you should use drawing objects instead. Nevertheless some operators (see table) can be used in buffer windows. These operators are controlled through a mouse state. In order to use these operators (and to not cause a deadlock) the application has to provide the mouse state with the operators send_mouse_double_click_eventsend_mouse_double_click_eventSendMouseDoubleClickEventSendMouseDoubleClickEventSendMouseDoubleClickEventsend_mouse_double_click_event, send_mouse_down_eventsend_mouse_down_eventSendMouseDownEventSendMouseDownEventSendMouseDownEventsend_mouse_down_event, send_mouse_drag_eventsend_mouse_drag_eventSendMouseDragEventSendMouseDragEventSendMouseDragEventsend_mouse_drag_event and send_mouse_up_eventsend_mouse_up_eventSendMouseUpEventSendMouseUpEventSendMouseUpEventsend_mouse_up_event as well as the state of the modifier keys (also by using send_mouse_drag_eventsend_mouse_drag_eventSendMouseDragEventSendMouseDragEventSendMouseDragEventsend_mouse_drag_event), whereas the draw operators themselves must be run in another thread. While using the draw operator, the image section must not be changed.

Drawing Operators Output Generate Object Works in Buffer Windows
draw_pointdraw_pointDrawPointDrawPointDrawPointdraw_point RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn gen_cross_contour_xldgen_cross_contour_xldGenCrossContourXldGenCrossContourXldGenCrossContourXldgen_cross_contour_xld yes
draw_linedraw_lineDrawLineDrawLineDrawLinedraw_line Row1Row1Row1Row1row1row_1, Column1Column1Column1Column1column1column_1, Row2Row2Row2Row2row2row_2, Column2Column2Column2Column2column2column_2 gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld yes
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1 Row1Row1Row1Row1row1row_1, Column1Column1Column1Column1column1column_1, Row2Row2Row2Row2row2row_2, Column2Column2Column2Column2column2column_2 gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1 yes
draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2DrawRectangle2draw_rectangle2 RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn, PhiPhiPhiPhiphiphi, Length1Length1Length1Length1length1length_1, Length2Length2Length2Length2length2length_2 gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2, gen_rectangle2_contour_xldgen_rectangle2_contour_xldGenRectangle2ContourXldGenRectangle2ContourXldGenRectangle2ContourXldgen_rectangle2_contour_xld yes
draw_circledraw_circleDrawCircleDrawCircleDrawCircledraw_circle RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn, RadiusRadiusRadiusRadiusradiusradius gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle, gen_circle_contour_xldgen_circle_contour_xldGenCircleContourXldGenCircleContourXldGenCircleContourXldgen_circle_contour_xld yes
draw_ellipsedraw_ellipseDrawEllipseDrawEllipseDrawEllipsedraw_ellipse RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn, PhiPhiPhiPhiphiphi, Radius1Radius1Radius1Radius1radius1radius_1, Radius2Radius2Radius2Radius2radius2radius_2 gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipsegen_ellipse, gen_ellipse_contour_xldgen_ellipse_contour_xldGenEllipseContourXldGenEllipseContourXldGenEllipseContourXldgen_ellipse_contour_xld yes
draw_xlddraw_xldDrawXldDrawXldDrawXlddraw_xld ContourContourContourContourcontourcontour - yes
draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region RegionRegionRegionRegionregionregion - yes
draw_polygondraw_polygonDrawPolygonDrawPolygonDrawPolygondraw_polygon RegionRegionRegionRegionregionregion - yes
draw_nurbsdraw_nurbsDrawNurbsDrawNurbsDrawNurbsdraw_nurbs ContourContourContourContourcontourcontour, RowsRowsRowsRowsrowsrows, ColumnsColumnsColumnsColumnscolumnscolumns, WeightsWeightsWeightsWeightsweightsweights - no
draw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterpDrawNurbsInterpdraw_nurbs_interp ContourContourContourContourcontourcontour, RowsRowsRowsRowsrowsrows, ColumnsColumnsColumnsColumnscolumnscolumns, KnotsKnotsKnotsKnotsknotsknots, TangentsTangentsTangentsTangentstangentstangents - no
drag_region1drag_region1DragRegion1DragRegion1DragRegion1drag_region1 RegionRegionRegionRegionregionregion - no
drag_region2drag_region2DragRegion2DragRegion2DragRegion2drag_region2 RegionRegionRegionRegionregionregion - no
drag_region3drag_region3DragRegion3DragRegion3DragRegion3drag_region3 RegionRegionRegionRegionregionregion - no

List of Operators

drag_region1DragRegion1drag_region1DragRegion1drag_region1
Interactive moving of a region.
drag_region2DragRegion2drag_region2DragRegion2drag_region2
Interactive movement of a region with fixpoint specification.
drag_region3DragRegion3drag_region3DragRegion3drag_region3
Interactive movement of a region with restriction of positions.
draw_circleDrawCircledraw_circleDrawCircledraw_circle
Interactive drawing of a circle.
draw_circle_modDrawCircleModdraw_circle_modDrawCircleModdraw_circle_mod
Interactive drawing of a circle.
draw_ellipseDrawEllipsedraw_ellipseDrawEllipsedraw_ellipse
Interactive drawing of an ellipse.
draw_ellipse_modDrawEllipseModdraw_ellipse_modDrawEllipseModdraw_ellipse_mod
Interactive drawing of an ellipse.
draw_lineDrawLinedraw_lineDrawLinedraw_line
Draw a line.
draw_line_modDrawLineModdraw_line_modDrawLineModdraw_line_mod
Draw a line.
draw_nurbsDrawNurbsdraw_nurbsDrawNurbsdraw_nurbs
Interactive drawing of a NURBS curve.
draw_nurbs_interpDrawNurbsInterpdraw_nurbs_interpDrawNurbsInterpdraw_nurbs_interp
Interactive drawing of a NURBS curve using interpolation.
draw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_modDrawNurbsInterpModdraw_nurbs_interp_mod
Interactive modification of a NURBS curve using interpolation.
draw_nurbs_modDrawNurbsModdraw_nurbs_modDrawNurbsModdraw_nurbs_mod
Interactive modification of a NURBS curve.
draw_pointDrawPointdraw_pointDrawPointdraw_point
Draw a point.
draw_point_modDrawPointModdraw_point_modDrawPointModdraw_point_mod
Draw a point.
draw_polygonDrawPolygondraw_polygonDrawPolygondraw_polygon
Interactive drawing of a polygon row.
draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1draw_rectangle1
Draw a rectangle parallel to the coordinate axis.
draw_rectangle1_modDrawRectangle1Moddraw_rectangle1_modDrawRectangle1Moddraw_rectangle1_mod
Draw a rectangle parallel to the coordinate axis.
draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2draw_rectangle2
Interactive drawing of any orientated rectangle.
draw_rectangle2_modDrawRectangle2Moddraw_rectangle2_modDrawRectangle2Moddraw_rectangle2_mod
Interactive drawing of any orientated rectangle.
draw_regionDrawRegiondraw_regionDrawRegiondraw_region
Interactive drawing of a closed region.
draw_xldDrawXlddraw_xldDrawXlddraw_xld
Interactive drawing of a contour.
draw_xld_modDrawXldModdraw_xld_modDrawXldModdraw_xld_mod
Interactive modification of a contour.