Herror ::disp_region (
    Hobject DispRegions,
    const HTuple &WindowHandle
)
void HRegion::DispRegion (
    const HTuple &WindowHandle
) const
void HRegionArray::DispRegion (
    const HTuple &WindowHandle
) const

Displays regions in a window.

::disp_region displays the regions in DispRegions in the output window. The parameters for output can be set with the procedures ::set_color, ::set_gray, ::set_draw, ::set_line_width, etc.

The color(s) for the display of the regions are determined with ::set_color, ::set_rgb, ::set_gray or ::set_colored. If more than one region is displayed and more than one color is set, the colors are assigned in a cyclic way to the regions.

The form of the region for output can be modified by ::set_paint (e.g. encompassing circle, convex hull). The command ::set_draw determines if the region is filled or only the boundary is drawn. If only the boundary is drawn, the thickness of the boundary will be determined by ::set_line_width and the style by ::set_line_style.


Parameters

DispRegions (input_object)
region(-array) -> Hobject: HRegion(Array)
Regions to display.

WindowHandle (input_control)
window -> HTuple.long
Window identifier.


Example
/* Output with 12 colors: */
set_colored(WindowHandle,12) ;
disp_region(SomeSegments,WindowHandle) ;

/* Symbolic representation: */
set_draw(WindowHandle,"margin") ;
set_color(WindowHandle,"red") ;
set_shape(WindowHandle,"ellipse") ;
disp_region(SomeSegments,WindowHandle) ;

/* Representation of a margin with pattern: */
set_draw(WindowHandle,"margin") ;
create_tuple(&Color,2) ;
set_s(Color,"blue",0) ;
set_s(Color,"red",0) ;
create_tuple(&Handle,1) ;
set_i(Handle,WindowHandle,0) ;
T_set_color(Handle,Color) ;
create_tuple(&Par,2) ;

set_i(Par,12,0) ;
set_i(Par,3,1) ;
T_set_line_style(WindowHandle,Par) ;
disp_region(Segments,WindowHandle) ;

Result

::disp_region returns H_MSG_TRUE.


Possible Predecessors

::open_window, ::set_rgb, ::set_lut, ::set_hsi, ::set_shape, ::set_line_style, ::set_insert, ::set_fix, ::set_draw, ::set_color, ::set_colored, ::set_line_width


Alternatives

::disp_obj, ::disp_arrow, ::disp_line, ::disp_circle, ::disp_rectangle1, ::disp_rectangle2, ::disp_ellipse


See also

::open_window, ::open_textwindow, ::set_color, ::set_colored, ::set_draw, ::set_shape, ::set_paint, ::set_gray, ::set_rgb, ::set_hsi, ::set_pixel, ::set_line_width, ::set_line_style, ::set_insert, ::set_fix, ::paint_region, ::dump_window


Module

System



Copyright © 1996-2002 MVTec Software GmbH