dump_window_imageT_dump_window_imageDumpWindowImageDumpWindowImagedump_window_image (Operator)

Name

dump_window_imageT_dump_window_imageDumpWindowImageDumpWindowImagedump_window_image — Write the window content in an image object.

Signature

dump_window_image( : Image : WindowHandle : )

Description

dump_window_imagedump_window_imageDumpWindowImageDumpWindowImagedump_window_image writes the content of the graphics window (WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle) in an image (ImageImageImageimageimage). To transform gray values the current color table of the window is used.

Attention

Under Unix-like systems, the graphics window must be completely visible on the root window, because otherwise the contents of the window cannot be read due to limitations in X Windows.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

ImageImageImageimageimage (output_object) image → object (byte)

Saved image.

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Window handle.

Result

If the window is valid dump_window_imagedump_window_imageDumpWindowImageDumpWindowImagedump_window_image returns 2 ( H_MSG_TRUE) . If necessary an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowopen_window, set_drawset_drawSetDrawSetDrawset_draw, set_colorset_colorSetColorSetColorset_color, set_coloredset_coloredSetColoredSetColoredset_colored, set_line_widthset_line_widthSetLineWidthSetLineWidthset_line_width, disp_regiondisp_regionDispRegionDispRegiondisp_region

Module

Foundation

Operators