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.