set_shapeT_set_shapeSetShapeSetShapeset_shape (Operator)

Name

set_shapeT_set_shapeSetShapeSetShapeset_shape — Define the region output shape.

Signature

Description

set_shapeset_shapeSetShapeSetShapeset_shape defines the shape for region output. It is only valid for the window with the logical window number WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle. The output shape is used by disp_regiondisp_regionDispRegionDispRegiondisp_region. The available shapes can be queried with query_shapequery_shapeQueryShapeQueryShapequery_shape.

Available modes:

'original':

The shape is displayed unchanged. Nevertheless modifications via parameters like set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width can take place. This is also true for all other modes.

'outer_circle':

Each region is displayed by the smallest surrounding circle. (See smallest_circlesmallest_circleSmallestCircleSmallestCirclesmallest_circle.)

'inner_circle':

Each region is displayed by the largest included circle. (See inner_circleinner_circleInnerCircleInnerCircleinner_circle.)

'ellipse':

Each region is displayed by an ellipse with the same moments and orientation (See elliptic_axiselliptic_axisEllipticAxisEllipticAxiselliptic_axis.)

'rectangle1':

Each region is displayed by the smallest surrounding rectangle parallel to the coordinate axes. (See smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1.)

'rectangle2':

Each region is displayed by the smallest surrounding rectangle. (See smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2.)

'convex':

Each region is displayed by its convex hull (See convexityconvexityConvexityConvexityconvexity.)

'icon'

Each region is displayed by the icon set with set_iconset_iconSetIconSetIconset_icon in the center of gravity.

Attention

Caution is advised for gray value output operators with output parameter settings that use region output.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (HDevelop)

read_image(Image,'fabrik')
regiongrowing(Image,Seg,5,5,6,100)
set_colored(WindowHandle,12)
set_shape(WindowHandle,'rectangle2')
disp_region(Seg,WindowHandle)

Result

set_shapeset_shapeSetShapeSetShapeset_shape returns 2 ( H_MSG_TRUE) if the parameter is correct and the window is valid. Otherwise an exception is raised.

Possible Predecessors

set_iconset_iconSetIconSetIconset_icon, query_shapequery_shapeQueryShapeQueryShapequery_shape, get_shapeget_shapeGetShapeGetShapeget_shape

Possible Successors

disp_regiondisp_regionDispRegionDispRegiondisp_region

See also

get_shapeget_shapeGetShapeGetShapeget_shape, query_shapequery_shapeQueryShapeQueryShapequery_shape, disp_regiondisp_regionDispRegionDispRegiondisp_region

Module

Foundation