Herror ::get_window_pointer3 (
    const HTuple &WindowHandle,
    long *ImageRed,
    long *ImageGreen,
    long *ImageBlue,
    long *Width,
    long *Height
)
HTuple HWindow::GetWindowPointer3 (
    HTuple *ImageGreen,
    HTuple *ImageBlue,
    HTuple *Width,
    HTuple *Height
) const

Access to a window's pixel data.

::get_window_pointer3 enables (in some window systems) the direct access to the bitmap. Result values are the three pointers on the color extracts of a 24-bit window (ImageRed, ImageGreen, ImageBlue), as well as the window size (Width, Height). In the language C the type of the image points is unsigned char.


Attention

::get_window_pointer3 is usable only for window type 'pixmap'.


Parameters

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

ImageRed (output_control)
integer -> long *
Pointer on red channel of pixel data.

ImageGreen (output_control)
integer -> long *
Pointer on green channel of pixel data.

ImageBlue (output_control)
integer -> long *
Pointer on blue channel of pixel data.

Width (output_control)
extent.x -> long *
Length of an image line.

Height (output_control)
extent.y -> long *
Number of image lines.


Result

If a window of type 'pixmap' exists and it is valid ::get_window_pointer3 returns H_MSG_TRUE. If necessary an exception handling is raised.


Possible Predecessors

::open_window, ::open_textwindow


See also

::open_window, ::set_window_type


Module

System



Copyright © 1996-2002 MVTec Software GmbH