Define the region output shape.

::set_shape defines the shape for region output. It is only valid for the window with the logical window number WindowHandle. The output shape is used by ::disp_region. The available shapes can be queried with ::query_shape.

Available modes:

  'original'
               The shape is displayed unchanged. Nevertheless
               modifications via parameters like set_line_width or
               set_line_approx can take place. This is also true for
               all other modes.
  'outer_circle'
               Each region is displayed by the smallest surrounding
               circle. (See smallest_circle.)
  'inner_circle'
               Each region is displayed by the largest included
               circle. (See inner_circle.)
  'ellipse'
               Each region is displayed by an ellipse with the same
               moments and orientation (See elliptic_axis.)
  'rectangle1'
               Each region is displayed by the smallest surrounding
               rectangle parallel to the coordinate axes. (See
               smallest_rectangle1.)
  'rectangle2'
               Each region is displayed by the smallest surrounding
               rectangle. (See smallest_rectangle2.)
  'convex'
               Each region is displayed by its convex hull (See
               convex.)
  'icon'
               Each region is displayed by the icon set with
               'set_icon' in the center of gravity.

Caution is advised for grayvalue output procedures with output parameter settings that use region output, e.g. ::disp_image with ::set_paint(WindowHandle,'histogram') and ::set_shape(WindowHandle,'convex'). In that case the convex hull of the grayvalue histogram is displayed.

read_image(&Image,"fabrik");
regiongrowing(Image,&Seg,5,5,6.0,100);
set_colored(WindowHandle,12);
set_shape(WindowHandle,"rectangle2");
disp_region(Seg,WindowHandle);

::set_shape returns H_MSG_TRUE if the parameter is correct and the window is valid. Otherwise an exception handling is raised.

::set_icon, ::query_shape, ::get_shape

::disp_region

::get_shape, ::query_shape, ::disp_region

System