Converting of the window contents in an image.
dump_lwindow creates out of the content of the current window one or more images. The parameters of set_lut_style will not be considered. If the desired window is not already active yet, you have to activate it by set_window before calling dump_lwindow.
At the moment the parameter Modus accepts following values:
'pixel' An image with a maximal region (=image format) is created. If there is a color image in the current output window, then the grey values result from conversion of the display's colors (according to the intensity). 'red_pixel' Only the red intensities of pixels are adopted. The region is maximal. 'green_pixel' Only the green intensities of pixels are adopted. The region is maximal. 'blue_pixel' Only the blue intensities of pixels are adopted. The region is maximal. 'image' Logical dump of grey value parts: All points in the current window are considered, which either had been displayed by disp_image or had been created by graphical procedures like e.g. disp_circle. Furthermore the color of these points had to be set by set_grey. The region of the created image contains exactly these points. WARNING: The grey value resolution of the display is reduced during image output dependend on the hardware. Thus "gaps" appear in the histogram of the created image. 'region' Logical dump of the window content, which contains graphics. It affects these entries, which color has been set by procedures like set_color, set_rgb or set_hsi. The result is divided in parts of regions according to the displayed colors (see example 2).
The window size has to be conform to the image format!
DumpImage (output_object) |
image -> object |
Image to create. |
Modus (input_control) |
string -> string |
Mode for dump. | |
Default value: 'image' | |
List of values: 'pixel', 'red_pixel', 'green_pixel', 'blue_pixel', 'image', 'region' |
/* Example 1: Dump of grey values: */ disp_image(Image:::) > dump_lwindow(:Dump:'image':) > disp_image(Dump:::) > set_paint(::'histogram':) > disp_image(Dump:::). /* Example 2: Dump of a regions: */ threshold__(Image:Reg:1,128:) > connection(Reg:Regions::) > set_colored(::12:) > disp_region(Regions:::) > dump_lwindow(:Dump:'region':) > clear_window(:::) > disp_region(Dump:::).
If one window is activated and if the specified parameters are correct, then dump_lwindow returns TRUE. If necessary an exception is raised.
open_window, set_draw, set_color, set_colored, set_line_width, open_textwindow, set_window
clear_window, set_window, disp_region
open_window, open_textwindow, set_window, set_color, set_grey