Output of the window contents to a file.
dump_pwindow writes the content of the current window on a file. You may continue to process this file by convenient printers or other programs. Therefore the content of a display is prepared for each special device (Device), i.e. it is formated in a manner, that you may print this file directly or that it can be processed furthermore by a graphical program.
If the specified window is not already active yet, you may activate it by set_window. To transform grey values the current color table of the window is used, i.e. the values of set_lut_style remain unconsidered.
The grey values of the display possess in general a poorer resolution as the original grey values of the output images. This results in a reduced resolution (default setting are e.g. 200 grey levels with 8 bit planes) for the representation of grey values (see also disp_grey). You may request the amount of actual disposable grey levels by get_system. To modify them before opening the first window you may use set_system.
Possible values for Device 'mitsubishi' Color graphics - thermotransfer - printer of Mitsubishi. Only windows with 8 bit planes and size 512 x 512 are processed. 'postscript' SW - PostScript - file (suitable for printer with 300 dpi). Filetermination: <FileName>.ps ['postscript',Width,Height] SW - PostScript - file with specification of the output size. $Width$ and $Height$ refer to the size of the printing (default: 520,520); therefore the 'pixel_ratio' (set_system) which had been set is considered. Filetermination: <FileName>.ps 'tiff' TIFF - file, 1 sample per pixel, 8 bit per sample, uncompressed. Filetermination: <FileName>.tiff 'tiff_mac' Like 'tiff', additionally Macintosh specific header. 'tiff_rgb' TIFF - file, 1 sample per pixel, 8 bit per sample, incl. current color table, uncompressed. Filetermination: <FileName>.tiff 'tiff_rgb_mac' Like 'tiff_rgb', additionally Macintosh specific header.
You may use dump_pwindow with computers with 8 bit planes only. The window size has to accord with the image format.
Device (input_control) |
string(-array) -> string / integer |
Name of the target device resp. of the graphic format. | |
Default value: 'postscript' | |
List of values: 'mitsubishi', 'postscript', 'tiff', 'tiff_mac', 'tiff_rgb', 'tiff_rgb_mac' |
FileName (input_control) |
filename.named -> string |
File name (without extension). | |
Default value: 'horus_dump' |
/* PostScript - Dump von Bild und eingeblendeten Regionen: */ disp_image(Image:::) > set_colored(::12:) > disp_region(Regions:::) > dump_pwindow(::'postscript','/tmp/horus_dump':) > system_call(::'lp -d ps /tmp/horus_dump.ps':).
If an appropriate window is activated and if the specified parameters are correct, then dump_pwindow returns TRUE. If necessary an exception is raised.
open_window, set_draw, set_color, set_colored, set_line_width, open_textwindow, set_window, disp_region
dump_lwindow, open_window, open_textwindow, set_window, set_system