draw_polygondraw_polygondraw_polygonDrawPolygonDrawPolygon (Operator)

Name

draw_polygondraw_polygondraw_polygonDrawPolygonDrawPolygon — Interactive drawing of a polygon row.

Signature

Description

draw_polygondraw_polygondraw_polygonDrawPolygonDrawPolygon produces an image. The region of that image spans exactly the imagepoints entered interactively by mouse clicks (gray values remain undefined).

Painting in the output window happens while pressing the left mouse button. Releasing the left mouse button and repressing it at another position effects drawing a line between these two points. Pressing the right mouse button terminates the input. Painting uses that color which has been set by set_colorset_colorset_colorSetColorSetColor, set_rgbset_rgbset_rgbSetRgbSetRgb, etc. .

To put gray values on the created PolygonRegionPolygonRegionPolygonRegionPolygonRegionpolygonRegion for further processing, you may use the operator reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain.

Attention

The painted contour is not closed automatically, in particular it is not “filled up” either.

Output object's gray values are not defined.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
• Processed without parallelization.

Parameters

draw_polygon(Polygon,WindowHandle)
shape_trans(Polygon,Filled,'convex')
disp_region(Filled,WindowHandle)

draw_polygon(&Polygon,WindowHandle) ;
shape_trans(Polygon,&Filled,"convex") ;
disp_region(Filled,WindowHandle) ;

draw_polygon(Polygon,WindowHandle)
shape_trans(Polygon,Filled,'convex')
disp_region(Filled,WindowHandle)

draw_polygon(Polygon,WindowHandle)
shape_trans(Polygon,Filled,'convex')
disp_region(Filled,WindowHandle)

draw_polygon(Polygon,WindowHandle)
shape_trans(Polygon,Filled,'convex')
disp_region(Filled,WindowHandle)

Result

If the window is valid, draw_polygondraw_polygondraw_polygonDrawPolygonDrawPolygon returns 2 (H_MSG_TRUE). 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

Alternatives

draw_regiondraw_regiondraw_regionDrawRegionDrawRegion, draw_circledraw_circledraw_circleDrawCircleDrawCircle, draw_rectangle1draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2draw_rectangle2DrawRectangle2DrawRectangle2, boundaryboundaryboundaryBoundaryBoundary

See also

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, fill_upfill_upfill_upFillUpFillUp, set_colorset_colorset_colorSetColorSetColor

Module

Foundation