NAME
    WritePixelArray8 -- write 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 = WritePixelArray8(rp,xstart,ystart,xstop,ystop,array,temprp)
    D0                       A0 D0:16  D1:16  D2:16 D3:16  A2   A1

    LONG WritePixelArray8(struct  RastPort *, UWORD, UWORD,
         UWORD, UWORD, UBYTE *, struct  RastPort *);

FUNCTION
    For each pixel in a rectangular region, decode the pen number selector
    from a linear array of pen numbers into the bit-planes used to describe
    a particular rastport.

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

NOTE
    xstop must be >= xstart
    ystop must be >= ystart

BUGS

SEE ALSO
    WritePixel()  graphics/rastport.h