dump_lwindow ( : DumpImage : Modus : )

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).


Attention

The window size has to be conform to the image format!


Parameters

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
/* 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:::).

Result

If one window is activated and if the specified parameters are correct, then dump_lwindow returns TRUE. If necessary an exception is raised.


Possible Predecessors

open_window, set_draw, set_color, set_colored, set_line_width, open_textwindow, set_window


Possible Successors

clear_window, set_window, disp_region


Alternatives

dump_pwindow


See also

open_window, open_textwindow, set_window, set_color, set_grey



Copyright © 1996-1997 MVTec Software GmbH