fill-rect.md

fill Rect

Set all the pixels within a rectangular area of a bitmap to one color.

bitmaps.create(0,0).fillRect(0,0,0,0,0)

Fill all of pixels in a rectangular area at once with a color. The fill rectangle can be either the entire bitmap or some smaller part of it.

Parameters

• x: a number, the horizontal location of the upper-left corner of the rectangle
• y: a number, the vertical location of the upper-left corner of the rectangle
• w: a number, the width in pixels of the rectangle
• h: a number, the height in pixels of the rectangle
• c: the number of the color to set all the pixels in the rectangle to. Color numbers are value between 0 and 15 which select a color from the current palette of colors.

Examples #example

Center square #ex1

Fill a bitmap with all blue pixels. Fill a small rectangle in the center of the bitmap with yellow pixels.

let blueRect = bitmaps.create(32, 32)
blueRect.fill(3)
blueRect.fillRect(8, 8, 16, 16, 14)
screen().drawBitmap(blueRect, 0, 0)

Chessboard

Make a chessboard by filling in dark squares over top of a white background.

let chessBoard = bitmaps.create(64, 64)
chessBoard.fill(1)
for (let row = 0; row <= 7; row++) {
    for (let col = 0; col <= 3; col++) {
        if (row % 2 == 1) {
            chessBoard.fillRect(col * 16, row * 8, 8, 8, 8)
        } else {
            chessBoard.fillRect(col * 16 + 8, row * 8, 8, 8, 8)
        }
    }
}
screen().drawBitmap(chessBoard, 0, 0)

display-shield=github:microbit-apps/display-shield