GETPIXELS

Graphics Subroutine: Gets the color indexes of multiple pixels.

Module: USE DFLIB

Syntax

CALL GETPIXELS (n, x, y, color)

n
(Input) INTEGER(4). Number of pixels to get. Sets the number of elements in the other arguments.

x, y
(Input) INTEGER(2). Parallel arrays containing viewport coordinates of pixels to get.

color
(Output) INTEGER(2). Array to be filled with the color indexes of the pixels at x and y.

GETPIXELS fills in the array color with color indexes of the pixels specified by the two input arrays x and y. These arrays are parallel: the first element in each of the three arrays refers to a single pixel, the second element refers to the next pixel, and so on.

If the pixel is outside the clipping region, the value placed in the color array is undefined. Calls to GETPIXELS with n less than 1 are ignored. GETPIXELS is a much faster way to acquire multiple pixel color indexes than individual calls to GETPIXEL.

The range of possible pixel color index values is determined by the current video mode and palette, at most 256 colors. To access all system colors you need to specify an explicit Red-Green-Blue (RGB) value with an RGB color function such as SETPIXELSRGB and retrieve the value with GETPIXELSRGB, rather than a palette index with a non-RGB color function.

Compatibility

STANDARD GRAPHICS QUICKWIN GRAPHICS LIB

See Also: GETPIXELSRGB, SETPIXELSRGB, GETPIXEL, SETPIXELS