Unit 'CYBERGRAPHICS' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#amunits]

ReadPixelArray

Read the color values of a rectangular array

Declaration

Source position: cybergraphics.pas line 235

function ReadPixelArray(

  destRect: POINTER;

  destX: Word;

  destY: Word;

  destMod: Word;

  a1arg: pRastPort;

  SrcX: Word;

  SrcY: Word;

  SizeX: Word;

  SizeY: Word;

  DestFormat: Byte

):LongWord;

Arguments

destRect

  

Pointer to an array of pixels where to write the pixel data to. The pixel format is specified in DestFormat

destX

  

X starting point in the destination rectangle

destY

  

Y starting point in the destination rectangle

destMod

  

The number of bytes per row in the destination rectangle.

a1arg

  

Pointer to a RastPort structure

SrcX

  

X starting point in the RastPort

SrcY

  

Y starting point in the RastPort

SizeX

  

Width of the rectangle that should be transfered

SizeY

  

Height of the rectangle that should be transfered

DestFormat

  

pixel format in the destination rectangle Currently supported formats are: RECTFMT_RGB, RECTFMT_RGBA, RECTFMT_ARGB

Function result

number of pixels read

Description

Read the color values of a rectangular array of pixels starting at a specified x,y location and continuing through to another x,y location within a certain RastPort

For each pixel in a rectangular region, write the color value to a linear array of color values from the bitmap used to describe a particular rastport.

Attention

This function should only be used on screens depths > 8 bits.

Errors

The count value returned is totally wrong.

See also

WritePixelArray

  

write the color value of a rectangular array

ReadPixelArray8

  

read the pen number value of a rectangular array of pixels starting at a specified x,y location and continuing through to another x,y location within a certain RastPort.


Documentation generated on: 2021-07-30