ClearBitmap

Bitmaps
Aptilis 1

ClearBitmap(BitmapHandle, Colour)

ClearBitmap fills an entire bitmap with one single colour.
The colour is indicated by its index which ranges form 0 to 255.
This instruction is really useful because, when initialized, bitmaps may contain random colours. ClearBitmap is much faster and a lot less memory-hungry than Fill applied on the whole bitmap.
ClearBitmap also uses the color you have given it to set the background colour for the bitmap. See setBackground.

Return Value:
0 if everything was OK, or -1 if you specified an incorrect bitmap.

For more details, like the Aptilis colour system see the Bitmap topic.