NAME
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. (V36)
SYNOPSIS
count = ReadPixelArray8(rp,xstart,ystart,xstop,ystop,array,temprp)
D0 A0 D0:16 D1:16 D2:16 D3:16 A2 A1
LONG ReadPixelArray8(struct RastPort *, UWORD, UWORD, UWORD, UWORD,
UBYTE *, struct RastPort *);FUNCTION
For each pixel in a rectangular region, combine the bits from each of the bit-planes used to describe a particular RastPort into the pen number selector which that bit combination normally forms for the system hardware selection of pixel color.
INPUTS
rp - pointer to a RastPort structure (xstart,ystart) - starting point in the RastPort (xstop,ystop) - stopping point in the RastPort array - pointer to an array of ubytes from which to fetch the pixel data allocate at least ((((width+15)>>4)<<4)*(ystop-ystart+1)) bytes. temprp - temporary rastport (copy of rp with Layer set == NULL, temporary memory allocated for temprp->BitMap with Rows set == 1, temprp->BytesPerRow == (((width+15)>>4)<<1), and temporary memory allocated for temprp->BitMap->Planes[])
RESULT For each pixel in the array: Pen - (0..255) number at that position is returned count - the number of pixels read.
NOTE xstop must be >= xstart ystop must be >= ystart
BUGS
SEE ALSO