Operator Reference
get_pixel (Operator)
get_pixel
— Get the current color lookup table index.
Warning
get_pixel
is obsolete and is only provided for
reasons of backward compatibility.
Signature
get_pixel( : : WindowHandle : Pixel)
Description
get_pixel
returns the internal coding of the output
gray value or color, respectively, for the window. If the output mode is
set to color(s) or gray value(s) (see set_color
or
set_gray
), then the color- or gray values are transformed
for internal use. The internal code is then used for (physical)
screen display. The transformation depends on the mapping
characteristics and the condition of the output device and can be
different in different program runs. Don't confuse the term “pixel”
with the term “pixel” in image processing (the other operator
is get_grayval
). Here a pixel is meant to be the
color lookup table index.
With get_pixel
it is possible to save the output mode
without knowing whether colors or gray values are
used. Pixel
is set with the operator
set_pixel
.
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
WindowHandle
(input_control) window →
(handle)
Window handle.
Pixel
(output_control) integer-array →
(integer)
Index of the current color look-up table.
Result
get_part_style
returns 2 (
H_MSG_TRUE)
if the window is valid.
Otherwise an exception is raised.
Possible Successors
set_pixel
,
disp_region
,
disp_image
See also
Module
Foundation