get_window_pointer3T_get_window_pointer3GetWindowPointer3GetWindowPointer3 (Operator)
Name
get_window_pointer3T_get_window_pointer3GetWindowPointer3GetWindowPointer3
— Access to a window's pixel data.
Warning
This operator does not work in an HDevelop graphics window opened with
dev_open_window
.
Signature
Description
get_window_pointer3get_window_pointer3GetWindowPointer3GetWindowPointer3GetWindowPointer3
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 (ImageRedImageRedImageRedImageRedimageRed
, ImageGreenImageGreenImageGreenImageGreenimageGreen
,
ImageBlueImageBlueImageBlueImageBlueimageBlue
), as well as the window size (WidthWidthWidthWidthwidth
,
HeightHeightHeightHeightheight
).
In the language C the type of the image points is unsigned char.
Attention
get_window_pointer3get_window_pointer3GetWindowPointer3GetWindowPointer3GetWindowPointer3
is usable only for window type
'pixmap'.
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
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle
(input_control) window →
HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
ImageRedImageRedImageRedImageRedimageRed
(output_control) integer →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Pointer on red channel of pixel data.
ImageGreenImageGreenImageGreenImageGreenimageGreen
(output_control) integer →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Pointer on green channel of pixel data.
ImageBlueImageBlueImageBlueImageBlueimageBlue
(output_control) integer →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Pointer on blue channel of pixel data.
WidthWidthWidthWidthwidth
(output_control) extent.x →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Length of an image line.
HeightHeightHeightHeightheight
(output_control) extent.y →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Number of image lines.
Result
If a window of type 'pixmap' exists and it is valid
get_window_pointer3get_window_pointer3GetWindowPointer3GetWindowPointer3GetWindowPointer3
returns 2 (H_MSG_TRUE).
If necessary an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindow
See also
open_windowopen_windowOpenWindowOpenWindowOpenWindow
,
set_window_typeset_window_typeSetWindowTypeSetWindowTypeSetWindowType
Module
Foundation